Full name: projects.locations.keyRings.cryptoKeys.cryptoKeyVersions.macVerify
Verifies MAC tag using a CryptoKeyVersion
with CryptoKey.purpose
MAC, and returns a response that indicates whether or not the verification was successful.
HTTP request
The URLs use gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
name |
Required. The resource name of the Authorization requires the following IAM permission on the specified resource
|
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "data": string, "dataCrc32c": string, "mac": string, "macCrc32c": string } |
Fields | |
---|---|
data |
Required. The data used previously as a A base64-encoded string. |
data |
Optional. An optional CRC32C checksum of the |
mac |
Required. The signature to verify. A base64-encoded string. |
mac |
Optional. An optional CRC32C checksum of the |
Response body
Response message for KeyManagementService.MacVerify
.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"name": string,
"success": boolean,
"verifiedDataCrc32c": boolean,
"verifiedMacCrc32c": boolean,
"verifiedSuccessIntegrity": boolean,
"protectionLevel": enum ( |
Fields | |
---|---|
name |
The resource name of the |
success |
This field indicates whether or not the verification operation for |
verified |
Integrity verification field. A flag indicating whether |
verified |
Integrity verification field. A flag indicating whether |
verified |
Integrity verification field. This value is used for the integrity verification of [MacVerifyResponse.success]. If the value of this field contradicts the value of [MacVerifyResponse.success], discard the response and perform a limited number of retries. |
protection |
The |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/cloudkms
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.