Überprüfen Sie eine PIN anhand des zuvor gespeicherten IBM3624-Pin-Offsets

In diesem Beispiel validieren Sie eine vom Karteninhaber angegebene PIN anhand des PIN-Offsets, der in der Datei beim Kartenaussteller oder Prozessor gespeichert ist. Zu den Eingaben gehören der Bestätigungsschlüssel (PVK), der Verschlüsselungsschlüssel (PEK), die primäre Kontonummer, der verschlüsselte PIN-Block vom Zahlungsterminal (oder einem anderen Upstream-Anbieter wie einem Kartennetzwerk) und der zuvor gespeicherte PIN-Offset. Wenn die PIN übereinstimmt, gibt die API eine HTTP/200 Antwort zurück.

Für diesen Befehl muss der PIN-Bestätigungsschlüssel vom Typ TR31_V1_IBM3624_PIN_VERIFICATION_KEY und der Verschlüsselungsschlüssel vom Typ A seinTR31_P0_PIN_ENCRYPTION_KEY.

Überprüfung der PIN-Länge

Der optionale --pin-data-length Parameter gibt die Länge der PIN an, die überprüft wird (4 bis 12 Ziffern). Wenn Sie diesen Parameter nicht angeben, validiert der Dienst die gesamte PIN-Länge, die durch den Offsetwert geschützt ist. Wenn Sie nur einen Teil der PIN überprüfen möchten, verwenden Sie den --pin-data-length Parameter. Wenn der Wert beispielsweise auf 4 gesetzt --pin-data-length ist, die tatsächliche PIN jedoch aus 6 Ziffern besteht, validiert der Dienst nur die 4 Ziffern ganz rechts. Die verbleibenden 2 Ziffern werden nicht geprüft. Sie könnten dies mit Absicht tun, wenn die PIN des Karteninhabers aus 6 Ziffern besteht, die eingehende PIN jedoch nur aus 4 Ziffern besteht, z. B. wenn das eingehende Netzwerk oder der Händler nur eine 4-stellige PIN unterstützt.

Beispiel

$ aws payment-cryptography-data verify-pin-data \
    --verification-key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/37y2tsl45p5zjbh2 \
    --encryption-key-identifier arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt \
    --primary-account-number 171234567890123 \
    --pin-block-format ISO_FORMAT_0 \
    --encrypted-pin-block AC17DC148BDA645E \
    --pin-data-length 4 \
    --verification-attributes Ibm3624PinOffset="{DecimalizationTable=9876543210654321,PinValidationDataPadCharacter=D,PinValidationData=171234567890123,PinOffset=5507}"

{
    "VerificationKeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/37y2tsl45p5zjbh2",
    "VerificationKeyCheckValue": "7F2363",
    "EncryptionKeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt",
    "EncryptionKeyCheckValue": "7CC9E2"
}