dellemc.openmanage.idrac_user модуль — Настройка параметров учетных записей пользователей

Примечание

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

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

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

Для использования в плейбуке укажите: dellemc.openmanage.idrac_user.

Новое в dellemc.openmanage 2.1.0

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

Обзор

Этот модуль позволяет выполнять следующие действия:
Добавить новую учетную запись пользователя.
Редактировать учетную запись пользователя.
Включить или отключить учетную запись пользователя.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
authentication_protocol строка	Этот параметр позволяет настроить один из следующих типов протоколов аутентификации для аутентификации пользователя iDRAC. Алгоритм хеширования Secure Hash `SHA`. Message Digest 5 `MD5`. Протокол аутентификации не настроен, если `None` выбран. Варианты: `"None"` `"SHA"` `"MD5"`
ca_path путь добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, используемый для проверки.
custom_privilege целое число добавлено в dellemc.openmanage 8.1.0	Уровень привилегий, назначенный пользователю.
enable булево	Предоставляет возможность включить или отключить пользователя для входа в iDRAC. Варианты: `false` `true`
idrac_ip строка / обязательно	IP-адрес iDRAC.
idrac_password псевдонимы: idrac_pwd строка	Пароль пользователя iDRAC. Если пароль не указан, используется переменная окружения `IDRAC_PASSWORD`. Пример: export IDRAC_PASSWORD=пароль
idrac_port целое число	Порт iDRAC. Значение по умолчанию: `443`
idrac_user строка	Имя пользователя iDRAC. Если имя пользователя не указано, используется переменная окружения `IDRAC_USERNAME`. Пример: export IDRAC_USERNAME=имя_пользователя
ipmi_lan_privilege строка	Уровень привилегий LAN Intelligent Platform Management Interface, назначенный пользователю. Варианты: `"Administrator"` `"Operator"` `"User"` `"No Access"`
ipmi_serial_privilege строка	Уровень привилегий последовательного порта Intelligent Platform Management Interface, назначенный пользователю. Этот параметр применим только для серверов rack и tower. Варианты: `"Administrator"` `"Operator"` `"User"` `"No Access"`

END_OF_DOCUMENT_MARKER

user_name строка / обязательно	Укажите имя пользователя учетной записи, которую нужно создать, удалить или изменить.
user_password строка	Укажите пароль для учетной записи пользователя. Пароль можно изменить при изменении учетной записи пользователя. Для обеспечения безопасности user_password должен содержать не менее восьми символов и включать строчные и прописные буквы, цифры и специальные символы.
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 не указан, используется переменная среды `IDRAC_X_AUTH_TOKEN`. Пример: export IDRAC_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Запускайте этот модуль с системы, имеющей прямой доступ к Dell iDRAC.
Этот модуль поддерживает check_mode.

Примеры

---
- name: Configure a new iDRAC user
  dellemc.openmanage.idrac_user:
    idrac_ip: 198.162.0.1
    idrac_user: idrac_user
    idrac_password: idrac_password
    ca_path: "/path/to/ca_cert.pem"
    state: present
    user_name: user_name
    user_password: user_password
    privilege: Administrator
    ipmi_lan_privilege: Administrator
    ipmi_serial_privilege: Administrator
    enable: true
    sol_enable: true
    protocol_enable: true
    authentication_protocol: SHA
    privacy_protocol: AES

- name: Modify existing iDRAC user username and password
  dellemc.openmanage.idrac_user:
    idrac_ip: 198.162.0.1
    idrac_user: idrac_user
    idrac_password: idrac_password
    ca_path: "/path/to/ca_cert.pem"
    state: present
    user_name: user_name
    new_user_name: new_user_name
    user_password: user_password

- name: Delete existing iDRAC user account
  dellemc.openmanage.idrac_user:
    idrac_ip: 198.162.0.1
    idrac_user: idrac_user
    idrac_password: idrac_password
    ca_path: "/path/to/ca_cert.pem"
    state: absent
    user_name: user_name

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

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

Ключ	Описание
error_info словарь	Подробности HTTP-ошибки. Возвращается: при HTTP-ошибке Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "Retry the operation. If the issue persists, contact your system administrator.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
msg строка	Статус конфигурации пользователя iDRAC. Возвращается: всегда Пример: `"Successfully created user account details."`
status словарь	Настраивает атрибуты пользователей iDRAC. Возвращается: успех Пример: {"@Message.ExtendedInfo": [{"Message": "Successfully Completed Request", "MessageArgs": [], "MessageArgs@odata.count": 0, "MessageId": "Base.1.5.Success", "RelatedProperties": [], "RelatedProperties@odata.count": 0, "Resolution": "None", "Severity": "OK"}, {"Message": "The operation successfully completed.", "MessageArgs": [], "MessageArgs@odata.count": 0, "MessageId": "IDRAC.2.1.SYS413", "RelatedProperties": [], "RelatedProperties@odata.count": 0, "Resolution": "No response action is required.", "Severity": "Informational"}]}

Авторы

Felix Stephen (@felixs88)

Ссылки на сборку

© 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/dellemc/openmanage/idrac_user_module.html