Spec-Zone.ru › Ansible

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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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

string

Этот параметр позволяет настроить один из следующих типов протокола аутентификации для проверки подлинности пользователя iDRAC.

Алгоритм безопасного хеширования SHA. Не применяется к iDRAC10.

Message Digest 5 MD5. Не применяется к iDRAC10.

Алгоритм безопасного хеширования, 384 бита SHA-384. Применяется только к iDRAC10.

Алгоритм безопасного хеширования, 512 бит SHA-512. Применяется только к iDRAC10.

Протокол аутентификации не настраивается, если выбран None.

Варианты:

  • "None"
  • "SHA"
  • "MD5"
  • "SHA-384"
  • "SHA-512"

ca_path

path

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

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

custom_privilege

integer

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

Уровень привилегий, назначаемый пользователю.

Для iDRAC10 минимальное значение — 1.

custom_role_name

string

Параметр custom_role_name обязателен для iDRAC10 при создании пользователя с использованием пользовательской роли для iDRAC10.

enable

boolean

Позволяет включить или отключить возможность входа пользователя в iDRAC.

Варианты:

  • false
  • true

idrac_ip

string / обязательный

IP-адрес iDRAC.

idrac_password

псевдонимы: idrac_pwd

string

Пароль пользователя iDRAC.

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

Пример: export IDRAC_PASSWORD=password

idrac_port

integer

Порт iDRAC.

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

idrac_user

string

Имя пользователя iDRAC.

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

Пример: export IDRAC_USERNAME=username

ipmi_lan_privilege

string

Уровень привилегий Intelligent Platform Management Interface LAN, назначаемый пользователю.

Варианты:

  • "Administrator"
  • "Operator"
  • "User"
  • "No Access"

ipmi_serial_privilege

string

Уровень привилегий порта Serial Intelligent Platform Management Interface, назначаемый пользователю.

Этот параметр применим только к серверам в корпусе и башенным серверам.

Варианты:

  • "Administrator"
  • "Operator"
  • "User"
  • "No Access"

new_user_name

string

Укажите user_name учетной записи, которую необходимо изменить.

privacy_protocol

string

Этот параметр позволяет настроить один из следующих протоколов шифрования конфиденциальности для пользователя iDRAC.

Стандарт шифрования данных DES. Не применяется к iDRAC10.

Расширенный стандарт шифрования AES. Не применяется к iDRAC10.

Расширенный стандарт шифрования, 256 бит AES-256. Применяется только к iDRAC9 и iDRAC10.

Протокол конфиденциальности не настраивается, если выбран None.

Варианты:

  • "None"
  • "DES"
  • "AES"
  • "AES-256"

privilege

псевдонимы: role

string

Ниже перечислены привилегии на основе ролей.

Пользователь с привилегией Administrator может войти в iDRAC, а затем настраивать iDRAC и пользователей, очищать журналы, управлять системой и настраивать ее, получать доступ к виртуальной консоли и виртуальным носителям, проверять оповещения и выполнять команды отладки.

Пользователь с привилегией Operator может войти в iDRAC, а затем настраивать iDRAC, управлять системой и настраивать ее, получать доступ к виртуальной консоли и виртуальным носителям, а также выполнять команды отладки.

Пользователь с привилегией ReadOnly может только войти в iDRAC.

У пользователя с привилегией None нет назначенных привилегий. Не применяется к iDRAC10.

Игнорируется, если указан параметр custom_privilege.

Варианты:

  • "Administrator"
  • "ReadOnly"
  • "Operator"
  • "None"

protocol_enable

boolean

Включает протокол для пользователя iDRAC.

Варианты:

  • false
  • true

sol_enable

boolean

Включает Serial Over LAN (SOL) для пользователя iDRAC.

Варианты:

  • false
  • true

state

string

Выберите present, чтобы создать или изменить учетную запись пользователя.

Выберите absent, чтобы удалить учетную запись пользователя.

Варианты:

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

timeout

integer

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

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

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

user_name

string / обязательный

Укажите user_name учетной записи, которую необходимо создать, удалить или изменить.

user_password

string

Укажите пароль учетной записи пользователя. Пароль можно изменить при изменении учетной записи пользователя.

В целях безопасности длина user_password должна составлять не менее восьми символов; пароль должен содержать строчные и прописные буквы, цифры и специальные символы.

validate_certs

boolean

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

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

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

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

Варианты:

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

x_auth_token

string

добавлено в 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

dictionary

Сведения об ошибке 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

string

Состояние конфигурации пользователя iDRAC.

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

Пример: "Successfully created user account details."

status

dictionary

Настраивает атрибуты пользователей 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)
  • Kritika Bhateja (@Kritika-Bhateja-03)

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

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

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

Spec-Zone.ru

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