https://github.com/blitz-php/vollmacht
Serveur OAuth2 officiel de BlitzPHP
https://github.com/blitz-php/vollmacht
Last synced: 4 days ago
JSON representation
Serveur OAuth2 officiel de BlitzPHP
- Host: GitHub
- URL: https://github.com/blitz-php/vollmacht
- Owner: blitz-php
- License: mit
- Created: 2026-04-14T16:31:42.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-20T17:44:10.000Z (about 2 months ago)
- Last Synced: 2026-04-20T19:36:23.797Z (about 2 months ago)
- Language: PHP
- Size: 94.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BlitzPHP Vollmacht
[](https://php.net)
[](https://github.com/blitz-php/vollmacht/releases)
[](LICENSE)
**Vollmacht** est le serveur OAuth2 officiel pour l'écosystème [BlitzPHP](https://github.com/blitz-php/framework).
> *Vollmacht* signifie **"Procuration"** ou **"Mandat"** en allemand. Fidèle à son nom, cette bibliothèque permet à vos utilisateurs de délivrer une procuration sécurisée à des applications tierces pour accéder à leurs ressources, sans jamais exposer leurs identifiants.
## Fonctionnalités
- **Serveur OAuth2 complet** : Implémente les standards `authorization_code`, `client_credentials`, `password`, `refresh_token` et `implicit`.
- **Intégration native avec [Schild](https://github.com/blitz-php/schild)** : Utilise les utilisateurs, groupes et permissions de Schild. Aucune duplication.
- **Cli API First** : Générez des clients OAuth via l'interface en ligne de commande `klinge`.
- **Scopes Dynamiques** : Définissez et vérifiez des scopes pour granulariser les accès.
- **Middleware Prêt à l'emploi** : Protégez vos routes API avec `vollmacht:auth`.
- **JWT ou Base de données** : Choisissez entre des tokens opaques (stockés en DB) ou des JWT signés.
## Installation
Via Composer :
```bash
composer require blitz-php/vollmacht
```
Puis, publiez la configuration et les migrations :
```bash
php klinge vollmacht:publish
php klinge migrate
```
Générez les clés de chiffrement nécessaires au serveur OAuth :
```bash
php klinge vollmacht:keys
```
## Démarrage Rapide
### 1. Ajoutez le Trait à votre Modèle Utilisateur
Pour que vos utilisateurs puissent créer des tokens personnels, ajoutez le trait `HasApiTokens` à votre `User` entity :
```php
group('/api', ['middleware' => 'vollmacht:auth'], function($router) {
$router->get('user', 'Api\UserController::profile');
});
```
### 3. Créez un Client OAuth
```bash
php klinge vollmacht:client --name="Mon Application Mobile" --redirect_uri="myapp://callback"
```
## Tests
```bash
composer test
```
## Contribution
Les contributions sont les bienvenues ! Veuillez consulter le [Guide de Contribution](CONTRIBUTING.md) et vous assurer que vos modifications passent les tests et l'analyse statique.
```bash
composer ci
```
## Licence
Ce projet est sous licence MIT. Voir le fichier [LICENSE](LICENSE) pour plus de détails.
## Crédits
- **Auteur** : Dimitri Sitchet Tomkeu
- **Inspiration** : [Laravel Passport](https://github.com/laravel/passport) & [league/oauth2-server](https://github.com/thephpleague/oauth2-server)
---
*"Donner procuration, c'est faire confiance. Vollmacht rend cette confiance sécurisée."*
```