Spec-Zone.ru › AWS CLI v2

[ aws . payment-cryptography-data ]

generate-card-validation-data

Описание

Генерирует данные проверки карты, используя алгоритмы, такие как значения проверки карты (CVV/CVV2), динамические значения проверки карты (dCVV/dCVV2) или коди карты безопасности (CSC). Для получения дополнительной информации см. Руководство по криптографии платежей Amazon Web Services.

Данный оператор генерирует значение CVV или CSC, которое печатается на платежной кредитной или дебетовой карте во время производства карты. Значение CVV или CSC, PAN (первичный номер счета) и дата истечения срока действия карты необходимы для проверки ее валидности во время обработки транзакции. Для начала этого оператора требуется криптографический ключ CVK (ключ проверки карты). Вы можете использовать CreateKey или ImportKey для создания CVK в Amazon Web Services Payment Cryptography. KeyModesOfUse должно быть установлено на Generate и Verify для ключа шифрования CVK.

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

Использование между учетными записями: Этот оператор не может использоваться между различными учетными записями Amazon Web Services.

Связанные операции:

  • ImportKey
  • VerifyCardValidationData

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

Синтаксис

  generate-card-validation-data
--key-identifier <value>
--primary-account-number <value>
--generation-attributes <value>
[--validation-data-length <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]

Параметры

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

Идентификатор keyARN ключа шифрования CVK, который Amazon Web Services Payment Cryptography использует для генерации данных карты.

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

Первичный номер счета (PAN), уникальный идентификатор платежной кредитной или дебетовой карты, который связывает карту с конкретным держателем счета.

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

Алгоритм генерации значений CVV или CSC для карты в Amazon Web Services Payment Cryptography.

Примечание

Это структура помеченного объединения. Можно установить только один из следующих верхнеуровневых ключей: AmexCardSecurityCodeVersion1, AmexCardSecurityCodeVersion2, CardVerificationValue1, CardVerificationValue2, CardHolderVerificationValue, DynamicCardVerificationCode, DynamicCardVerificationValue.

AmexCardSecurityCodeVersion1 -> (структура)

Параметры данных карты, необходимые для генерации кода безопасности карты (CSC2) для карты AMEX.

CardExpiryDate -> (строка)

Дата истечения срока действия платежной карты.

AmexCardSecurityCodeVersion2 -> (структура)

Параметры данных карты, необходимые для генерации кода безопасности карты (CSC2) для карты AMEX.

CardExpiryDate -> (строка)

Дата истечения срока действия платежной карты.

ServiceCode -> (строка)

Код службы платежной карты AMEX. Он отличается от кода безопасности карты (CSC).

CardVerificationValue1 -> (структура)

Параметры данных карты, необходимые для генерации значения проверки карты (CVV) для платежной карты.

CardExpiryDate -> (строка)

Дата истечения срока действия платежной карты.

ServiceCode -> (строка)

Код службы платежной карты. Он отличается от кода безопасности карты (CSC).

CardVerificationValue2 -> (структура)

Параметры данных карты, необходимые для генерации значения проверки карты (CVV2) для платежной карты.

CardExpiryDate -> (строка)

Дата истечения срока действия платежной карты.

CardHolderVerificationValue -> (структура)

Параметры данных карты, необходимые для генерации значения проверки держателя карты для платежной карты.

UnpredictableNumber -> (строка)

Случайное число, сгенерированное эмитентом.

PanSequenceNumber -> (строка)

Число, которое идентифицирует и различает платежные карты с тем же первичным номером счета (PAN).

ApplicationTransactionCounter -> (строка)

Значение счетчика транзакций, полученное с POS-терминала.

DynamicCardVerificationCode -> (структура)

Параметры данных карты, необходимые для генерации динамического кода проверки карты (dCVC) для платежной карты.

UnpredictableNumber -> (строка)

Случайное число, сгенерированное эмитентом.

PanSequenceNumber -> (строка)

Число, которое идентифицирует и различает платежные карты с тем же первичным номером счета (PAN).

ApplicationTransactionCounter -> (строка)

Значение счетчика транзакций, полученное с терминала.

TrackData -> (строка)

Данные на двух дорожках магнитных карт, используемых для финансовых транзакций. Это включает имя держателя карты, PAN, дату истечения срока действия, идентификатор банка (BIN) и ряд других чисел, используемых банком-эмитентом для проверки полученных данных.

DynamicCardVerificationValue -> (структура)

Параметры данных карты, необходимые для генерации динамического значения проверки карты (dCVV) для платежной карты.

PanSequenceNumber -> (строка)

Число, которое идентифицирует и различает платежные карты с тем же первичным номером счета (PAN).

CardExpiryDate -> (строка)

Дата истечения срока действия платежной карты.

ServiceCode -> (строка)

Код службы платежной карты. Он отличается от кода безопасности карты (CSC).

ApplicationTransactionCounter -> (строка)

Значение счетчика транзакций, полученное с терминала.

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

AmexCardSecurityCodeVersion1={CardExpiryDate=string},AmexCardSecurityCodeVersion2={CardExpiryDate=string,ServiceCode=string},CardVerificationValue1={CardExpiryDate=string,ServiceCode=string},CardVerificationValue2={CardExpiryDate=string},CardHolderVerificationValue={UnpredictableNumber=string,PanSequenceNumber=string,ApplicationTransactionCounter=string},DynamicCardVerificationCode={UnpredictableNumber=string,PanSequenceNumber=string,ApplicationTransactionCounter=string,TrackData=string},DynamicCardVerificationValue={PanSequenceNumber=string,CardExpiryDate=string,ServiceCode=string,ApplicationTransactionCounter=string}

Синтаксис JSON:

{
  "AmexCardSecurityCodeVersion1": {
    "CardExpiryDate": "string"
  },
  "AmexCardSecurityCodeVersion2": {
    "CardExpiryDate": "string",
    "ServiceCode": "string"
  },
  "CardVerificationValue1": {
    "CardExpiryDate": "string",
    "ServiceCode": "string"
  },
  "CardVerificationValue2": {
    "CardExpiryDate": "string"
  },
  "CardHolderVerificationValue": {
    "UnpredictableNumber": "string",
    "PanSequenceNumber": "string",
    "ApplicationTransactionCounter": "string"
  },
  "DynamicCardVerificationCode": {
    "UnpredictableNumber": "string",
    "PanSequenceNumber": "string",
    "ApplicationTransactionCounter": "string",
    "TrackData": "string"
  },
  "DynamicCardVerificationValue": {
    "PanSequenceNumber": "string",
    "CardExpiryDate": "string",
    "ServiceCode": "string",
    "ApplicationTransactionCounter": "string"
  }
}

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

Длина генерируемого значения CVV или CSC. По умолчанию значение равно 3.

--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 (логическое значение)

Включить отладку.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

  • json
  • text
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

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

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

Стиль форматирования для двоичных блоков. По умолчанию используется формат 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 (логическое значение)

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

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы с Руководством пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, подобные правилам Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел «Использование кавычек со строками» в Руководстве пользователя AWS CLI.

Для генерации CVV

Следующий пример генерирует значение 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}

Вывод:

{
    "KeyArn": "arn:aws:payment-cryptography:us-east-2:123456789012:key/kwapwa6qaifllw2h",
    "KeyCheckValue": "CADDA1",
    "ValidationData": "801"
}

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

Вывод

KeyArn -> (строка)

Идентификатор ключа (KeyArn) шифрования CVK, который Amazon Web Services Payment Cryptography использует для генерации CVV или CSC.

KeyCheckValue -> (строка)

Значение контрольной суммы ключа (KCV) ключа шифрования. KCV используется для проверки того, что все стороны, владеющие данным ключом, имеют одинаковый ключ, или для обнаружения изменения ключа.

Amazon Web Services Payment Cryptography вычисляет KCV в соответствии со спецификацией CMAC.

ValidationData -> (строка)

Значение CVV или CSC, сгенерированное Amazon Web Services Payment Cryptography для карты.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API