Spec-Zone.ru › Ansible

Модуль dellemc.openmanage.ome_active_directory — настройка групп Active Directory для использования со службами каталогов

Примечание

Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install dellemc.openmanage. Для работы с этим модулем требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: dellemc.openmanage.ome_active_directory.

Добавлено в dellemc.openmanage 4.0.0

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Этот модуль позволяет добавлять, изменять и удалять подключение OpenManage Enterprise к службе Active Directory.

Требования

На хосте, где выполняется этот модуль, должны быть соблюдены следующие требования.

  • python >= 3.9.6

Параметры

Параметр

Комментарии

ca_path

путь

добавлено в dellemc.openmanage 5.0.0

Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки.

certificate_file

путь

Укажите полный путь к сертификату SSL.

Сертификат должен быть корневым сертификатом CA в кодировке Base64.

Применяется, если validate_certificate имеет значение true.

domain_controller_lookup

строка

Выберите способ поиска контроллера домена.

Варианты:

  • "DNS" ← (по умолчанию)
  • "MANUAL"

domain_controller_port

целое число

Порт контроллера домена.

По умолчанию указан номер порта адреса глобального каталога 3269.

Для доступа к контроллеру домена укажите номер порта 636.

NOTE Поддерживаются только порты LDAPS.

По умолчанию: 3269

domain_password

строка

Укажите пароль домена.

Применяется, если test_connection имеет значение true.

domain_server

список / элементы=строка

Укажите доменное имя, FQDN или IP-адрес контроллера домена.

Если domain_controller_lookup имеет значение DNS, укажите доменное имя, чтобы выполнить DNS-запрос для поиска контроллеров домена.

Если domain_controller_lookup имеет значение MANUAL, укажите FQDN или IP-адрес контроллера домена. Можно добавить не более трех серверов Active Directory.

domain_username

строка

Укажите имя пользователя домена в формате UPN (username@domain) или NetBIOS (domain\\username).

Применяется, если test_connection имеет значение true.

group_domain

строка

Укажите домен группы в формате example.com или ou=org, dc=example, dc=com.

hostname

строка / обязательный

IP-адрес или имя хоста OpenManage Enterprise либо OpenManage Enterprise Modular.

id

целое число

Укажите идентификатор существующего подключения службы Active Directory.

Применяется при изменении и удалении.

Взаимоисключающий параметр с name.

name

строка

Укажите имя подключения Active Directory.

Применяется при создании и удалении.

Взаимоисключающий параметр с name.

network_timeout

целое число

Укажите длительность тайм-аута сети в секундах.

Допустимый диапазон длительности тайм-аута — от 15 до 300 секунд.

По умолчанию: 120

password

строка

Пароль OpenManage Enterprise или OpenManage Enterprise Modular.

Если пароль не указан, используется переменная среды OME_PASSWORD.

Пример: export OME_PASSWORD=password

port

целое число

HTTPS-порт OpenManage Enterprise или OpenManage Enterprise Modular.

По умолчанию: 443

search_timeout

целое число

Укажите длительность тайм-аута поиска в секундах.

Допустимый диапазон длительности тайм-аута — от 15 до 300 секунд.

По умолчанию: 120

state

строка

present позволяет создать или изменить службу Active Directory.

absent позволяет удалить службу Active Directory.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

test_connection

логическое значение

Включает проверку подключения к контроллеру домена.

Подключение к контроллеру домена проверяется с использованием указанных сведений о службе Active Directory.

Если проверка завершится неудачно, модуль сообщит об ошибке.

Если true, необходимо указать domain_username и domain_password.

Варианты:

  • false ← (по умолчанию)
  • true

timeout

целое число

добавлено в dellemc.openmanage 5.0.0

Тайм-аут на уровне сокета в секундах.

По умолчанию: 30

username

строка

Имя пользователя OpenManage Enterprise или OpenManage Enterprise Modular.

Если имя пользователя не указано, используется переменная среды OME_USERNAME.

Пример: export OME_USERNAME=username

validate_certificate

логическое значение

Включает проверку SSL-сертификата контроллера домена.

Если параметр имеет значение true, модуль всегда сообщает об изменении.

Варианты:

  • false ← (по умолчанию)
  • true

validate_certs

логическое значение

добавлено в dellemc.openmanage 5.0.0

Если false, SSL-сертификаты проверяться не будут.

Настраивайте false только на сайтах, находящихся под вашим контролем, где используются самозаверяющие сертификаты.

До версии коллекции 5.0.0 параметр validate_certs по умолчанию имел значение false.

Варианты:

  • false
  • true ← (по умолчанию)

x_auth_token

строка

добавлено в dellemc.openmanage 9.3.0

Токен аутентификации.

Если x_auth_token не указан, используется переменная среды OME_X_AUTH_TOKEN.

Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

  • Если validate_certificate имеет значение true, модуль всегда сообщает об изменении.
  • Запускайте этот модуль в системе, имеющей прямой доступ к OpenManage Enterprise.
  • Этот модуль поддерживает check_mode.

Примеры

---
- name: Add Active Directory service using DNS lookup along with the test connection
  dellemc.openmanage.ome_active_directory:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    name: my_ad1
    domain_server:
      - domainname.com
    group_domain: domainname.com
    test_connection: true
    domain_username: user@domainname
    domain_password: domain_password

- name: Add Active Directory service using IP address of the domain controller with certificate validation
  dellemc.openmanage.ome_active_directory:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    name: my_ad2
    domain_controller_lookup: MANUAL
    domain_server:
      - 192.68.20.181
    group_domain: domainname.com
    validate_certificate: true
    certificate_file: "/path/to/certificate/file.cer"

- name: Modify domain controller IP address, network_timeout and group_domain
  dellemc.openmanage.ome_active_directory:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    name: my_ad2
    domain_controller_lookup: MANUAL
    domain_server:
      - 192.68.20.189
    group_domain: newdomain.in
    network_timeout: 150

- name: Delete Active Directory service
  dellemc.openmanage.ome_active_directory:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    name: my_ad2
    state: absent

- name: Test connection to existing Active Directory service with certificate validation
  dellemc.openmanage.ome_active_directory:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    name: my_ad2
    test_connection: true
    domain_username: user@domainname
    domain_password: domain_password
    validate_certificate: true
    certificate_file: "/path/to/certificate/file.cer"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

active_directory

словарь

Служба Active Directory, добавленная, измененная или удаленная этим модулем.

Возвращается: при изменении

Пример: {"CertificateValidation": false, "DnsServer": [], "GroupDomain": "dellemcdomain.com", "Id": 21789, "Name": "ad_test", "NetworkTimeOut": 120, "Password": null, "SearchTimeOut": 120, "ServerName": ["192.168.20.181"], "ServerPort": 3269, "ServerType": "MANUAL"}

error_info

словарь

Сведения об ошибке HTTP.

Возвращается: при ошибке HTTP

Пример: {"error_info": {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to connect to the LDAP or AD server because the entered credentials are invalid.", "MessageArgs": [], "MessageId": "CSEC5002", "RelatedProperties": [], "Resolution": "Make sure the server input configuration are valid and retry the operation.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}}

msg

строка

Общий статус операции Active Directory.

Возвращается: всегда

Пример: "Successfully renamed the slot(s)."

Авторы

  • Jagadeesh N V(@jagadeeshnv)
  • Bhavneet Sharma (@Bhavneet-Sharma)

Ссылки на коллекцию

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/openmanage/ome_active_directory_module.html

Spec-Zone.ru

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