--- title: "AAL2VerifySignatureEs" slug: "a3s-cppprg-aal2verifysignaturees-4-0" updated: 2026-11-11T09:52:07Z published: 2026-11-11T09:52:07Z canonical: "docs.onespan.com/a3s-cppprg-aal2verifysignaturees-4-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # AAL2VerifySignatureEs ## Function prototype ```cpp aat_int32 AAL2VerifySignatureEs ( TDigipassBlob* DPData, TKernelParms* CallParms, aat_ascii* Signature, aat_ascii* SignedDataFields [8], aat_int32 FieldCount, aat_int32 DeferredSignatureData aat_ascii* aServerPublicKey, aat_ascii* ConfirmationCode, aat_ascii* ConfirmationCodeLength); ``` ## Description This function is an extension of AAL2VerifySignatureEx, offering the enhanced security feature. This feature prevents potential man-in-the-middle attacks in the architecture integrating software Digipass authenticators. A server public key, such as a certificate, can be used in input to diversify the challenge. In addition, this function introduces pre-processing on the DataFields in input; each DataField can have up to 32000 characters. > The enhanced signature validation function is supported by Digipass 110 and Digipass for Web. ## Parameters | Type | Name | Use | Description | | --- | --- | --- | --- | | TDigipassBlob * | DPData | I/O | authenticator application BLOB. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes. | | TKernelParms * | CallParms | I | Structure of runtime parameters to use during this function call. | | aat_ascii * | Signature | I | String of up to 17 numeric characters, left-justified, null-terminated, or right-padded with spaces. | | aat_ascii *[8] | SignedDataFields | I | Array of 8 null-terminated strings of up to 32000 printable ASCII-EBCDIC invariant characters. This parameter holds the 8 possible data fields that are used to generate a signature. For a list of the characters that can be used for the data fields, see [Supported data fields charset](/secsdks/docs/a3s-cppprg-aal2verifysignaturees-4-0#supported-data-fields-charset). | | aat_int32 | FieldCount | I | Numeric value from 1 to 8 indicating the number of data fields to use from the SignedDataFields array. | | aat_int32 | Deferred signature data | I | - Must be 0 if signature is validated in online mode (OnlineSG=1 or 2). - If signature is validated in offline mode with OnlineSG=0, this parameter can receive the Digipass date of the signature generation (number of elapsed seconds since January 1, 1970) or 0. (With 0, the current time is used.) If this parameter is >0, the filled parameter must be the Digipass time, not the host time. - If the signature is validated in offline mode with OnlineSG=3, this parameter must receive counter of the Digipass instance used for the signature generation. | | aat_ascii * | aServerPublicKey | I | String of up to 1024 hexadecimal characters, null-terminated. This parameter is used as a diversifier to prevent man-in-the-middle attacks. If this parameter is NULL, diversification will not take place. | | aat_ascii * | Confirmation code | O | String of up to 17 numeric or hexadecimal characters, left-justified, null-terminated, or right-padded with spaces. This is the confirmation code generated by Authentication Suite Server SDK (recommended buffer size is 18 bytes). | | aat_int32 * | Confirmation CodeLength | O | Pointer to a long integer that indicates the length of the generated return host code. | ## Return codes | Code | Meaning | Code | Meaning | | --- | --- | --- | --- | | 0 | Success | 510 | Invalid Digipass data pointer | | 10001 | Success with context warning[[1]](/secsdks/docs/a3s-cppprg-aal2verifysignaturees-4-0#Cite_1) | 1103 | Unlock Version 2 not supported | | 10002 | Success with user warning[[1]](/secsdks/docs/a3s-cppprg-aal2verifysignaturees-4-0#Cite_1) | 1116 | Response check digit not allowed | | 10003 | Success with user & context warning[[1]](/secsdks/docs/a3s-cppprg-aal2verifysignaturees-4-0#Cite_1) | 1117 | Challenge check digit not allowed | | 10004 | Success with platform warning[[1]](/secsdks/docs/a3s-cppprg-aal2verifysignaturees-4-0#Cite_1) | 1118 | Unsupported BLOB | | 10005 | Success with platform & context warning[[1]](/secsdks/docs/a3s-cppprg-aal2verifysignaturees-4-0#Cite_1) | -101 | Data field too short | | 10006 | Success with platform & user warning[[1]](/secsdks/docs/a3s-cppprg-aal2verifysignaturees-4-0#Cite_1) | -103 | Data field check digit wrong | | 10007 | Success with platform & user & context warning[[1]](/secsdks/docs/a3s-cppprg-aal2verifysignaturees-4-0#Cite_1) | -105 | Challenge minimum length not allowed | | 1 | Signature not verified | -102 | Data field too long | | 132 | Unsupported token type | -106 | Challenge maximum length not allowed | | 139 | Invalid signature pointer | -107 | Challenge number wrong | | 141 | Invalid field count | -108 | Challenge character invalid | | 148 | Invalid data field pointer | -153 | Server public key too long | | 203 | Sign error threshold reached | -201 | Response length out of bounds | | 204 | Duplicate signature found | -202 | Response too short | | 205 | Inactive days reached | -203 | Response too long | | 206 | Chronological signature error | -204 | Response check digit wrong | | 207 | Deferred signature not allowed with OnLineSG not Null | -205 | Response character not decimal | | 208 | Application disabled | -206 | Response character not hexadecimal | | 412 | Invalid checksum | -207 | Response character set not specified | | 413 | Invalid Base64 format | -1501 | Memory allocation failed | 1. Specific score-based authentication code (see [Score-based DIGIPASS](/secsdks/docs/a3s-cppprg-aal2verifysignature-4-0#scorebased-digipass)) ## Supported data fields charset The following table lists the supported characters for the data fields of AAL2VerifySignatureEs with associated hexadecimal values in ASCII and EBCDIC. | Character | Hex ASCII value | Hex EBCDIC value | Character | Hex ASCII value | Hex EBCDIC value | | --- | --- | --- | --- | --- | --- | | space | 0x20 | 0x40 | | | | | ! | 0x21 | 0x5A | P | 0x50 | 0xD7 | | “ | 0x22 | 0x7F | Q | 0x51 | 0xD8 | | # | 0x23 | 0x7B | R | 0x52 | 0xD9 | | $ | 0x24 | 0x5B | S | 0x53 | 0xE2 | | % | 0x25 | 0x6C | T | 0x54 | 0xE3 | | & | 0x26 | 0x50 | U | 0x55 | 0xE4 | | ' | 0x27 | 0x7D | V | 0x56 | 0xE5 | | ( | 0x28 | 0x4D | W | 0x57 | 0xE6 | | ) | 0x29 | 0x5D | X | 0x58 | 0xE7 | | * | 0x2A | 0x5C | Y | 0x59 | 0xE8 | | + | 0x2B | 0x4E | Z | 0x5A | 0xE9 | | , | 0x2C | 0x6B | [ | 0x5B | 0xAD | | - | 0x2D | 0x60 | \ | 0x5C | 0xE0 | | . | 0x2E | 0x4B | ] | 0x5D | 0xBD | | / | 0x2F | 0x61 | ^ | 0x5E | 0x5F | | 0 | 0x30 | 0xF0 | _ | 0x5F | 0x6D | | 1 | 0x31 | 0xF1 | ` | 0x60 | 0x79 | | 2 | 0x32 | 0xF2 | a | 0x61 | 0x81 | | 3 | 0x33 | 0xF3 | b | 0x62 | 0x82 | | 4 | 0x34 | 0xF4 | c | 0x63 | 0x83 | | 5 | 0x35 | 0xF5 | d | 0x64 | 0x84 | | 6 | 0x36 | 0xF6 | e | 0x65 | 0x85 | | 7 | 0x37 | 0xF7 | f | 0x66 | 0x86 | | 8 | 0x38 | 0xF8 | g | 0x67 | 0x87 | | 9 | 0x39 | 0xF9 | h | 0x68 | 0x88 | | : | 0x3A | 0x7A | i | 0x69 | 0x89 | | ; | 0x3B | 0x5E | j | 0x6A | 0x91 | | < | 0x3C | 0x4C | k | 0x6B | 0x92 | | = | 0x3D | 0x7E | l | 0x6C | 0x93 | | > | 0x3E | 0x6E | m | 0x6D | 0x94 | | ? | 0x3F | 0x6F | n | 0x6E | 0x95 | | @ | 0x40 | 0x7C | o | 0x6F | 0x96 | | A | 0x41 | 0xC1 | p | 0x70 | 0x97 | | B | 0x42 | 0xC2 | q | 0x71 | 0x98 | | C | 0x43 | 0xC3 | r | 0x72 | 0x99 | | D | 0x44 | 0xC4 | s | 0x73 | 0xA2 | | E | 0x45 | 0xC5 | t | 0x74 | 0xA3 | | F | 0x46 | 0xC6 | u | 0x75 | 0xA4 | | G | 0x47 | 0xC7 | v | 0x76 | 0xA5 | | H | 0x48 | 0xC8 | w | 0x77 | 0xA6 | | I | 0x49 | 0xC9 | x | 0x78 | 0xA7 | | J | 0x4A | 0xD1 | y | 0x79 | 0xA8 | | K | 0x4B | 0xD2 | z | 0x7A | 0xA9 | | L | 0x4C | 0xD3 | ( | 0x7B | 0xC0 | | M | 0x4D | 0xD4 | \| | 0x7C | 0x4F | | N | 0x4E | 0xD5 | ) | 0x7D | 0xD0 | | O | 0x4F | 0xD6 | ~ | 0x7E | 0xA1 |