How altioobv/altioo-oauth-server works
Altioo OAuth Server adds OAuth 2.1 authorization to iTop: a client discovers or is configured with the server, registers when permitted, sends a person through iTop login and consent, then exchanges the authorization code for tokens backed by an iTop personal token. Refresh and revocation maintain the connection, which the person can inspect or end in iTop. Major areas include discovery, REST/MCP resources, registration, authorization, token/grant lifecycle, and account interfaces. Some controller and service internals are unsampled; uncertain links are omitted.
Main entry points: AuthorizationController.php Authorization consent · Router.php Route dispatcher · TokenController.php Token endpoint · RegistrationController.php Client registration
Components 23
HTTP entry
- Module entry
index.php - Route dispatcher
src/Controller/Router.php - HTTP responses
src/Http.php
OAuth protocol
- Discovery metadata
src/Controller/MetadataController.php - Client registration
src/Controller/RegistrationController.php - Authorization consent
src/Controller/AuthorizationController.php - Token endpoint
src/Controller/TokenController.php
Connection lifecycle
- Registration records
src/Service/Registrations.php - Account access checks
src/Service/Accounts.php - Grant lifecycle
src/Service/Grants.php - iTop personal tokens
src/Service/PersonalTokens.php - Grant cleanup
src/Service/CleanUpProcess.php
Account interfaces
- My Account connections
src/Hook/MyAccountConnections.php - Portal connections
src/Hook/PortalConnections.php - Connection actions
src/Controller/ConnectionsController.php
Resource policy
- Server configuration
src/Config.php - Resource and scope policy
src/ProtectedResource.php - Scope rules
src/ScopePolicy.php - Redirect URI policy
src/RedirectUriPolicy.php
Other components
- OAuth client
- iTop user
- altioo-mcp resource
- iTop REST API
Connections 40
- OAuth client → Module entry: calls endpoints
README.md - Module entry → Route dispatcher: dispatches to
index.php - Route dispatcher → Discovery metadata: routes discovery
src/Controller/Router.php - Route dispatcher → Client registration: routes registration
src/Controller/Router.php - Route dispatcher → Authorization consent: routes authorization
src/Controller/Router.php - Route dispatcher → Token endpoint: routes tokens
src/Controller/Router.php - Route dispatcher → Connection actions: routes disconnect
src/Controller/Router.php - Route dispatcher → HTTP responses: formats errors
src/Controller/Router.php - Discovery metadata → Server configuration: reads settings
src/Controller/MetadataController.php - Discovery metadata → Resource and scope policy: describes resource
src/Controller/MetadataController.php - Client registration → Redirect URI policy: checks callbacks
src/Controller/RegistrationController.php - Client registration → Registration records: limits registrations
src/Controller/RegistrationController.php - Client registration → Server configuration: reads settings
src/Controller/RegistrationController.php - Client registration → HTTP responses: returns client details
src/Controller/RegistrationController.php - Authorization consent → iTop user: authenticates person
src/Controller/AuthorizationController.php - Authorization consent → Redirect URI policy: checks callback
src/Controller/AuthorizationController.php - Authorization consent → Resource and scope policy: selects resource
src/Controller/AuthorizationController.php - Authorization consent → Account access checks: checks account
src/Controller/AuthorizationController.php - Authorization consent → Server configuration: reads settings
src/Controller/AuthorizationController.php - Authorization consent → OAuth client: redirects with code
README.md - Token endpoint → Authorization consent: validates client
src/Controller/TokenController.php - Token endpoint → Account access checks: checks account
src/Controller/TokenController.php - Token endpoint → Grant lifecycle: ends reused grant
src/Controller/TokenController.php - Token endpoint → iTop personal tokens: issues and rotates
src/Controller/TokenController.php - Token endpoint → Server configuration: reads settings
src/Controller/TokenController.php - Token endpoint → HTTP responses: returns token response
src/Controller/TokenController.php - Server configuration → Scope rules: configures scopes
src/Config.php - Grant lifecycle → iTop personal tokens: deletes owned token
src/Service/Grants.php - Grant cleanup → Grant lifecycle: ends expired grants
src/Service/CleanUpProcess.php - Grant cleanup → iTop personal tokens: cleans tokens
src/Service/CleanUpProcess.php - My Account connections → Grant lifecycle: lists active grants
src/Hook/MyAccountConnections.php - My Account connections → Authorization consent: describes scopes
src/Hook/MyAccountConnections.php - Portal connections → My Account connections: reuses connection view
src/Hook/PortalConnections.php - Connection actions → Grant lifecycle: withdraws grant
src/Controller/ConnectionsController.php - iTop user → My Account connections: views connections
README.md - iTop user → Connection actions: ends connection
README.md - altioo-mcp resource → iTop personal tokens: accepts issued tokens
README.md - iTop REST API → iTop personal tokens: accepts issued tokens
README.md - OAuth client → altioo-mcp resource: requests access
README.md - OAuth client → iTop REST API: requests access
README.md