Cloud KMS V1 Client - Class MacVerifyRequest (2.3.1)

Reference documentation and code samples for the Cloud KMS V1 Client class MacVerifyRequest.

Request message for KeyManagementService.MacVerify .

Generated from protobuf message google.cloud.kms.v1.MacVerifyRequest

Namespace

Google \ Cloud \ Kms \ V1

Methods

__construct

Constructor.

Parameters
Name
Description
data
array

Optional. Data for populating the Message object.

↳ name
string

Required. The resource name of the CryptoKeyVersion to use for verification.

↳ data
string

Required. The data used previously as a MacSignRequest.data to generate the MAC tag.

↳ data_crc32c
Google\Protobuf\Int64Value

Optional. An optional CRC32C checksum of the MacVerifyRequest.data . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.data using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.data ) is equal to MacVerifyRequest.data_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

↳ mac
string

Required. The signature to verify.

↳ mac_crc32c
Google\Protobuf\Int64Value

Optional. An optional CRC32C checksum of the MacVerifyRequest.mac . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.mac using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.mac ) is equal to MacVerifyRequest.mac_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

getName

Required. The resource name of the CryptoKeyVersion to use for verification.

Returns
Type
Description
string

setName

Required. The resource name of the CryptoKeyVersion to use for verification.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getData

Required. The data used previously as a MacSignRequest.data to generate the MAC tag.

Returns
Type
Description
string

setData

Required. The data used previously as a MacSignRequest.data to generate the MAC tag.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getDataCrc32C

Optional. An optional CRC32C checksum of the MacVerifyRequest.data . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.data using this checksum.

KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.data ) is equal to MacVerifyRequest.data_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

Returns
Type
Description

hasDataCrc32C

clearDataCrc32C

getDataCrc32CUnwrapped

Returns the unboxed value from getDataCrc32C()

Optional. An optional CRC32C checksum of the MacVerifyRequest.data . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.data using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.data ) is equal to MacVerifyRequest.data_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

Returns
Type
Description
int|string|null

setDataCrc32C

Optional. An optional CRC32C checksum of the MacVerifyRequest.data . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.data using this checksum.

KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.data ) is equal to MacVerifyRequest.data_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

Parameter
Name
Description
Returns
Type
Description
$this

setDataCrc32CUnwrapped

Sets the field by wrapping a primitive type in a Google\Protobuf\Int64Value object.

Optional. An optional CRC32C checksum of the MacVerifyRequest.data . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.data using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.data ) is equal to MacVerifyRequest.data_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

Parameter
Name
Description
var
int|string|null
Returns
Type
Description
$this

getMac

Required. The signature to verify.

Returns
Type
Description
string

setMac

Required. The signature to verify.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getMacCrc32C

Optional. An optional CRC32C checksum of the MacVerifyRequest.mac . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.mac using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.mac ) is equal to MacVerifyRequest.mac_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

Returns
Type
Description

hasMacCrc32C

clearMacCrc32C

getMacCrc32CUnwrapped

Returns the unboxed value from getMacCrc32C()

Optional. An optional CRC32C checksum of the MacVerifyRequest.mac . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.mac using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.mac ) is equal to MacVerifyRequest.mac_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

Returns
Type
Description
int|string|null

setMacCrc32C

Optional. An optional CRC32C checksum of the MacVerifyRequest.mac . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.mac using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.mac ) is equal to MacVerifyRequest.mac_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

Parameter
Name
Description
Returns
Type
Description
$this

setMacCrc32CUnwrapped

Sets the field by wrapping a primitive type in a Google\Protobuf\Int64Value object.

Optional. An optional CRC32C checksum of the MacVerifyRequest.mac . If specified, KeyManagementService will verify the integrity of the received MacVerifyRequest.mac using this checksum. KeyManagementService will report an error if the checksum verification fails. If you receive a checksum error, your client should verify that CRC32C( MacVerifyRequest.mac ) is equal to MacVerifyRequest.mac_crc32c , and if so, perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: This field is defined as int64 for reasons of compatibility across different languages. However, it is a non-negative integer, which will never exceed 2^32-1, and can be safely downconverted to uint32 in languages that support this type.

Parameter
Name
Description
var
int|string|null
Returns
Type
Description
$this

static::build

Parameters
Name
Description
name
string

Required. The resource name of the CryptoKeyVersion to use for verification. Please see KeyManagementServiceClient::cryptoKeyVersionName() for help formatting this field.

data
string

Required. The data used previously as a MacSignRequest.data to generate the MAC tag.

mac
string

Required. The signature to verify.

Returns
Type
Description
Create a Mobile Website
View Site in Mobile | Classic
Share by: