AAL2ProcGenMessageDeactivationRpl
  • 22 Jan 2025
  • 1 Minute à lire
  • Sombre
    Lumière
  • PDF

AAL2ProcGenMessageDeactivationRpl

  • Sombre
    Lumière
  • PDF

The content is currently unavailable in French. You are viewing the default English version.
Résumé de l’article

Function Prototype

aat_int32 AAL2ProcGenMessageDeactivationRpl(
                                aat_byte       *InReply,
                                aat_int32       ReplySize,
                                aat_ascii      *DeactivationMessage,
                                aat_int32       DeactivationMessageLength);

Description

This function processes a reply from the HSM to a deactivation message generation command which has been generated with AAL2GenGenMessageDeactivationCmd.

The deactivation message generation on the HSM is identical to the functionality available with the Authentication Suite Server SDK Software Digipass Secure Channel Service. For information on the associated functions, refer to the Authentication Suite Server SDK C-C++ Programmer's Guide.

Parameters

  Table: Parameters (AAL2ProcGenMessageDeactivationRpl)
TypeNameUseDescription
aat_byte *InReplyI

String of up to 72 bytes that contain the REQUEST MESSAGE GENERATION command type and the output data from the request message generation function on the HSM:

  • Command type - 2 bytes
  • Deactivation Message - 50 characters
  • Deactivation Message Length - 4 bytes
  • Return code - 4 bytes

Plus 12 bytes for Authentication Suite Server SDK internal use.

aat_int32ReplySizeIThe length of the InReply message.
aat_ascii *DeactivationMessageO

String of up to 50+1 hexadecimal characters, null-terminated. In case of a successful operation, this parameter contains the generated deactivation message.

aat_int32 *DeactivationMessageLengthI/O

In input, this parameter must indicate the size of the allocated buffer for the DeactivationMessage parameter (recommended 51 bytes).

In output, this parameter indicates the length of the DeactivationMessage string (without the null-terminated character).

Return codes

  Table: Return codes (AAL2ProcGenMessageDeactivationRpl)
CodeMeaningCodeMeaning
0Success1274Invalid message protocol version
701Invalid input buffer pointer1275Invalid message protection type
910Invalid HSM command in reply1285Master key derivation failed
913Invalid HSM key property1288Invalid serial number prefix
917Key type inconsistent1289Invalid serial number suffix
951Invalid HSM key type for HSM decryption1293Invalid sequence number
1009Invalid TLV total length1302AES CTR encryption failed
1018Invalid TLV item pointer1307Invalid deactivation message pointer
1019Missing mandatory TLV item1308Invalid deactivation message length pointer
1025Buffer too small1333Deactivation not supported
1118Unsupported BLOB1335Invalid payload key type in payload key data
1267Invalid message vector length1336Inconsistent payload key type between payload key data and message vector
1268Invalid message vector version  

Cet article vous a-t-il été utile ?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Ozzy, facilitant la découverte de connaissances grâce à l’intelligence conversationnelle