How uzairports/uzair-id works
UzAir ID is a Laravel OAuth 2.0 integration for Uzbekistan Airports SSO. The main flow registers package routes, sends users through the SSO authorization and callback, resolves or creates the local account, and persists its login tokens. Authenticated requests can then check and refresh the login; logout and session-management paths end logins, while commands support provider transitions and pruning. The graph includes documented capabilities, but some wiring is inferred only from README or source-index references; those references do not establish every runtime detail.
Main entry points: OauthToken.php OAuth token model · UzairAuthController.php Auth controller · UzairServiceProvider.php Laravel service provider · EnsureAccessTokenIsFresh.php Token middleware
Components 19
Sign-in and identity
- Route registration
src/Uzair.php - Auth controller
src/Http/Controllers/UzairAuthController.php - Socialite driver
src/Socialite/UzairportsProvider.php - User resolver
src/Actions/ResolveUserFromSocialite.php - Token user trait
src/Concerns/HasUzairToken.php - Domain events
src/Events
Sessions and tokens
- OAuth token model
src/Models/OauthToken.php - Token middleware
src/Http/Middleware/EnsureAccessTokenIsFresh.php - Token refresh
src/Actions/RefreshAccessToken.php - Provider storage check
src/Actions/EnsureTokenStorageMatchesProvider.php - End sessions
src/Actions/EndSessions.php
Laravel integration
- UzAir API
src/Uzair.php - Laravel service provider
src/Providers/UzairServiceProvider.php - Package configuration
config/uzairports.php - Token and user schema
database/migrations
Operations
- Provider transition command
src/Console/Commands/ProviderCommand.php - Token pruning command
src/Console/Commands/PruneCommand.php
Other components
- Application user
- UzAirports SSO
Connections 31
- Application user → Route registration: starts sign-in
README.md - Route registration → Auth controller: registers routes
src/Uzair.php - Auth controller → Socialite driver: uses driver
src/Http/Controllers/UzairAuthController.php - Socialite driver → UzAirports SSO: exchanges OAuth
src/Socialite/UzairportsProvider.php - Auth controller → User resolver: resolves account
src/Http/Controllers/UzairAuthController.php - User resolver → OAuth token model: records login
- Auth controller → OAuth token model: records session
src/Http/Controllers/UzairAuthController.php - Auth controller → Domain events: dispatches events
src/Http/Controllers/UzairAuthController.php - Application user → Token middleware: uses protected routes
README.md - Token middleware → Provider storage check: checks ownership
src/Http/Middleware/EnsureAccessTokenIsFresh.php - Token middleware → OAuth token model: looks up login
src/Http/Middleware/EnsureAccessTokenIsFresh.php - Token middleware → Token refresh: renews token
src/Http/Middleware/EnsureAccessTokenIsFresh.php - Token refresh → OAuth token model: updates login
src/Actions/RefreshAccessToken.php - Token refresh → Socialite driver: requests renewal
src/Actions/RefreshAccessToken.php - Token refresh → Domain events: dispatches outcomes
src/Actions/RefreshAccessToken.php - Auth controller → End sessions: ends logins
src/Http/Controllers/UzairAuthController.php - End sessions → OAuth token model: deletes logins
src/Actions/EndSessions.php - End sessions → Socialite driver: revokes grants
src/Actions/EndSessions.php - Token user trait → Provider storage check: checks provider
src/Concerns/HasUzairToken.php - Token user trait → OAuth token model: reads token
src/Concerns/HasUzairToken.php - Laravel service provider → Socialite driver: registers driver
src/Providers/UzairServiceProvider.php - Laravel service provider → Token middleware: registers middleware
src/Providers/UzairServiceProvider.php - Laravel service provider → Provider transition command: registers command
src/Providers/UzairServiceProvider.php - Laravel service provider → Token pruning command: registers command
src/Providers/UzairServiceProvider.php - Laravel service provider → Package configuration: loads configuration
src/Providers/UzairServiceProvider.php - Provider transition command → End sessions: ends logins
src/Console/Commands/ProviderCommand.php - Provider transition command → Provider storage check: checks ownership
src/Console/Commands/ProviderCommand.php - Provider transition command → OAuth token model: rebuilds table
src/Console/Commands/ProviderCommand.php - Token pruning command → OAuth token model: prunes rows
src/Console/Commands/PruneCommand.php - Token and user schema → OAuth token model: defines schema
- Route registration → UzAir API: provides route API
README.md