public sealed class MacVerifyRequest : IMessage<MacVerifyRequest>, IEquatable<MacVerifyRequest>, IDeepCloneable<MacVerifyRequest>, IBufferMessage, IMessage
Reference documentation and code samples for the Google Cloud Key Management Service v1 API class MacVerifyRequest.
Request message for
[KeyManagementService.MacVerify][google.cloud.kms.v1.KeyManagementService.MacVerify].
Optional. An optional CRC32C checksum of the
[MacVerifyRequest.data][google.cloud.kms.v1.MacVerifyRequest.data]. If
specified, [KeyManagementService][google.cloud.kms.v1.KeyManagementService]
will verify the integrity of the received
[MacVerifyRequest.data][google.cloud.kms.v1.MacVerifyRequest.data] using
this checksum.
[KeyManagementService][google.cloud.kms.v1.KeyManagementService] will
report an error if the checksum verification fails. If you receive a
checksum error, your client should verify that
CRC32C([MacVerifyRequest.data][google.cloud.kms.v1.MacVerifyRequest.data])
is equal to
[MacVerifyRequest.data_crc32c][google.cloud.kms.v1.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.
Optional. An optional CRC32C checksum of the
[MacVerifyRequest.mac][google.cloud.kms.v1.MacVerifyRequest.mac]. If
specified, [KeyManagementService][google.cloud.kms.v1.KeyManagementService]
will verify the integrity of the received
[MacVerifyRequest.mac][google.cloud.kms.v1.MacVerifyRequest.mac] using this
checksum. [KeyManagementService][google.cloud.kms.v1.KeyManagementService]
will report an error if the checksum verification fails. If you receive a
checksum error, your client should verify that
CRC32C([MacVerifyRequest.mac][google.cloud.kms.v1.MacVerifyRequest.mac]) is
equal to
[MacVerifyRequest.mac_crc32c][google.cloud.kms.v1.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.
Property Value
Type
Description
System.Int64
Name
public string Name { get; set; }
Required. The resource name of the
[CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to use for
verification.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eMacVerifyRequest\u003c/code\u003e class is used to verify a MAC (Message Authentication Code) tag, which is part of the Google Cloud Key Management Service v1 API.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version of the \u003ccode\u003eMacVerifyRequest\u003c/code\u003e class is 3.16.0, with several older versions available for reference, ranging back to 2.2.0.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eMacVerifyRequest\u003c/code\u003e class implements multiple interfaces, including \u003ccode\u003eIMessage\u003c/code\u003e, \u003ccode\u003eIEquatable\u003c/code\u003e, \u003ccode\u003eIDeepCloneable\u003c/code\u003e, and \u003ccode\u003eIBufferMessage\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eKey properties of the \u003ccode\u003eMacVerifyRequest\u003c/code\u003e class include \u003ccode\u003eCryptoKeyVersionName\u003c/code\u003e, \u003ccode\u003eData\u003c/code\u003e, \u003ccode\u003eDataCrc32C\u003c/code\u003e, \u003ccode\u003eMac\u003c/code\u003e, \u003ccode\u003eMacCrc32C\u003c/code\u003e, and \u003ccode\u003eName\u003c/code\u003e, which are essential for the MAC verification process.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eMacVerifyRequest\u003c/code\u003e class has two constructors, one default and another that takes another \u003ccode\u003eMacVerifyRequest\u003c/code\u003e instance as a parameter.\u003c/p\u003e\n"]]],[],null,["# Google Cloud Key Management Service v1 API - Class MacVerifyRequest (3.18.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.18.0 (latest)](/dotnet/docs/reference/Google.Cloud.Kms.V1/latest/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.17.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.17.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.16.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.16.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.15.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.15.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.14.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.14.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.13.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.13.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.12.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.12.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.11.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.11.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.10.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.10.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.9.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.9.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.8.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.8.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.7.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.7.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.6.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.6.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.5.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.5.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.4.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.4.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.3.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.3.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.2.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.2.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.1.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.1.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [3.0.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/3.0.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [2.9.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/2.9.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [2.8.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/2.8.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [2.7.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/2.7.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [2.6.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/2.6.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [2.5.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/2.5.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [2.4.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/2.4.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [2.3.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/2.3.0/Google.Cloud.Kms.V1.MacVerifyRequest)\n- [2.2.0](/dotnet/docs/reference/Google.Cloud.Kms.V1/2.2.0/Google.Cloud.Kms.V1.MacVerifyRequest) \n\n public sealed class MacVerifyRequest : IMessage\u003cMacVerifyRequest\u003e, IEquatable\u003cMacVerifyRequest\u003e, IDeepCloneable\u003cMacVerifyRequest\u003e, IBufferMessage, IMessage\n\nReference documentation and code samples for the Google Cloud Key Management Service v1 API class MacVerifyRequest.\n\nRequest message for\n\\[KeyManagementService.MacVerify\\]\\[google.cloud.kms.v1.KeyManagementService.MacVerify\\]. \n\nInheritance\n-----------\n\n[object](https://learn.microsoft.com/dotnet/api/system.object) \\\u003e MacVerifyRequest \n\nImplements\n----------\n\n[IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage-1.html)[MacVerifyRequest](/dotnet/docs/reference/Google.Cloud.Kms.V1/latest/Google.Cloud.Kms.V1.MacVerifyRequest), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[MacVerifyRequest](/dotnet/docs/reference/Google.Cloud.Kms.V1/latest/Google.Cloud.Kms.V1.MacVerifyRequest), [IDeepCloneable](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IDeepCloneable-1.html)[MacVerifyRequest](/dotnet/docs/reference/Google.Cloud.Kms.V1/latest/Google.Cloud.Kms.V1.MacVerifyRequest), [IBufferMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IBufferMessage.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage.html) \n\nInherited Members\n-----------------\n\n[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode) \n[object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) \n[object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)\n\nNamespace\n---------\n\n[Google.Cloud.Kms.V1](/dotnet/docs/reference/Google.Cloud.Kms.V1/latest/Google.Cloud.Kms.V1)\n\nAssembly\n--------\n\nGoogle.Cloud.Kms.V1.dll\n\nConstructors\n------------\n\n### MacVerifyRequest()\n\n public MacVerifyRequest()\n\n### MacVerifyRequest(MacVerifyRequest)\n\n public MacVerifyRequest(MacVerifyRequest other)\n\nProperties\n----------\n\n### CryptoKeyVersionName\n\n public CryptoKeyVersionName CryptoKeyVersionName { get; set; }\n\n[CryptoKeyVersionName](/dotnet/docs/reference/Google.Cloud.Kms.V1/latest/Google.Cloud.Kms.V1.CryptoKeyVersionName)-typed view over the [Name](/dotnet/docs/reference/Google.Cloud.Kms.V1/latest/Google.Cloud.Kms.V1.MacVerifyRequest#Google_Cloud_Kms_V1_MacVerifyRequest_Name) resource name property.\n\n### Data\n\n public ByteString Data { get; set; }\n\nRequired. The data used previously as a\n\\[MacSignRequest.data\\]\\[google.cloud.kms.v1.MacSignRequest.data\\] to generate\nthe MAC tag.\n\n### DataCrc32C\n\n public long? DataCrc32C { get; set; }\n\nOptional. An optional CRC32C checksum of the\n\\[MacVerifyRequest.data\\]\\[google.cloud.kms.v1.MacVerifyRequest.data\\]. If\nspecified, \\[KeyManagementService\\]\\[google.cloud.kms.v1.KeyManagementService\\]\nwill verify the integrity of the received\n\\[MacVerifyRequest.data\\]\\[google.cloud.kms.v1.MacVerifyRequest.data\\] using\nthis checksum.\n\\[KeyManagementService\\]\\[google.cloud.kms.v1.KeyManagementService\\] will\nreport an error if the checksum verification fails. If you receive a\nchecksum error, your client should verify that\nCRC32C(\\[MacVerifyRequest.data\\]\\[google.cloud.kms.v1.MacVerifyRequest.data\\])\nis equal to\n\\[MacVerifyRequest.data_crc32c\\]\\[google.cloud.kms.v1.MacVerifyRequest.data_crc32c\\],\nand if so, perform a limited number of retries. A persistent mismatch may\nindicate an issue in your computation of the CRC32C checksum. Note: This\nfield is defined as int64 for reasons of compatibility across different\nlanguages. However, it is a non-negative integer, which will never exceed\n2\\^32-1, and can be safely downconverted to uint32 in languages that support\nthis type.\n\n### Mac\n\n public ByteString Mac { get; set; }\n\nRequired. The signature to verify.\n\n### MacCrc32C\n\n public long? MacCrc32C { get; set; }\n\nOptional. An optional CRC32C checksum of the\n\\[MacVerifyRequest.mac\\]\\[google.cloud.kms.v1.MacVerifyRequest.mac\\]. If\nspecified, \\[KeyManagementService\\]\\[google.cloud.kms.v1.KeyManagementService\\]\nwill verify the integrity of the received\n\\[MacVerifyRequest.mac\\]\\[google.cloud.kms.v1.MacVerifyRequest.mac\\] using this\nchecksum. \\[KeyManagementService\\]\\[google.cloud.kms.v1.KeyManagementService\\]\nwill report an error if the checksum verification fails. If you receive a\nchecksum error, your client should verify that\nCRC32C(\\[MacVerifyRequest.mac\\]\\[google.cloud.kms.v1.MacVerifyRequest.mac\\]) is\nequal to\n\\[MacVerifyRequest.mac_crc32c\\]\\[google.cloud.kms.v1.MacVerifyRequest.mac_crc32c\\],\nand if so, perform a limited number of retries. A persistent mismatch may\nindicate an issue in your computation of the CRC32C checksum. Note: This\nfield is defined as int64 for reasons of compatibility across different\nlanguages. However, it is a non-negative integer, which will never exceed\n2\\^32-1, and can be safely downconverted to uint32 in languages that support\nthis type.\n\n### Name\n\n public string Name { get; set; }\n\nRequired. The resource name of the\n\\[CryptoKeyVersion\\]\\[google.cloud.kms.v1.CryptoKeyVersion\\] to use for\nverification."]]
