Как использовать apigee-ssoadminapi.sh

Модуль Apigee SSO поддерживает два типа аккаунтов:

Утилита apigee-ssoadminapi.sh позволяет управлять аккаунтами администратора и пользователя компьютера, связанными с модулем Apigee SSO.

Используйте утилиту apigee-ssoadminapi.sh, чтобы:

  • Просмотр списка администраторов и пользователей компьютеров
  • Добавление и удаление администраторов и пользователей компьютеров
  • Изменение пароля администратора или пользователя компьютера

Администраторы

Для управления свойствами модуля SSO Apigee требуется аккаунт администратора.

По умолчанию при установке модуля Apigee SSO создается аккаунт администратора со следующими учетными данными:

  • username – определяется свойством SSO_ADMIN_NAME в файле конфигурации, который используется для настройки модуля системы единого входа Apigee. Значение по умолчанию – ssoadmin..
  • password – определяется свойством SSO_ADMIN_SECRET в файле конфигурации, который используется для настройки модуля системы единого входа Apigee.

О пользователях компьютеров

Пользователь-машина может получить токены OAuth2 без указания кода доступа. Это означает, что вы можете полностью автоматизировать процесс получения и обновления токенов OAuth2 с помощью Edge Management API.

Обычно пользователи-машины используются для:

  • Настройка портала Apigee Developer Services (или просто портала) для связи с Edge.
  • Когда среда разработки поддерживает автоматизацию распространенных задач, таких как автоматизация тестирования или непрерывная интеграция и доставка.

Подробнее о том, как автоматизировать задачи для внешних поставщиков идентификационной информации…

Установка apigee-ssoadminapi.sh

Установите утилиту apigee-ssoadminapi.sh на узел сервера управления Edge, на котором вы установили модуль Apigee SSO. Обычно утилита apigee-ssoadminapi.sh устанавливается вместе с модулем Apigee SSO.

Если вы ещё не установили утилиту apigee-ssoadminapi.sh:

  1. Войдите в узел сервера управления. На этом узле уже должна быть установлена утилита apigee-service, как описано в разделе Как установить утилиту apigee-setup для Edge.
  2. Установите утилиту apigee-ssoadminapi.sh, которая используется для управления администраторами и пользователями компьютеров в модуле системы единого входа Apigee. Для этого выполните следующую команду: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-ssoadminapi install
  3. Выйдите из оболочки и снова войдите в нее, чтобы добавить утилиту apigee-ssoadminapi.sh в путь.

Просмотр справочной информации для apigee-ssoadminapi.sh

Для утилиты доступны следующие команды:

  • admin add
  • admin delete
  • admin list
  • admin setpassword
  • saml machineuser add (используйте команду saml для всех поставщиков идентификационной информации, включая LDAP и SAML)
  • saml machineuser delete
  • aaml machineuser list
  • saml machineuser setpassword

Информацию об этих командах можно найти в файле /opt/apigee/apigee-ssoadminapi/README.md. Кроме того, вы можете добавить параметр "-h" к каждой команде, чтобы посмотреть информацию об использовании.

Например, следующая команда:

apigee-ssoadminapi.sh admin list -h

Возврат:

admin list
  --admin SSOADMIN_CLIENT_NAME      Name of the client having administrative privilege on sso
  --secret SSOADMIN_CLIENT_SECRET   Secret/Password for the client
  --host SSO_HOST                   Hostname of SSO server to connect
  --port SSO_PORT                   Port to use during request
  --ssl SSO_URI_SCHEME              Set to https, defaults to http
  --debug                           Set in debug mode, turns on verbose in curl
  -h                                Displays Help

Вызов утилиты apigee-ssoadminapi.sh

Вы можете вызвать утилиту apigee-ssoadminapi.sh, передав все свойства в качестве аргументов командной строки, или в интерактивном режиме, отвечая на запросы.

Например, чтобы указать в командной строке всю необходимую информацию для просмотра списка администраторов, введите:

apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123 --host 35.197.94.184

Возврат:

[
  {
    "client_id": "ssoadmin",
    "access_token_validity": 300
  }
]

Если вы не укажете обязательную информацию, например пароль администратора, появится запрос.

В этом примере вы опускаете значения для --port и --ssl, поскольку модуль Apigee SSO использует значения по умолчанию: 9099 для --port и http для --ssl. Если в вашей установке не используются эти значения по умолчанию, укажите их:

apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123
  --host 35.197.94.184 --port 9443 --ssl https

Вы также можете воспользоваться интерактивной формой, в которой вам будет предложено указать всю необходимую информацию:

apigee-ssoadminapi.sh admin list

Затем вам будет предложено указать всю необходимую информацию:

SSO admin name (current): ssoadmin
SSO Admin secret (current):
SSO host: 35.197.94.184