Play Integrity API
Native Play Integrity API.
Summary
Typedefs |
|
---|---|
IntegrityTokenRequest
|
typedefstruct IntegrityTokenRequest_
An opaque struct used to provide information about an integrity token request. |
IntegrityTokenResponse
|
typedefstruct IntegrityTokenResponse_
An opaque struct used to access information about an integrity token response. |
PrepareIntegrityTokenRequest
|
typedefstruct PrepareIntegrityTokenRequest_
An opaque struct used to represent a prepare integrity token request. |
StandardIntegrityToken
|
typedefstruct StandardIntegrityToken_
An opaque struct used to represent a standard integrity token response. |
StandardIntegrityTokenProvider
|
typedefstruct StandardIntegrityTokenProvider_
An opaque struct used to represent a standard integrity token provider. |
StandardIntegrityTokenRequest
|
typedefstruct StandardIntegrityTokenRequest_
An opaque struct used to represent a standard integrity token request. |
Functions |
|
---|---|
IntegrityManager_destroy()
|
void
Frees up memory allocated for the Integrity API.
|
IntegrityManager_init(JavaVM *jvm, jobject android_context)
|
Initialize the Play Integrity API, making the other functions available to call.
|
IntegrityManager_requestIntegrityToken(IntegrityTokenRequest *request, IntegrityTokenResponse **out_response)
|
Starts an asynchronous operation to obtain a Play Integrity API token.
|
IntegrityTokenRequest_create(IntegrityTokenRequest **out_request)
|
Creates a new IntegrityTokenRequest opaque struct.
|
IntegrityTokenRequest_destroy(IntegrityTokenRequest *request)
|
void
Releases the specified IntegrityTokenRequest and any references it holds.
|
IntegrityTokenRequest_setCloudProjectNumber(IntegrityTokenRequest *request, int64_t cloudProjectNumber)
|
Sets the cloud project number to link to the integrity token.
|
IntegrityTokenRequest_setNonce(IntegrityTokenRequest *request, const char *nonce)
|
Sets the nonce in an IntegrityTokenRequest with a given string.
|
IntegrityTokenResponse_destroy(IntegrityTokenResponse *response)
|
void
Releases the specified IntegrityTokenResponse and any references it holds.
|
IntegrityTokenResponse_getStatus(IntegrityTokenResponse *response, IntegrityResponseStatus *out_status)
|
Gets the status of an ongoing IntegrityManager_requestIntegrityToken() asynchronous operation.
|
IntegrityTokenResponse_getToken(IntegrityTokenResponse *response)
|
const char *
Gets the token retrieved by a successful IntegrityManager_requestIntegrityToken() asynchronous operation, returns null pointer otherwise.
|
PrepareIntegrityTokenRequest_create(PrepareIntegrityTokenRequest **out_request)
|
Creates a new PrepareIntegrityTokenRequest opaque struct.
|
PrepareIntegrityTokenRequest_destroy(PrepareIntegrityTokenRequest *request)
|
void
Releases the specified PrepareIntegrityTokenRequest and any references it holds.
|
PrepareIntegrityTokenRequest_setCloudProjectNumber(PrepareIntegrityTokenRequest *request, int64_t cloud_project_number)
|
Sets the given cloud project number in PrepareIntegrityTokenRequest.
|
StandardIntegrityManager_destroy()
|
void
Frees up memory allocated for the Standard Integrity Manager.
|
StandardIntegrityManager_init(JavaVM *jvm, jobject android_context)
|
Initialize the Standard Integrity Manager, making the other methods available to call.
|
StandardIntegrityManager_prepareIntegrityToken(PrepareIntegrityTokenRequest *request, StandardIntegrityTokenProvider **out_provider)
|
Asynchronously prepares the integrity token and makes it available for requesting via StandardIntegrityTokenProvider.
|
StandardIntegrityTokenProvider_destroy(StandardIntegrityTokenProvider *provider)
|
void
Releases the specified StandardIntegrityTokenProvider and any references it holds.
|
StandardIntegrityTokenProvider_getStatus(StandardIntegrityTokenProvider *provider, IntegrityResponseStatus *out_status)
|
Gets the status of an ongoing StandardIntegrityManager_prepareIntegrityToken() asynchronous operation.
|
StandardIntegrityTokenProvider_request(StandardIntegrityTokenProvider *provider, StandardIntegrityTokenRequest *request, StandardIntegrityToken **out_token)
|
Asynchronously generates and returns a token for integrity-related enquiries.
|
StandardIntegrityTokenRequest_create(StandardIntegrityTokenRequest **out_request)
|
Creates a new StandardIntegrityTokenRequest opaque struct.
|
StandardIntegrityTokenRequest_destroy(StandardIntegrityTokenRequest *request)
|
void
Releases the specified StandardIntegrityTokenRequest and any references it holds.
|
StandardIntegrityTokenRequest_setRequestHash(StandardIntegrityTokenRequest *request, const char *request_hash)
|
Sets a request hash in a StandardIntegrityTokenRequest; the integrity token will be bound to this request hash.
|
StandardIntegrityToken_destroy(StandardIntegrityToken *token)
|
void
Releases the specified StandardIntegrityToken and any references it holds.
|
StandardIntegrityToken_getStatus(StandardIntegrityToken *token, IntegrityResponseStatus *out_status)
|
Gets the status of an ongoing StandardIntegrityTokenProvider_request asynchronous operation.
|
StandardIntegrityToken_getToken(StandardIntegrityToken *token)
|
const char *
Gets the token retrieved by a completed StandardIntegrityTokenProvider_request asynchronous operation, returns null pointer otherwise.
|
Enumerations
IntegrityErrorCode
IntegrityErrorCode
Errors that can be encountered while using the integrity API.
Properties | |
---|---|
INTEGRITY_API_NOT_AVAILABLE
|
Integrity API is not available. Integrity API is not enabled, or the Play Store version might be old. Recommended actions:
|
INTEGRITY_APP_NOT_INSTALLED
|
The calling app is not installed. Something is wrong (possibly an attack). Non-actionable. |
INTEGRITY_APP_UID_MISMATCH
|
The calling app UID (user id) does not match the one from Package Manager. Something is wrong (possibly an attack). Non-actionable. |
INTEGRITY_CANNOT_BIND_TO_SERVICE
|
Binding to the service in the Play Store has failed. This can be due to having an old Play Store version installed on the device. Ask the user to update Play Store. |
INTEGRITY_CLIENT_TRANSIENT_ERROR
|
There was a transient error in the client device. Introduced in Play Core Java library version 1.1.0 (prior versions returned a token with empty Device Integrity Verdict). If the error persists after a few retries, you should assume that the device has failed integrity checks and act accordingly. |
INTEGRITY_CLOUD_PROJECT_NUMBER_IS_INVALID
|
The provided cloud project number is invalid. Use the cloud project number which can be found in Project info in your Google Cloud Console for the cloud project where Play Integrity API is enabled. |
INTEGRITY_GOOGLE_SERVER_UNAVAILABLE
|
Unknown internal Google server error. Retry with an exponential backoff. Consider filing a bug if fails consistently. |
INTEGRITY_INITIALIZATION_FAILED
|
There was an error initializing the Integrity API. Retry with an exponential backoff. Consider filing a bug if fails consistently. |
INTEGRITY_INITIALIZATION_NEEDED
|
IntegrityManager is not initialized. Call IntegrityManager_init() first. |
INTEGRITY_INTERNAL_ERROR
|
Unknown internal error. Retry with an exponential backoff. Consider filing a bug if fails consistently. |
INTEGRITY_INVALID_ARGUMENT
|
Invalid argument passed to the Integrity API. Retry with correct argument. |
INTEGRITY_NETWORK_ERROR
|
No available network is found. Ask the user to check for a connection. |
INTEGRITY_NONCE_IS_NOT_BASE64
|
Nonce is not encoded as a Base64 web-safe no-wrap string. Retry with correct nonce format. |
INTEGRITY_NONCE_TOO_LONG
|
Nonce length is too long. The nonce must be less than 500 bytes before Base64 encoding. Retry with a shorter nonce. |
INTEGRITY_NONCE_TOO_SHORT
|
Nonce length is too short. The nonce must be a minimum of 16 bytes (before Base64 encoding) to allow for a better security. Retry with a longer nonce. |
INTEGRITY_NO_ERROR
|
No error has occurred. |
INTEGRITY_PLAY_SERVICES_NOT_FOUND
|
Play Services is not available or version is too old. Ask the user to Install or Update Play Services. |
INTEGRITY_PLAY_SERVICES_VERSION_OUTDATED
|
Play Services needs to be updated. Ask the user to update Google Play Services. |
INTEGRITY_PLAY_STORE_ACCOUNT_NOT_FOUND
|
No Play Store account is found on device. Note that the Play Integrity API now supports unauthenticated requests. This error code is used only for older Play Store versions that lack support. Ask the user to authenticate in Play Store. |
INTEGRITY_PLAY_STORE_NOT_FOUND
|
No Play Store app is found on device or not official version is installed. Ask the user to install an official and recent version of Play Store. |
INTEGRITY_PLAY_STORE_VERSION_OUTDATED
|
The Play Store needs to be updated. Ask the user to update the Google Play Store. |
INTEGRITY_TOO_MANY_REQUESTS
|
The calling app is making too many requests to the API and hence is throttled. Retry with an exponential backoff. |
IntegrityResponseStatus
IntegrityResponseStatus
StandardIntegrityErrorCode
StandardIntegrityErrorCode
Errors that can be encountered while using the standard integrity API.
Properties | |
---|---|
CLOUD_PROJECT_NUMBER_IS_INVALID
|
The provided cloud project number is invalid. Use the cloud project number which can be found in Project info in your Google Cloud Console for the cloud project where Play Integrity API is enabled. |
STANDARD_CLIENT_TRANSIENT_ERROR
|
There was a transient error in the client device. Retry with an exponential backoff. If the error persists after a few retries, you should assume that the device has failed integrity checks and act accordingly. |
STANDARD_INTEGRITY_API_NOT_AVAILABLE
|
Standard Integrity API is not available. Standard Integrity API is not enabled, or the Play Store version might be old. Recommended actions:
|
STANDARD_INTEGRITY_APP_NOT_INSTALLED
|
The calling app is not installed. Something is wrong (possibly an attack). Non-actionable. |
STANDARD_INTEGRITY_APP_UID_MISMATCH
|
The calling app UID (user id) does not match the one from Package Manager. Something is wrong (possibly an attack). Non-actionable. |
STANDARD_INTEGRITY_CANNOT_BIND_TO_SERVICE
|
Binding to the service in the Play Store has failed. This can be due to having an old Play Store version installed on the device or device memory is overloaded. Ask the user to update Play Store. Retry with an exponential backoff. |
STANDARD_INTEGRITY_GOOGLE_SERVER_UNAVAILABLE
|
Unknown internal Google server error. Retry with an exponential backoff. Consider filing a bug if fails consistently. |
STANDARD_INTEGRITY_INITIALIZATION_FAILED
|
There was an error initializing the Standard Integrity API. Retry with an exponential backoff. Consider filing a bug if fails consistently. |
STANDARD_INTEGRITY_INITIALIZATION_NEEDED
|
StandardIntegrityManager is not initialized. Call StandardIntegrityManager_init() first. |
STANDARD_INTEGRITY_INTERNAL_ERROR
|
Unknown internal error. Retry with an exponential backoff. Consider filing a bug if fails consistently. |
STANDARD_INTEGRITY_INVALID_ARGUMENT
|
Invalid argument passed to the Standard Integrity API. Retry with correct argument. |
STANDARD_INTEGRITY_NETWORK_ERROR
|
No available network is found. Ask the user to check for a connection. |
STANDARD_INTEGRITY_PLAY_SERVICES_NOT_FOUND
|
Play Services is not available or version is too old. Ask the user to Install or Update Play Services. |
STANDARD_INTEGRITY_PLAY_SERVICES_VERSION_OUTDATED
|
Play Services needs to be updated. Ask the user to update Google Play Services. |
STANDARD_INTEGRITY_PLAY_STORE_NOT_FOUND
|
No Play Store app is found on device or not official version is installed. Ask the user to install an official and recent version of Play Store. |
STANDARD_INTEGRITY_PLAY_STORE_VERSION_OUTDATED
|
The Play Store needs to be updated. Ask the user to update the Google Play Store. |
STANDARD_INTEGRITY_TOKEN_PROVIDER_INVALID
|
The StandardIntegrityTokenProvider is invalid (e.g. it is outdated). This error can only be returned for StandardIntegrityTokenProvider_request(). Request a new integrity token provider by calling StandardIntegrityManager_prepareIntegrityToken(). |
STANDARD_INTEGRITY_TOO_MANY_REQUESTS
|
The calling app is making too many requests to the API and hence is throttled. Retry with an exponential backoff. |
STANDARD_REQUEST_HASH_TOO_LONG
|
The provided request hash is too long. The request hash length must be less than 500 bytes. Retry with a shorter request hash. |
Typedefs
IntegrityTokenRequest
struct IntegrityTokenRequest_ IntegrityTokenRequest
An opaque struct used to provide information about an integrity token request.
IntegrityTokenResponse
struct IntegrityTokenResponse_ IntegrityTokenResponse
An opaque struct used to access information about an integrity token response.
PrepareIntegrityTokenRequest
struct PrepareIntegrityTokenRequest_ PrepareIntegrityTokenRequest
An opaque struct used to represent a prepare integrity token request.
StandardIntegrityToken
struct StandardIntegrityToken_ StandardIntegrityToken
An opaque struct used to represent a standard integrity token response.
StandardIntegrityTokenProvider
struct StandardIntegrityTokenProvider_ StandardIntegrityTokenProvider
An opaque struct used to represent a standard integrity token provider.
StandardIntegrityTokenRequest
struct StandardIntegrityTokenRequest_ StandardIntegrityTokenRequest
An opaque struct used to represent a standard integrity token request.
Functions
IntegrityManager_destroy
void IntegrityManager_destroy()
Frees up memory allocated for the Integrity API.
Does nothing if IntegrityManager_init() hasn't been called.
IntegrityManager_init
IntegrityErrorCode IntegrityManager_init( JavaVM *jvm, jobject android_context )
Initialize the Play Integrity API, making the other functions available to call.
In case of failure the Play Integrity API is unavailable, and there will be an error in logcat. The most common reason for failure is that the PlayCore AAR is missing or some of its classes/methods weren't retained by ProGuard. See also:IntegrityManager_destroy
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
INTEGRITY_NO_ERROR if initialization succeeded, or an error if failed.
|
IntegrityManager_requestIntegrityToken
IntegrityErrorCode IntegrityManager_requestIntegrityToken( IntegrityTokenRequest *request, IntegrityTokenResponse **out_response )
Starts an asynchronous operation to obtain a Play Integrity API token.
For an ongoing asynchronous operation, use IntegrityTokenResponse_getStatus() to poll for the status of the IntegrityTokenResponse. When the status reaches INTEGRITY_RESPONSE_COMPLETED with INTEGRITY_NO_ERROR, use IntegrityTokenResponse_getToken() to acquire the resulting token.
See also: IntegrityTokenResponse_destroy
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
INTEGRITY_NO_ERROR if the request started successfully, corresponding error if failed.
|
IntegrityTokenRequest_create
IntegrityErrorCode IntegrityTokenRequest_create( IntegrityTokenRequest **out_request )
Creates a new IntegrityTokenRequest opaque struct.
See also: IntegrityTokenRequest_destroy
Details | |||
---|---|---|---|
Parameters |
|
||
Returns |
An IntegrityErrorCode, which if not INTEGRITY_NO_ERROR indicates that the out parameter shouldn't be used.
|
IntegrityTokenRequest_destroy
void IntegrityTokenRequest_destroy( IntegrityTokenRequest *request )
Releases the specified IntegrityTokenRequest and any references it holds.
Details | |||
---|---|---|---|
Parameters |
|
IntegrityTokenRequest_setCloudProjectNumber
IntegrityErrorCode IntegrityTokenRequest_setCloudProjectNumber( IntegrityTokenRequest *request, int64_t cloudProjectNumber )
Sets the cloud project number to link to the integrity token.
This field is required for apps exclusively distributed outside of Google Play and SDKs. For apps distributed on Google Play, the cloud project number is configured in the Play Console and need not be set on the request.
Cloud project number can be found in Project info in your Google Cloud Console for the cloud project where Play Integrity API is enabled.
Calls to decrypt the token on Google's server must be authenticated using the cloud account that was linked to the token in this request.
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
An IntegrityErrorCode, which if not INTEGRITY_NO_ERROR indicates that this operation has failed.
|
IntegrityTokenRequest_setNonce
IntegrityErrorCode IntegrityTokenRequest_setNonce( IntegrityTokenRequest *request, const char *nonce )
Sets the nonce in an IntegrityTokenRequest with a given string.
It must be base64 encoded in web-safe no-wrap form.
See https://developer.android.com/google/play/integrity/verdict#nonce for details about the nonce requirements and recommendations.
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
An IntegrityErrorCode, which if not INTEGRITY_NO_ERROR indicates that this operation has failed.
|
IntegrityTokenResponse_destroy
void IntegrityTokenResponse_destroy( IntegrityTokenResponse *response )
Releases the specified IntegrityTokenResponse and any references it holds.
Details | |||
---|---|---|---|
Parameters |
|
IntegrityTokenResponse_getStatus
IntegrityErrorCode IntegrityTokenResponse_getStatus( IntegrityTokenResponse *response, IntegrityResponseStatus *out_status )
Gets the status of an ongoing IntegrityManager_requestIntegrityToken() asynchronous operation.
This function can be used to poll for the completion of a call to IntegrityManager_requestIntegrityToken(). This function does not make any JNI calls and can be called every frame.
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
An IntegrityErrorCode indicating the error associated with the given IntegrityTokenResponse.
|
IntegrityTokenResponse_getToken
const char * IntegrityTokenResponse_getToken( IntegrityTokenResponse *response )
Gets the token retrieved by a successful IntegrityManager_requestIntegrityToken() asynchronous operation, returns null pointer otherwise.
The JSON payload is signed and encrypted as a nested JWT, that is JWE of JWS.
JWE uses A256KW as a key wrapping algorithm and A256GCM as a content encryption algorithm. JWS uses ES256 as a signing algorithm.
All decryption and verification should be done within a secure server environment. Do not decrypt or verify the received token from within the client app. In particular, never expose any decryption keys to the client app.
See https://developer.android.com/google/play/integrity/verdict#token-format.
The string returned here is owned by the API, and the pointer will be valid until the corresponding IntegrityTokenResponse is freed by calling IntegrityTokenResponse_destroy().
Details | |||
---|---|---|---|
Parameters |
|
||
Returns |
A token which contains the response for the integrity related enquiries.
|
PrepareIntegrityTokenRequest_create
StandardIntegrityErrorCode PrepareIntegrityTokenRequest_create( PrepareIntegrityTokenRequest **out_request )
Creates a new PrepareIntegrityTokenRequest opaque struct.
See also: PrepareIntegrityTokenRequest_destroy
Details | |||
---|---|---|---|
Parameters |
|
||
Returns |
STANDARD_INTEGRITY_NO_ERROR if initialized successfully; any other value indicates that an error has occurred and the out parameter shouldn't be used.
|
PrepareIntegrityTokenRequest_destroy
void PrepareIntegrityTokenRequest_destroy( PrepareIntegrityTokenRequest *request )
Releases the specified PrepareIntegrityTokenRequest and any references it holds.
Details | |||
---|---|---|---|
Parameters |
|
PrepareIntegrityTokenRequest_setCloudProjectNumber
StandardIntegrityErrorCode PrepareIntegrityTokenRequest_setCloudProjectNumber( PrepareIntegrityTokenRequest *request, int64_t cloud_project_number )
Sets the given cloud project number in PrepareIntegrityTokenRequest.
This method should be called after initialising the request via PrepareIntegrityTokenRequest_create method.
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
STANDARD_INTEGRITY_NO_ERROR on success; any other value indicates that an error has occurred due to invalid arguments.
|
StandardIntegrityManager_destroy
void StandardIntegrityManager_destroy()
Frees up memory allocated for the Standard Integrity Manager.
Does nothing if StandardIntegrityManager_init() hasn't been called.
StandardIntegrityManager_init
StandardIntegrityErrorCode StandardIntegrityManager_init( JavaVM *jvm, jobject android_context )
Initialize the Standard Integrity Manager, making the other methods available to call.
In case of failure, the Standard Integrity API is unavailable, and there will be an error in logcat. The most common reason for failure is that the PlayCore AAR is missing or some of its classes/methods weren't retained by ProGuard. See also:StandardIntegrityManager_destroy
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
STANDARD_INTEGRITY_NO_ERROR if initialization succeeded, or an error on failure.
|
StandardIntegrityManager_prepareIntegrityToken
StandardIntegrityErrorCode StandardIntegrityManager_prepareIntegrityToken( PrepareIntegrityTokenRequest *request, StandardIntegrityTokenProvider **out_provider )
Asynchronously prepares the integrity token and makes it available for requesting via StandardIntegrityTokenProvider.
This method can be called from time to time to refresh the resulting StandardIntegrityTokenProvider. Note that this API makes a call to Google servers and hence requires a network connection.
Note that the API is in beta mode.
See also: StandardIntegrityTokenProvider_destroy
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
STANDARD_INTEGRITY_NO_ERROR if request started successfully; any other value indicates that an error has occurred and the out parameter shouldn't be used.
|
StandardIntegrityTokenProvider_destroy
void StandardIntegrityTokenProvider_destroy( StandardIntegrityTokenProvider *provider )
Releases the specified StandardIntegrityTokenProvider and any references it holds.
Details | |||
---|---|---|---|
Parameters |
|
StandardIntegrityTokenProvider_getStatus
StandardIntegrityErrorCode StandardIntegrityTokenProvider_getStatus( StandardIntegrityTokenProvider *provider, IntegrityResponseStatus *out_status )
Gets the status of an ongoing StandardIntegrityManager_prepareIntegrityToken() asynchronous operation.
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
STANDARD_INTEGRITY_NO_ERROR if the request is successful or in progress; any other value indicates an error that has occurred while requesting token provider.
|
StandardIntegrityTokenProvider_request
StandardIntegrityErrorCode StandardIntegrityTokenProvider_request( StandardIntegrityTokenProvider *provider, StandardIntegrityTokenRequest *request, StandardIntegrityToken **out_token )
Asynchronously generates and returns a token for integrity-related enquiries.
This must be called after StandardIntegrityManager_prepareIntegrityToken completes.
Note that the API is in beta mode.
See also: StandardIntegrityToken_destroy
Details | |||||||
---|---|---|---|---|---|---|---|
Parameters |
|
||||||
Returns |
STANDARD_INTEGRITY_NO_ERROR if the token request was initiated successfully; any other value indicates that an error has occurred and the out parameter shouldn't be used.
|
StandardIntegrityTokenRequest_create
StandardIntegrityErrorCode StandardIntegrityTokenRequest_create( StandardIntegrityTokenRequest **out_request )
Creates a new StandardIntegrityTokenRequest opaque struct.
See also: StandardIntegrityTokenRequest_destroy
Details | |||
---|---|---|---|
Parameters |
|
||
Returns |
STANDARD_INTEGRITY_NO_ERROR if initialized successfully; any other value indicates that an error has occurred and the out parameter shouldn't be used.
|
StandardIntegrityTokenRequest_destroy
void StandardIntegrityTokenRequest_destroy( StandardIntegrityTokenRequest *request )
Releases the specified StandardIntegrityTokenRequest and any references it holds.
Details | |||
---|---|---|---|
Parameters |
|
StandardIntegrityTokenRequest_setRequestHash
StandardIntegrityErrorCode StandardIntegrityTokenRequest_setRequestHash( StandardIntegrityTokenRequest *request, const char *request_hash )
Sets a request hash in a StandardIntegrityTokenRequest; the integrity token will be bound to this request hash.
It is recommended but not required.
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
STANDARD_INTEGRITY_NO_ERROR on success; any other value indicates that an error has occurred due to invalid arguments.
|
StandardIntegrityToken_destroy
void StandardIntegrityToken_destroy( StandardIntegrityToken *token )
Releases the specified StandardIntegrityToken and any references it holds.
Details | |||
---|---|---|---|
Parameters |
|
StandardIntegrityToken_getStatus
StandardIntegrityErrorCode StandardIntegrityToken_getStatus( StandardIntegrityToken *token, IntegrityResponseStatus *out_status )
Gets the status of an ongoing StandardIntegrityTokenProvider_request asynchronous operation.
Details | |||||
---|---|---|---|---|---|
Parameters |
|
||||
Returns |
STANDARD_INTEGRITY_NO_ERROR if the request is successful or in progress; any other value indicates an error that has occurred while requesting token.
|
StandardIntegrityToken_getToken
const char * StandardIntegrityToken_getToken( StandardIntegrityToken *token )
Gets the token retrieved by a completed StandardIntegrityTokenProvider_request asynchronous operation, returns null pointer otherwise.
The string returned here is owned by the API, and the pointer will be valid until the corresponding StandardIntegrityToken is freed by calling StandardIntegrityToken_destroy.
Details | |||
---|---|---|---|
Parameters |
|
||
Returns |
A token which contains the response for the integrity related enquiries.
|