Verify Mac

paymentcryptographydataplane_verify_mac

R Documentation

Verifies a Message Authentication Code (MAC)

Description

Verifies a Message Authentication Code (MAC).

You can use this operation to verify MAC for message data authentication such as . In this operation, you must use the same message data, secret encryption key and MAC algorithm that was used to generate MAC. You can use this operation to verify a DUPKT, CMAC, HMAC or EMV MAC by setting generation attributes and algorithm to the associated values.

For information about valid keys for this operation, see Understanding key attributes and Key types for specific data operations in the Amazon Web Services Payment Cryptography User Guide.

Cross-account use: This operation can't be used across different Amazon Web Services accounts.

Related operations:

• generate_mac

Usage

paymentcryptographydataplane_verify_mac(KeyIdentifier, MessageData, Mac,
  VerificationAttributes, MacLength)

Arguments

KeyIdentifier

[required] The keyARN of the encryption key that Amazon Web Services Payment Cryptography uses to verify MAC data.

MessageData

[required] The data on for which MAC is under verification. This value must be hexBinary.

Mac

[required] The MAC being verified.

VerificationAttributes

[required] The attributes and data values to use for MAC verification within Amazon Web Services Payment Cryptography.

MacLength

The length of the MAC.

Value

A list with the following syntax:

list(
  KeyArn = "string",
  KeyCheckValue = "string"
)

Request syntax

svc$verify_mac(
  KeyIdentifier = "string",
  MessageData = "string",
  Mac = "string",
  VerificationAttributes = list(
    Algorithm = "ISO9797_ALGORITHM1"|"ISO9797_ALGORITHM3"|"CMAC"|"HMAC_SHA224"|"HMAC_SHA256"|"HMAC_SHA384"|"HMAC_SHA512",
    EmvMac = list(
      MajorKeyDerivationMode = "EMV_OPTION_A"|"EMV_OPTION_B",
      PrimaryAccountNumber = "string",
      PanSequenceNumber = "string",
      SessionKeyDerivationMode = "EMV_COMMON_SESSION_KEY"|"EMV2000"|"AMEX"|"MASTERCARD_SESSION_KEY"|"VISA",
      SessionKeyDerivationValue = list(
        ApplicationCryptogram = "string",
        ApplicationTransactionCounter = "string"
      )
    ),
    DukptIso9797Algorithm1 = list(
      KeySerialNumber = "string",
      DukptKeyVariant = "BIDIRECTIONAL"|"REQUEST"|"RESPONSE",
      DukptDerivationType = "TDES_2KEY"|"TDES_3KEY"|"AES_128"|"AES_192"|"AES_256"
    ),
    DukptIso9797Algorithm3 = list(
      KeySerialNumber = "string",
      DukptKeyVariant = "BIDIRECTIONAL"|"REQUEST"|"RESPONSE",
      DukptDerivationType = "TDES_2KEY"|"TDES_3KEY"|"AES_128"|"AES_192"|"AES_256"
    ),
    DukptCmac = list(
      KeySerialNumber = "string",
      DukptKeyVariant = "BIDIRECTIONAL"|"REQUEST"|"RESPONSE",
      DukptDerivationType = "TDES_2KEY"|"TDES_3KEY"|"AES_128"|"AES_192"|"AES_256"
    )
  ),
  MacLength = 123
)