generate-pin-data

Описание

Генерирует данные, связанные с PIN-кодом, такие как PIN, значение проверки PIN (PVV), блок PIN и смещение PIN при выпуске или повторном выпуске новой карты. Дополнительную информацию см. в руководстве пользователя Amazon Web Services Payment Cryptography раздел «Генерация данных PIN».

Данные PIN никогда не передаются в открытом виде в Amazon Web Services Payment Cryptography. Данный операция генерирует PIN, PVV или смещение PIN, а затем шифрует его с помощью ключа шифрования PIN (PEK), чтобы создать EncryptedPinBlock для передачи от Amazon Web Services Payment Cryptography. Для генерации PVV для VISA используется отдельный ключ проверки PIN (PVK).

С помощью обмена ключами ECDH вы можете получать выбираемые держателем карты PIN-коды в Amazon Web Services Payment Cryptography. Полученный с помощью ECDH ключ защищает входящий блок PIN. Вы также можете использовать его для отображения PIN-кода, в котором сгенерированный блок PIN защищен с помощью ключа, полученного с помощью ECDH, перед передачей от Amazon Web Services Payment Cryptography. Дополнительную информацию о настройке ключей, полученных с помощью ECDH, см. в руководстве пользователя Amazon Web Services Payment Cryptography в разделе «Генерация ключей».

Сведения о допустимых ключах для данной операции см. в руководстве пользователя Amazon Web Services Payment Cryptography в разделе «Понимание атрибутов ключей и типов ключей для конкретных операций с данными».

• GenerateCardValidationData
• TranslatePinData
• VerifyPinData

См. также: Документацию API AWS

Синтаксис

  generate-pin-data
--generation-key-identifier <value>
--encryption-key-identifier <value>
--generation-attributes <value>
[--pin-data-length <value>]
--primary-account-number <value>
--pin-block-format <value>
[--encryption-wrapped-key <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--generation-key-identifier (строка)

--encryption-key-identifier (строка)

--generation-attributes (структура помеченных союзов)

Сокращенный синтаксис:

VisaPin={PinVerificationKeyIndex=integer},VisaPinVerificationValue={EncryptedPinBlock=string,PinVerificationKeyIndex=integer},Ibm3624PinOffset={EncryptedPinBlock=string,DecimalizationTable=string,PinValidationDataPadCharacter=string,PinValidationData=string},Ibm3624NaturalPin={DecimalizationTable=string,PinValidationDataPadCharacter=string,PinValidationData=string},Ibm3624RandomPin={DecimalizationTable=string,PinValidationDataPadCharacter=string,PinValidationData=string},Ibm3624PinFromOffset={DecimalizationTable=string,PinValidationDataPadCharacter=string,PinValidationData=string,PinOffset=string}

Синтаксис JSON:

{
  "VisaPin": {
    "PinVerificationKeyIndex": integer
  },
  "VisaPinVerificationValue": {
    "EncryptedPinBlock": "string",
    "PinVerificationKeyIndex": integer
  },
  "Ibm3624PinOffset": {
    "EncryptedPinBlock": "string",
    "DecimalizationTable": "string",
    "PinValidationDataPadCharacter": "string",
    "PinValidationData": "string"
  },
  "Ibm3624NaturalPin": {
    "DecimalizationTable": "string",
    "PinValidationDataPadCharacter": "string",
    "PinValidationData": "string"
  },
  "Ibm3624RandomPin": {
    "DecimalizationTable": "string",
    "PinValidationDataPadCharacter": "string",
    "PinValidationData": "string"
  },
  "Ibm3624PinFromOffset": {
    "DecimalizationTable": "string",
    "PinValidationDataPadCharacter": "string",
    "PinValidationData": "string",
    "PinOffset": "string"
  }
}

--pin-data-length (целое число)

--primary-account-number (строка)

--pin-block-format (строка)

--encryption-wrapped-key (структура)

Сокращенный синтаксис:

WrappedKeyMaterial={Tr31KeyBlock=string,DiffieHellmanSymmetricKey={CertificateAuthorityPublicKeyIdentifier=string,PublicKeyCertificate=string,KeyAlgorithm=string,KeyDerivationFunction=string,KeyDerivationHashAlgorithm=string,SharedInformation=string}},KeyCheckValueAlgorithm=string

Синтаксис JSON:

{
  "WrappedKeyMaterial": {
    "Tr31KeyBlock": "string",
    "DiffieHellmanSymmetricKey": {
      "CertificateAuthorityPublicKeyIdentifier": "string",
      "PublicKeyCertificate": "string",
      "KeyAlgorithm": "TDES_2KEY"|"TDES_3KEY"|"AES_128"|"AES_192"|"AES_256",
      "KeyDerivationFunction": "NIST_SP800"|"ANSI_X963",
      "KeyDerivationHashAlgorithm": "SHA_256"|"SHA_384"|"SHA_512",
      "SharedInformation": "string"
    }
  },
  "KeyCheckValueAlgorithm": "CMAC"|"ANSI_X9_24"
}

--cli-input-json | --cli-input-yaml (строка) Чтение аргументов из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет взята дословно. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Вывод скелета JSON в стандартный вывод без отправки запроса API. Если предоставлено значение или значение input, выводится пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, будет выведен пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, будет выполнена проверка входных данных команд и возвращен пример выходного JSON для этой команды. Сгенерированный скелет JSON не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном скелете JSON.

Глобальные параметры

--debug (boolean)

Включить отладку логирования.

--endpoint-url (string)

Переопределить URL по умолчанию команды на предоставленный URL.

--no-verify-ssl (boolean)

По умолчанию, AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команд.

• json
• text
• table
• yaml
• yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определенный профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/отключить цветной вывод.

• включено
• выключено
• автоматически

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет рассматриваться как двоичное и будет использоваться содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для конфигурированного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (boolean)

Отключить вывод страницы AWS CLI.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запроса параметров ввода CLI.

Примеры

Для генерации PIN-кода

Следующий generate-card-validation-data пример генерирует новый случайный PIN-код, используя схему Visa PIN.

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}

Вывод:

{
    "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"
    }
}

Дополнительную информацию см. в разделе Генерация данных PIN в Руководстве пользователя по криптографии платежей AWS.

Вывод

GenerationKeyArn -> (строка)

GenerationKeyCheckValue -> (строка)

EncryptionKeyArn -> (строка)

EncryptionKeyCheckValue -> (строка)

EncryptedPinBlock -> (строка)

PinData -> (структура помеченного объединения)