API Services AuthenticationServiceInterface - evansims/openfga-php GitHub Wiki
Service interface for managing authentication in OpenFGA operations. This service abstracts authentication concerns from the Client class, handling the complexities of token management, authentication flows, and authorization header generation. It provides a clean interface for different authentication strategies while encapsulating the details of token refresh and error handling. ## Core Functionality The service manages the complete authentication lifecycle: - Authorization header generation with automatic token refresh - Authentication request handling with proper error management - Support for multiple authentication strategies (OAuth2, pre-shared keys) - Integration with telemetry for authentication monitoring ## Usage Example php $authService = new AuthenticationService($authentication, $telemetryService); Get authorization header (with automatic refresh if needed) $authHeader = $authService->getAuthorizationHeader($streamFactory); Handle authentication requests $response = $authService->sendAuthenticationRequest($context, $requestManager);
Table of Contents
OpenFGA\Services
- AuthenticationService (implementation)
public function getAuthorizationHeader(
StreamFactoryInterface $streamFactory,
?callable $requestSender = NULL,
): string|nullGet the authorization header for API requests. Retrieves the current authorization header, automatically handling token refresh if the current token is expired or missing. This method encapsulates the complexity of different authentication flows and provides a simple interface for obtaining valid authorization credentials.
| Name | Type | Description |
|---|---|---|
$streamFactory |
StreamFactoryInterface |
Stream factory for building authentication requests |
$requestSender |
callable | null
|
string | null — The authorization header value, or null if no authentication configured
public function sendAuthenticationRequest(RequestContext $context, callable $requestSender): HttpResponseInterfaceSend an authentication request using a pre-built RequestContext. Handles the complete lifecycle of authentication requests, including request building, sending, response handling, and telemetry tracking. This method provides a centralized point for all authentication-related HTTP operations.
| Name | Type | Description |
|---|---|---|
$context |
RequestContext |
The authentication request context |
$requestSender |
callable |
HttpResponseInterface — The authentication response