Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AWS Payment Cryptography Contoh Data Plane menggunakan AWS CLI
Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan AWS Payment Cryptography Data Plane.
*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.
Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.
**Topics**
+ [Tindakan](#actions)
## Tindakan
### `mendekripsi data`
Contoh kode berikut menunjukkan cara menggunakan`decrypt-data`.
**AWS CLI**
**Untuk mendekripsi ciphertext **
`decrypt-data`Contoh berikut mendekripsi data ciphertext menggunakan kunci simetris. Untuk operasi ini, kunci harus disetel `KeyModesOfUse` ke `Decrypt` dan diset `KeyUsage` el ke`TR31_D0_SYMMETRIC_DATA_ENCRYPTION_KEY`.
```
aws payment-cryptography-data decrypt-data \
--key-identifier {{arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h}} \
--cipher-text {{33612AB9D6929C3A828EB6030082B2BD}} \
--decryption-attributes '{{Symmetric={Mode=CBC}}}'
```
Output:
```
{
"KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h",
"KeyCheckValue": "71D7AE",
"PlainText": "31323334313233343132333431323334"
}
```
Untuk informasi selengkapnya, lihat Men [ dekripsi data ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/decrypt-data.html) di *AWS Panduan * Pengguna Kriptografi Pembayaran.
+ Untuk detail API, lihat [ DecryptData ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/decrypt-data.html) di Refer *AWS CLI ensi Perintah*.
### `mengenkripsi-data`
Contoh kode berikut menunjukkan cara menggunakan`encrypt-data`.
**AWS CLI**
**Untuk mengenkripsi data **
`encrypt-data`Contoh berikut mengenkripsi data plaintext menggunakan kunci simetris. Untuk operasi ini, kunci harus disetel `KeyModesOfUse` ke `Encrypt` dan diset `KeyUsage` el ke`TR31_D0_SYMMETRIC_DATA_ENCRYPTION_KEY`.
```
aws payment-cryptography-data encrypt-data \
--key-identifier {{arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h}} \
--plain-text {{31323334313233343132333431323334}} \
--encryption-attributes '{{Symmetric={Mode=CBC}}}'
```
Output:
```
{
"KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h",
"KeyCheckValue": "71D7AE",
"CipherText": "33612AB9D6929C3A828EB6030082B2BD"
}
```
Untuk informasi selengkapnya, lihat Men [ genkripsi data ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/encrypt-data.html) di *AWS Panduan * Pengguna Kriptografi Pembayaran.
+ Untuk detail API, lihat [ EncryptData ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/encrypt-data.html) di Refer *AWS CLI ensi Perintah*.
### `menghasilkan data validasi kartu`
Contoh kode berikut menunjukkan cara menggunakan`generate-card-validation-data`.
**AWS CLI**
**Untuk menghasilkan CVV **
`generate-card-validation-data`Contoh berikut menghasilkan a CVV/CVV2.
```
aws payment-cryptography-data generate-card-validation-data \
--key-identifier {{arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h}} \
--primary-account-number=171234567890123 \
--generation-attributes {{CardVerificationValue2={CardExpiryDate=0123}}}
```
Output:
```
{
"KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h",
"KeyCheckValue": "CADDA1",
"ValidationData": "801"
}
```
Untuk informasi selengkapnya, lihat [ Menghasilkan data kartu ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/generate-card-data.html) di Panduan * Pengguna Kriptografi Pembayaran. *AWS
+ Untuk detail API, lihat [ GenerateCardValidationData ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/generate-card-validation-data.html) di Refer *AWS CLI ensi Perintah*.
### `generasi-mac`
Contoh kode berikut menunjukkan cara menggunakan`generate-mac`.
**AWS CLI**
**Untuk menghasilkan MAC **
`generate-card-validation-data`Contoh berikut menghasilkan Kode Otentikasi Hash-Based Pesan (HMAC) untuk otentikasi data kartu menggunakan algoritma HMAC\_SHA256 dan kunci enkripsi HMAC. Kunci harus diset `KeyUsage` el ke `TR31_M7_HMAC_KEY` dan `KeyModesOfUse` ke`Generate`.
```
aws payment-cryptography-data generate-mac \
--key-identifier {{arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h}} \
--message-data {{"3b313038383439303031303733393431353d32343038323236303030373030303f33"}} \
--generation-attributes {{Algorithm=HMAC_SHA256}}
```
Output:
```
{
"KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h,
"KeyCheckValue": "2976E7",
"Mac": "ED87F26E961C6D0DDB78DA5038AA2BDDEA0DCE03E5B5E96BDDD494F4A7AA470C"
}
```
Untuk informasi selengkapnya, lihat [ Menghasilkan MAC ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/generate-mac.html) di Panduan * Pengguna Kriptografi Pembayaran. *AWS
+ Untuk detail API, lihat [ GenerateMac ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/generate-mac.html) di Refer *AWS CLI ensi Perintah*.
### `menghasilkan pin-data`
Contoh kode berikut menunjukkan cara menggunakan`generate-pin-data`.
**AWS CLI**
**Untuk menghasilkan PIN **
`generate-card-validation-data`Contoh berikut menghasilkan PIN acak baru menggunakan skema PIN Visa.
```
aws payment-cryptography-data generate-pin-data \
--generation-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}} \
--generation-attributes {{VisaPin={PinVerificationKeyIndex=1}}}
```
Output:
```
{
"GenerationKeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/37y2tsl45p5zjbh2",
"GenerationKeyCheckValue": "7F2363",
"EncryptionKeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt",
"EncryptionKeyCheckValue": "7CC9E2",
"EncryptedPinBlock": "AC17DC148BDA645E",
"PinData": {
"VerificationValue": "5507"
}
}
```
Untuk informasi selengkapnya, lihat [ Menghasilkan data PIN ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/generate-pin-data.html) di Panduan * Pengguna Kriptografi Pembayaran. *AWS
+ Untuk detail API, lihat [ GeneratePinData ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/generate-pin-data.html) di Refer *AWS CLI ensi Perintah*.
### `mengenkripsi ulang data`
Contoh kode berikut menunjukkan cara menggunakan`re-encrypt-data`.
**AWS CLI**
**Untuk mengenkripsi ulang data dengan kunci yang berbeda **
`re-encrypt-data`Contoh berikut mendekripsi teks sandi yang dienkripsi menggunakan kunci simetris AES dan mengenkripsi ulang menggunakan kunci Derived Unique Per Transaction (DUKPT).
```
aws payment-cryptography-data re-encrypt-data \
--incoming-key-identifier {{arn:aws:payment-cryptography:us-west-2:111122223333:key/hyvv7ymboitd4vfy}} \
--outgoing-key-identifier {{arn:aws:payment-cryptography:us-west-2:111122223333:key/jl6ythkcvzesbxen}} \
--cipher-text {{4D2B0BDBA192D5AEFEAA5B3EC28E4A65383C313FFA25140101560F75FE1B99F27192A90980AB9334}} \
--incoming-encryption-attributes {{"Dukpt={Mode=ECB,KeySerialNumber=0123456789111111}"}} \
--outgoing-encryption-attributes '{{{"Symmetric": {"Mode": "ECB"}}}}'
```
Output:
```
{
"CipherText": "F94959DA30EEFF0C035483C6067667CF6796E3C1AD28C2B61F9CFEB772A8DD41C0D6822931E0D3B1",
"KeyArn": "arn:aws:payment-cryptography:us-west-2:111122223333:key/jl6ythkcvzesbxen",
"KeyCheckValue": "2E8CD9"
}
```
Untuk informasi selengkapnya, lihat Men [ genkripsi dan mendekripsi data ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/crypto-ops.encryptdecrypt.html) di Panduan *AWS * Pengguna Kriptografi Pembayaran.
+ Untuk detail API, lihat [ ReEncryptData ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/re-encrypt-data.html) di Refer *AWS CLI ensi Perintah*.
### `menerjemahkan-pin-data`
Contoh kode berikut menunjukkan cara menggunakan`translate-pin-data`.
**AWS CLI**
**Untuk menerjemahkan data PIN **
`translate-pin-data`Contoh berikut menerjemahkan PIN dari enkripsi PEK TDES menggunakan blok PIN ISO 0 ke Blok PIN AES ISO 4 menggunakan algoritma DUKPT.
```
aws payment-cryptography-data translate-pin-data \
--encrypted-pin-block {{"AC17DC148BDA645E"}} \
--incoming-translation-attributes=IsoFormat0='{PrimaryAccountNumber=171234567890123}' \
--incoming-key-identifier {{arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt}} \
--outgoing-key-identifier {{arn:aws:payment-cryptography:us-east-2:111122223333:key/4pmyquwjs3yj4vwe}} \
--outgoing-translation-attributes IsoFormat4="{PrimaryAccountNumber=171234567890123}" \
--outgoing-dukpt-attributes KeySerialNumber="FFFF9876543210E00008"
```
Output:
```
{
"PinBlock": "1F4209C670E49F83E75CC72E81B787D9",
"KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/ivi5ksfsuplneuyt
"KeyCheckValue": "7CC9E2"
}
```
Untuk informasi selengkapnya, lihat M [ enerjemahkan data PIN ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/translate-pin-data.html) di *AWS Panduan * Pengguna Kriptografi Pembayaran.
+ Untuk detail API, lihat [ TranslatePinData ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/translate-pin-data.html) di Refer *AWS CLI ensi Perintah*.
### `verify-auth-request-cryptogram`
Contoh kode berikut menunjukkan cara menggunakan`verify-auth-request-cryptogram`.
**AWS CLI**
**Untuk memverifikasi permintaan autentikasi **
`verify-auth-request-cryptogram`Contoh berikut memverifikasi Cryptogram Permintaan Otorisasi (ARQC).
```
aws payment-cryptography-data verify-auth-request-cryptogram \
--auth-request-cryptogram {{F6E1BD1E6037FB3E}} \
--auth-response-attributes '{{{"ArpcMethod1": {"AuthResponseCode": "1111"}}}}' \
--key-identifier {{arn:aws:payment-cryptography:us-west-2:111122223333:key/pboipdfzd4mdklya}} \
--major-key-derivation-mode {{"EMV_OPTION_A"}} \
--session-key-derivation-attributes '{{{"EmvCommon": {"ApplicationTransactionCounter": "1234","PanSequenceNumber": "01","PrimaryAccountNumber": "471234567890123"}}}}' \
--transaction-data {{"123456789ABCDEF"}}
```
Output:
```
{
"AuthResponseValue": "D899B8C6FBF971AA",
"KeyArn": "arn:aws:payment-cryptography:us-west-2:111122223333:key/pboipdfzd4mdklya",
"KeyCheckValue": "985792"
}
```
Untuk informasi selengkapnya, lihat [ Verifikasi kriptogram permintaan autentikasi (ARQC) ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/data-operations.verifyauthrequestcryptogram.html) di Panduan Pengguna Kriptografi Pemb *AWS ayaran. *
+ Untuk detail API, lihat [ VerifyAuthRequestCryptogram ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/verify-auth-request-cryptogram.html) di Refer *AWS CLI ensi Perintah*.
### `Verifikasi data validasi kartu`
Contoh kode berikut menunjukkan cara menggunakan`verify-card-validation-data`.
**AWS CLI**
**Untuk memvalidasi CVV **
`verify-card-validation-data`Contoh berikut memvalidasi a CVV/CVV2 untuk PAN.
```
aws payment-cryptography-data verify-card-validation-data \
--key-identifier {{arn:aws:payment-cryptography:us-east-2:111122223333:key/tqv5yij6wtxx64pi}} \
--primary-account-number=171234567890123 \
--verification-attributes {{CardVerificationValue2={CardExpiryDate=0123}}} \
--validation-data {{801}}
```
Output:
```
{
"KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/tqv5yij6wtxx64pi",
"KeyCheckValue": "CADDA1"
}
```
Untuk informasi selengkapnya, lihat [ Verifikasi data kartu ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-card-data.html) di Panduan * Pengguna Kriptografi Pembayaran. *AWS
+ Untuk detail API, lihat [ VerifyCardValidationData ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/verify-card-validation-data.html) di Refer *AWS CLI ensi Perintah*.
### `verifikasi mac`
Contoh kode berikut menunjukkan cara menggunakan`verify-mac`.
**AWS CLI**
**Untuk memverifikasi MAC **
`verify-mac`Contoh berikut memverifikasi Kode Otentikasi Hash-Based Pesan (HMAC) untuk otentikasi data kartu menggunakan algoritma HMAC\_SHA256 dan kunci enkripsi HMAC.
```
aws payment-cryptography-data verify-mac \
--key-identifier {{arn:aws:payment-cryptography:us-east-2:111122223333:key/qnobl5lghrzunce6}} \
--message-data {{"3b343038383439303031303733393431353d32343038323236303030373030303f33"}} \
--verification-attributes='Algorithm=HMAC_SHA256' \
--mac {{ED87F26E961C6D0DDB78DA5038AA2BDDEA0DCE03E5B5E96BDDD494F4A7AA470C}}
```
Output:
```
{
"KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/qnobl5lghrzunce6,
"KeyCheckValue": "2976E7",
}
```
Untuk informasi selengkapnya, lihat [ Verifikasi MAC ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-mac.html) di Panduan * Pengguna Kriptografi Pembayaran. *AWS
+ Untuk detail API, lihat [ VerifyMac ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/verify-mac.html) di Refer *AWS CLI ensi Perintah*.
### `verifikasi pin-data`
Contoh kode berikut menunjukkan cara menggunakan`verify-pin-data`.
**AWS CLI**
**Untuk memverifikasi PIN **
`verify-pin-data`Contoh berikut memvalidasi PIN untuk PAN.
```
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}} \
--verification-attributes VisaPin="{PinVerificationKeyIndex=1,VerificationValue=5507}" \
--encrypted-pin-block {{AC17DC148BDA645E}}
```
Output:
```
{
"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",
}
```
Untuk informasi selengkapnya, lihat [ Verifikasi data PIN ](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/verify-pin-data.html) di Panduan * Pengguna Kriptografi Pembayaran. *AWS
+ Untuk detail API, lihat [ VerifyPinData ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/payment-cryptography-data/verify-pin-data.html) di Refer *AWS CLI ensi Perintah*.