put-application-grant

Описание

Создаёт конфигурацию для использования грантов приложением. По сути, гранты — это разрешения на запрос действий, связанных с токенами. Эта конфигурация будет использована, когда стороны запрашивают и получают токены в процессе распространения доверенной идентификации. Для получения дополнительной информации о поддерживаемых IAM Identity Center рабочих процессах с грантами см. SAML 2.0 и OAuth 2.0 .

Грант создаётся между вашими приложениями и экземпляром Identity Center, что позволяет приложению использовать указанные механизмы для получения токенов. Эти токены используются вашими приложениями для получения доступа к ресурсам Amazon Web Services от имени пользователей. Следующие элементы участвуют в этих обменах:

• Запрашивающее приложение - приложение, запрашивающее доступ к ресурсам Amazon Web Services.
• Субъект - обычно пользователь, запрашивающий доступ к ресурсам Amazon Web Services.
• Грант - по сути, грант — это разрешение на доступ к ресурсам Amazon Web Services. Эти гранты разрешают создание токенов для аутентификации доступа запрашивающего приложения и для запроса доступа от имени субъектов. Существует четыре типа грантов:
  • AuthorizationCode - позволяет приложению запросить авторизацию через серию перенаправлений пользовательского агента.
  • JWT bearer - разрешает приложению обменять JSON Web Token, полученный от внешнего поставщика удостоверений. Подробнее см. RFC 6479 .
  • Refresh token - позволяет приложению запросить новые токены доступа для замены истекающих или истекших токенов доступа.
  • Exchange token - грант, который запрашивает токены у сервера авторизации, предоставив токен «субъекта» с областью доступа, разрешающей распространение доверенной идентификации в это приложение. Подробнее см. RFC 8693 .
• Сервер авторизации - IAM Identity Center запрашивает токены.

Данные учетных данных пользователей никогда не передаются напрямую в этих обменах. Вместо этого приложения используют гранты для запроса токенов доступа у IAM Identity Center. Дополнительную информацию см. в RFC 6479 .

• Подключение к пользовательским приложениям.
• Настройка сервиса Amazon Web Services для выполнения вызовов к другим сервисам Amazon Web Services с использованием токенов JWT.

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

Синопсис

  put-application-grant
--application-arn <value>
--grant-type <value>
--grant <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]

Параметры

--application-arn (строка)

--grant-type (строка)

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

Синтаксис JSON:

{
  "AuthorizationCode": {
    "RedirectUris": ["string", ...]
  },
  "JwtBearer": {
    "AuthorizedTokenIssuers": [
      {
        "TrustedTokenIssuerArn": "string",
        "AuthorizedAudiences": ["string", ...]
      }
      ...
    ]
  },
  "RefreshToken": {

  },
  "TokenExchange": {

  }
}

--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
• table
• yaml
• yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

• on
• off
• auto

--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.

Вывод

Нет