Cloud KMS V1 Client - Class DecapsulateResponse (2.4.0)

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

Response message for KeyManagementService.Decapsulate.

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

Namespace

Google \ Cloud \ Kms \ V1

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ name string

The resource name of the CryptoKeyVersion used for decapsulation. Check this field to verify that the intended resource was used for decapsulation.

↳ shared_secret string

The decapsulated shared_secret originally encapsulated with the matching public key.

↳ shared_secret_crc32c int|string

Integrity verification field. A CRC32C checksum of the returned DecapsulateResponse.shared_secret. An integrity check of DecapsulateResponse.shared_secret can be performed by computing the CRC32C checksum of DecapsulateResponse.shared_secret and comparing your results to this field. Discard the response in case of non-matching checksum values, and perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: receiving this response message indicates that KeyManagementService is able to successfully decrypt the ciphertext. 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.

↳ verified_ciphertext_crc32c bool

Integrity verification field. A flag indicating whether DecapsulateRequest.ciphertext_crc32c was received by KeyManagementService and used for the integrity verification of the ciphertext. A false value of this field indicates either that DecapsulateRequest.ciphertext_crc32c was left unset or that it was not delivered to KeyManagementService. If you've set DecapsulateRequest.ciphertext_crc32c but this field is still false, discard the response and perform a limited number of retries.

↳ protection_level int

The ProtectionLevel of the CryptoKeyVersion used in decapsulation.

getName

The resource name of the CryptoKeyVersion used for decapsulation. Check this field to verify that the intended resource was used for decapsulation.

Returns
Type Description
string

setName

The resource name of the CryptoKeyVersion used for decapsulation. Check this field to verify that the intended resource was used for decapsulation.

Parameter
Name Description
var string
Returns
Type Description
$this

getSharedSecret

The decapsulated shared_secret originally encapsulated with the matching public key.

Returns
Type Description
string

setSharedSecret

The decapsulated shared_secret originally encapsulated with the matching public key.

Parameter
Name Description
var string
Returns
Type Description
$this

getSharedSecretCrc32C

Integrity verification field. A CRC32C checksum of the returned DecapsulateResponse.shared_secret.

An integrity check of DecapsulateResponse.shared_secret can be performed by computing the CRC32C checksum of DecapsulateResponse.shared_secret and comparing your results to this field. Discard the response in case of non-matching checksum values, and perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: receiving this response message indicates that KeyManagementService is able to successfully decrypt the ciphertext. 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

hasSharedSecretCrc32C

clearSharedSecretCrc32C

setSharedSecretCrc32C

Integrity verification field. A CRC32C checksum of the returned DecapsulateResponse.shared_secret.

An integrity check of DecapsulateResponse.shared_secret can be performed by computing the CRC32C checksum of DecapsulateResponse.shared_secret and comparing your results to this field. Discard the response in case of non-matching checksum values, and perform a limited number of retries. A persistent mismatch may indicate an issue in your computation of the CRC32C checksum. Note: receiving this response message indicates that KeyManagementService is able to successfully decrypt the ciphertext. 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
Returns
Type Description
$this

getVerifiedCiphertextCrc32C

Integrity verification field. A flag indicating whether DecapsulateRequest.ciphertext_crc32c was received by KeyManagementService and used for the integrity verification of the ciphertext. A false value of this field indicates either that DecapsulateRequest.ciphertext_crc32c was left unset or that it was not delivered to KeyManagementService. If you've set DecapsulateRequest.ciphertext_crc32c but this field is still false, discard the response and perform a limited number of retries.

Returns
Type Description
bool

setVerifiedCiphertextCrc32C

Integrity verification field. A flag indicating whether DecapsulateRequest.ciphertext_crc32c was received by KeyManagementService and used for the integrity verification of the ciphertext. A false value of this field indicates either that DecapsulateRequest.ciphertext_crc32c was left unset or that it was not delivered to KeyManagementService. If you've set DecapsulateRequest.ciphertext_crc32c but this field is still false, discard the response and perform a limited number of retries.

Parameter
Name Description
var bool
Returns
Type Description
$this

getProtectionLevel

The ProtectionLevel of the CryptoKeyVersion used in decapsulation.

Returns
Type Description
int Enum of type ProtectionLevel.

setProtectionLevel

The ProtectionLevel of the CryptoKeyVersion used in decapsulation.

Parameter
Name Description
var int

Enum of type ProtectionLevel.

Returns
Type Description
$this