Модуль cisco.ise.ad_groups_info – Модуль информации об группах Active Directory
Примечание
Данный модуль входит в коллекцию cisco.ise (версия 2.9.3).
Вы, возможно, уже установили эту коллекцию, если используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.ise. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.
Для использования в плейбуке укажите: cisco.ise.ad_groups_info.
Новая в cisco.ise 1.0.0
Обзор
- Получение информации о группах Active Directory по идентификатору.
- Duo-IdentitySync – Получение списка всех групп Active Directory для указанной директории.
Примечание
Данный модуль имеет соответствующий плагин действий.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ciscoisesdk >= 2.2.3
- python >= 3.5
Параметры
Параметр | Комментарии |
|---|---|
activeDirectory строка | Параметр пути ActiveDirectory. Список AD-групп для указанной директории. |
ise_debug логическое | Флаг для SDK Identity Services Engine для включения отладки. Варианты:
|
ise_hostname строка / обязательный | Имя хоста Identity Services Engine. |
ise_password строка / обязательный | Пароль Identity Services Engine для аутентификации. |
ise_single_request_timeout целое число добавлен в cisco.ise 3.0.0 | Таймаут (в секундах) для RESTful HTTP запросов. По умолчанию: |
ise_username строка / обязательный | Имя пользователя Identity Services Engine для аутентификации. |
ise_uses_api_gateway логическое добавлен в cisco.ise 1.1.0 | Флаг, указывающий SDK, использовать ли шлюз API Identity Services Engine для отправки запросов. Если true, используется шлюз API ISE и отправляются запросы по адресу https://{{ise_hostname}}. Если false, запросы отправляются по адресу https://{{ise_hostname}}:{{port}}, где значение порта зависит от используемой службы (ERS, Mnt, UI, PxGrid). Варианты:
|
ise_uses_csrf_token логическое добавлен в cisco.ise 3.0.0 | Флаг, указывающий SDK, отправлять ли токен CSRF в API ISE ERS. Если True, SDK предполагает, что проверка CSRF ISE включена. Если True, предполагается, что SDK должен автоматически управлять токеном CSRF. Варианты:
|
ise_verify логическое | Флаг для включения или отключения проверки сертификатов SSL. Варианты:
|
ise_version строка | Указывает SDK, какую версию Identity Services Engine использовать. По умолчанию: |
ise_wait_on_rate_limit логическое | Флаг для SDK Identity Services Engine для включения автоматической обработки ограничений скорости. Варианты:
|
Примечания
Примечание
- Используемые методы SDK: ad_groups.ADGroups.get_adgroups
- Используемые пути: get /api/v1/duo-identitysync/adgroups/{activeDirectory}
- Поддерживает
check_mode - Плагин выполняется на контрольном узле и не использует плагины подключения Ansible, а вместо этого встроенный менеджер подключений Cisco ISE SDK
- Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления соединения
Примеры
- name: Get Ad Groups Info by id
cisco.ise.ad_groups_info:
ise_hostname: "{{ise_hostname}}"
ise_username: "{{ise_username}}"
ise_password: "{{ise_password}}"
ise_verify: "{{ise_verify}}"
activeDirectory: string
register: result
Значения возврата
Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:
Ключ | Описание |
|---|---|
ise_response список / элементы=словарь | Словарь или список с ответом, возвращенным Cisco ISE Python SDK Возвращаемое значение: всегда Пример: |
Ссылки на сборку
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/ise/ad_groups_info_module.html