Модуль cisco.ise.active_directory_join_domain — Модуль ресурсов для присоединения к домену Active Directory
Примечание
Этот модуль является частью коллекции cisco.ise (версия 2.9.3).
Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.ise. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.
Для использования в книге задач укажите: cisco.ise.active_directory_join_domain.
Новый в cisco.ise 1.0.0
Обзор
- Управление обновлением операции ресурса Присоединение к домену Active Directory.
- Этот API присоединяет узел Cisco ISE к домену Active Directory.
Примечание
Данный модуль имеет соответствующий плагин действия.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- ciscoisesdk >= 2.2.3
- python >= 3.5
Параметры
Параметр | Комментарии |
|---|---|
additionalData список / элементы=словарь | Дополнительные данные Присоединения к домену Active Directory. |
|
name строка |
Имя Присоединения к домену Active Directory. |
|
value строка |
Значение Присоединения к домену Active Directory. |
id строка | Параметр пути id. |
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 ERS ISE. Если значение True, SDK предполагает, что проверка CSRF вашего ISE включена. Если значение True, предполагается, что SDK должен автоматически управлять маркером CSRF. Варианты:
|
ise_verify логический тип | Флаг для включения или отключения проверки сертификата SSL. Варианты:
|
ise_version строка | Сообщает SDK, какую версию Identity Services Engine использовать. По умолчанию: |
ise_wait_on_rate_limit логический тип | Флаг для Identity Services Engine SDK для включения автоматической обработки ограничения скорости. Варианты:
|
Примечания
Примечание
- Используемые методы SDK: active_directory.ActiveDirectory.join_domain,
- Используемые пути: put /ers/config/activedirectory/{id}/join,
- Не поддерживает
check_mode - Плагин работает на узле управления и не использует плагины подключения Ansible, а вместо этого встроенный менеджер подключений из Cisco ISE SDK
- Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления подключения
Примеры
- name: Update all
cisco.ise.active_directory_join_domain:
ise_hostname: "{{ise_hostname}}"
ise_username: "{{ise_username}}"
ise_password: "{{ise_password}}"
ise_verify: "{{ise_verify}}"
additionalData:
- name: username
value: Required. The domain user to use
- name: password
value: Required. The domain user's password
- name: node
value: Required. The name of the ISE node to join the domain. The node names can
be retrieved with the "Node Details/Get All" ERS operation
- name: orgunit
value: Optional. The organizational unit in AD where the machine object for the
joined ISE will be stored.
id: string
Значения возврата
Общие значения возврата документированы здесь, следующие — поля, уникальные для данного модуля:
Ключ | Описание |
|---|---|
ise_response словарь | Словарь или список с ответом, возвращаемым Python SDK Cisco ISE Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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/active_directory_join_domain_module.html