CLASS
OAuthTokenManager
Contents
- Properties
oauthTokenConfiguration
- Methods
init(oauthTokenConfiguration:)fetchAccessToken(with:dpop:additionalParameters:)refreshAccessToken(with:additionalParameters:)revokeAccessToken(with:)revokeRefreshToken(with:)
@objcMembers public final class OAuthTokenManager: NSObject, Sendable
OAuthTokenManager instances are used to fetch or refresh an access token.
Properties
oauthTokenConfiguration
public let oauthTokenConfiguration: OAuthTokenConfigurable
The configuration used to build this instance.
Methods
init(oauthTokenConfiguration:)
@objc public convenience init(oauthTokenConfiguration: OAuthTokenConfigurable)
Creates an OAuthTokenManager instance.
- Parameters:
- oauthTokenConfiguration: The configuration used to build this instance.
Parameters
| Name | Description |
|---|---|
| oauthTokenConfiguration | The configuration used to build this instance. |
fetchAccessToken(with:dpop:additionalParameters:)
public func fetchAccessToken(
with authorizationCode: String,
dpop: Dpop? = nil,
additionalParameters: [String: String]? = nil
) async -> TokenResponse
Fetches an access token using an authorization code grant.
If it succeeds then a SuccessfulTokenResponse with the access token is returned.
If it fails either a ErrorTokenResponse with the error reason is returned or the result has an Error.
- Parameters:
- authorizationCode: The authorization code.
- dpop: The Dpop that was used during the Haapi flow. When it is required, this value has to be used via HaapiManager.dpop.
- additionalParameters: The additional parameters for the request body. The default value is nil.
- Returns: A TokenResponse.
Parameters
| Name | Description |
|---|---|
| authorizationCode | The authorization code. |
| dpop | The Dpop that was used during the Haapi flow. When it is required, this value has to be used via HaapiManager.dpop. |
| additionalParameters | The additional parameters for the request body. The default value is nil. |
refreshAccessToken(with:additionalParameters:)
public func refreshAccessToken(
with refreshToken: String,
additionalParameters: [String: String]? = nil
) async -> TokenResponse
Refresh an access token by providing a refresh token.
If it succeeds then a SuccessfulTokenResponse with the access token is returned.
If it fails either an ErrorTokenResponse with the error reason is returned or the result has an Error.
- Parameters:
- refreshToken: The refresh token.
- additionalParameters: The additional parameters for the request body. The default value is nil.
- Returns: A TokenResponse.
Parameters
| Name | Description |
|---|---|
| refreshToken | The refresh token. |
| additionalParameters | The additional parameters for the request body. The default value is nil. |
revokeAccessToken(with:)
public func revokeAccessToken(with token: String) async -> TokenRevocationResponse
Revokes an access token.
If it succeeds then a successfulRevocation is returned.
If it fails an error response is returned containing an Error.
- Parameters:
- token: The token to be revoked.
- Returns: A TokenRevocationResponse.
Parameters
| Name | Description |
|---|---|
| token | The token to be revoked. |
revokeRefreshToken(with:)
public func revokeRefreshToken(with token: String) async -> TokenRevocationResponse
Revokes a refresh token.
If it succeeds then a success is returned.
If it fails an error response is returned containing an Error.
- Parameters:
- token: The token to be revoked.
- Returns: A TokenRevocationResponse.
Parameters
| Name | Description |
|---|---|
| token | The token to be revoked. |