EXTENSION
HaapiTokenManager
public extension HaapiTokenManager
Methods
createClient(urlSession:)
func createClient(urlSession: URLSession? = nil) -> HaapiClient
Create a HaapiClient
instance that uses the HaapiTokenManager
's state (e.g. the HAAPI token and ...) for building outbound requests.
- Parameter urlSession: The actual URLSession instance that the created client will use to make HTTP requests.
When not provided, an
URLSession
instance configured in HaapiManagerToken is used. - Note: When building HaapiTokenManger and no
URLSession
was injected , then the default URLSession is anephemeral URLSession
Parameters
Name | Description |
---|---|
urlSession | The actual URLSession instance that the created client will use to make HTTP requests. When not provided, an URLSession instance configured in HaapiManagerToken is used. |
createClient()
func createClient() -> HaapiClient
Create a HaapiClient
instance that uses the HaapiTokenManager
's state (e.g. the HAAPI token and ...) for building outbound requests.
- Note: When creating the
HaapiClient
it will use the URLSession provided by the internal HaapiTokenManager. This allows for internal management of the DPop nonces and Client Authentication Method.
getHaapiToken(forceFresh:dpopNonce:completionHandler:)
Obtains a HAAPI token. Takes a completionHandler that is executed after the HAAPI token is obtained or an error occurred.
- Parameter forceFresh: The boolean to indicate whether a new HAAPI token should be obtained even when the internal state already has a valid HAAPI token it can use. The default value is
false
. - Parameter dpopNonce:The most recent DPoP nonce. Any Identity Server responses may contain a DPoP-Nonce header with a nonce string. This nonce needs be provided to all subsequent calls to this method.
- Parameter completionHandler:The handler that is called on the main thread after a HAAPI token was successfully obtained or an HaapiError occured.
getHaapiToken(forceFresh:completionHandler:)
Obtains a HAAPI token. Takes a completionHandler that is executed after the HAAPI token is obtained or an error occurred.
- Parameter forceFresh: The boolean to indicate whether a new HAAPI token should be obtained even when the internal state already has a valid HAAPI token it can use. The default value is
false
. - Parameter completionHandler:The handler that is called on the main thread after a HAAPI token was successfully obtained or an HaapiError occured.
getHaapiToken(forceFresh:dpopNonce:completionHandler:)
func getHaapiToken(forceFresh: Bool = false,
dpopNonce: String? = nil,
completionHandler: @escaping (Result<DpopAccessTokenInfo, HaapiError>) -> Void)
Obtain a HAAPI token. Takes a completionHandler that is executed after the HAAPI token is obtained or an error occurred.
- Parameter forceFresh: The boolean to indicate whether a new HAAPI token should be obtained even when the internal state already has a valid HAAPI token it can use. The default value is
false
. - Parameter dpopNonce:The most recent DPoP nonce. Any Identity Server responses may contain a DPoP-Nonce header with a nonce string. This nonce needs be provided to all subsequent calls to this method.
- Parameter completionHandler:The handler that is called on the main thread after a HAAPI token was successfully obtained or an HaapiError occured.
Parameters
Name | Description |
---|---|
forceFresh | The boolean to indicate whether a new HAAPI token should be obtained even when the internal state already has a valid HAAPI token it can use. The default value is false . |
dpopNonce | The most recent DPoP nonce. Any Identity Server responses may contain a DPoP-Nonce header with a nonce string. This nonce needs be provided to all subsequent calls to this method. |
completionHandler | The handler that is called on the main thread after a HAAPI token was successfully obtained or an HaapiError occured. |
close()
func close()
Closes this HAAPI Token Manager and frees the name of this manager to be used by another instance. It is an error to use this manager after calling close(), and will cause undefined behavior.
clearState()
func clearState()
Clears all state of this manager pertaining to DeviceCheck attestation and access tokens.
getHaapiTokenAsync(forceFresh:callbackDispatchQueue:dpopNonce:completionHandler:)
- Important: Deprecated. Please use getHaapiToken(forceFresh:dpopNonce:completionHandler:)
getHaapiTokenAsync(forceFresh:callbackDispatchQueue:completionHandler:)
- Important: Deprecated. Please use getHaapiToken(forceFresh:dpopNonce:completionHandler:)
getHaapiTokenAsync(forceFresh:callbackDispatchQueue:dpopNonce:completionHandler:)
- Important: Deprecated. Please use getHaapiTokenWithForceFresh:dpopNonce:completionHandler:
getHaapiToken(forceFresh:)
- Important: Deprecated. Please use getHaapiTokenWithForceFresh:dpopNonce:completionHandler:
getHaapiToken(forceFresh:dpopNonce:)
- Important: Deprecated. Please use getHaapiTokenWithForceFresh:dpopNonce:completionHandler: