3 namespace BookStack\Auth\Access\Oidc;
5 use League\OAuth2\Client\Grant\AbstractGrant;
6 use League\OAuth2\Client\Provider\AbstractProvider;
7 use League\OAuth2\Client\Provider\Exception\IdentityProviderException;
8 use League\OAuth2\Client\Provider\GenericResourceOwner;
9 use League\OAuth2\Client\Provider\ResourceOwnerInterface;
10 use League\OAuth2\Client\Token\AccessToken;
11 use League\OAuth2\Client\Tool\BearerAuthorizationTrait;
12 use Psr\Http\Message\ResponseInterface;
15 * Extended OAuth2Provider for using with OIDC.
16 * Credit to the https://github.com/steverhoades/oauth2-openid-connect-client
17 * project for the idea of extending a League\OAuth2 client for this use-case.
19 class OidcOAuthProvider extends AbstractProvider
21 use BearerAuthorizationTrait;
26 protected $authorizationEndpoint;
31 protected $tokenEndpoint;
34 * Returns the base URL for authorizing a client.
36 public function getBaseAuthorizationUrl(): string
38 return $this->authorizationEndpoint;
42 * Returns the base URL for requesting an access token.
44 public function getBaseAccessTokenUrl(array $params): string
46 return $this->tokenEndpoint;
50 * Returns the URL for requesting the resource owner's details.
52 public function getResourceOwnerDetailsUrl(AccessToken $token): string
58 * Returns the default scopes used by this provider.
60 * This should only be the scopes that are required to request the details
61 * of the resource owner, rather than all the available scopes.
63 protected function getDefaultScopes(): array
65 return ['openid', 'profile', 'email'];
69 * Returns the string that should be used to separate scopes when building
70 * the URL for requesting an access token.
72 protected function getScopeSeparator(): string
78 * Checks a provider response for errors.
80 * @param ResponseInterface $response
81 * @param array|string $data Parsed response data
83 * @throws IdentityProviderException
87 protected function checkResponse(ResponseInterface $response, $data)
89 if ($response->getStatusCode() >= 400 || isset($data['error'])) {
90 throw new IdentityProviderException(
91 $data['error'] ?? $response->getReasonPhrase(),
92 $response->getStatusCode(),
93 (string) $response->getBody()
99 * Generates a resource owner object from a successful resource owner
102 * @param array $response
103 * @param AccessToken $token
105 * @return ResourceOwnerInterface
107 protected function createResourceOwner(array $response, AccessToken $token)
109 return new GenericResourceOwner($response, '');
113 * Creates an access token from a response.
115 * The grant that was used to fetch the response can be used to provide
116 * additional context.
118 * @param array $response
119 * @param AbstractGrant $grant
121 * @return OidcAccessToken
123 protected function createAccessToken(array $response, AbstractGrant $grant)
125 return new OidcAccessToken($response);