p9d/oauth2-toolkit

v0.1.0 2025-01-16 17:49 UTC

Requires

• php: ^8.3
• symfony/http-client: ^7.1
• webmozart/assert: ^1.11

Requires (Dev)

• phpstan/phpstan: ^1.11
• phpstan/phpstan-webmozart-assert: ^1.2

MIT

README

Tools to deal with OAuth2/OpenID protocols.

If your identity providers are providing an well-known OpenID Configuration endpoint, you can use them to discover all required things to integrate with them:

$providers = [
    'your-provider-name-here' => [
        'configuration_endpoint' => 'https://<url>/realms/ACME/.well-known/openid-configuration',
        'client_id' => 'XXXXXXXXXXXXX'
    ],
    'google' => [
        'configuration_endpoint' => 'https://accounts.google.com/.well-known/openid-configuration'
    ]   
];

$factory = new \P9D\OAuth2Toolkit\OpenIdConfigurationFactory(
    $providers,
    \Symfony\Component\HttpClient\HttpClient::create()
);


# Access provider config via:
$provider = $factory->createForProvider('your-provider-name-here');

Provider configuration:

• configuration_endpoint - URL to OpenID Discovery Endpoint
• ?client_id Client ID used for this provider

Methods available in OpenIdConfigurationService

getAuthorizationUrl(): string

Returns a link user should be redirected to login.

parameters:

• grantType,
• redirectUri
• ?clientId - when not passed, value passed in client_id from configuration will be used.
• ?scope
• ?state

getJwks(): array

Returns an array of JSON Web Key Set.