модуль cisco.intersight.intersight_local_user_policy — настройка политики локальных пользователей для Cisco Intersight
Примечание
Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.intersight.
Чтобы использовать модуль в плейбуке, укажите: cisco.intersight.intersight_local_user_policy.
Краткое описание
- Настройка политики локальных пользователей для Cisco Intersight.
- Используется для настройки локальных пользователей на конечных устройствах.
- Дополнительные сведения см. в документации Cisco Intersight.
Параметры
Параметр | Комментарии |
|---|---|
always_update_password boolean | Поскольку API не возвращает пароли, а на конечном устройстве они хранятся в зашифрованном виде, этот параметр указывает модулю, когда следует менять пароль. Если значение равно true, пароль каждого пользователя будет обновляться в политике всегда. Если значение равно false, пароль будет обновляться только при создании пользователя. Варианты:
|
api_key_id string / обязательный | Идентификатор открытого API-ключа, связанного с закрытым ключом. Если значение не задано, используется значение переменной окружения INTERSIGHT_API_KEY_ID. |
api_private_key path / обязательный | Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM для аутентификации в API Intersight. Если используется строка, для шифрования строковых данных следует применять Ansible Vault. Например: ansible-vault encrypt_string --vault-id tme@/Users/dsoper/Documents/vault_password_file ‘-----BEGIN EC PRIVATE KEY----- <your private key data> -----END EC PRIVATE KEY-----’ Если значение не задано, используется значение переменной окружения INTERSIGHT_API_PRIVATE_KEY. |
api_uri string | URI для доступа к API Intersight. Если значение не задано, используется значение переменной окружения INTERSIGHT_API_URI. По умолчанию: |
description псевдонимы: descr string | Описание политики локальных пользователей, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или символ подчеркивания (_). |
enable_password_expiry boolean | Включает срок действия пароля на конечном устройстве. Варианты:
|
enforce_strong_password boolean | Если значение равно true, включается политика надежных паролей. Требования к надежному паролю:
Варианты:
|
local_users list / элементы=dictionary | Список локальных пользователей на конечном устройстве. На конечном устройстве уже существует пользователь admin. Добавляйте пользователя admin сюда, только если требуется изменить пароль или включить либо отключить пользователя. Чтобы добавить пользователя admin, укажите имя пользователя ‘admin’, выберите роль администратора, а затем продолжите. |
|
account_types list / элементы=any |
Список типов учетных записей, назначаемых пользователю. Поддерживаются значения Для обеспечения обратной совместимости по-прежнему принимаются записи словаря с Если указаны эти значения, модуль сопоставляет их с соответствующими типами объектов API Intersight и не задает отдельное поле переключателя типа учетной записи. Используйте этот параметр, чтобы запросить доступ IPMI или комбинированный доступ к локальной учетной записи и IPMI, сохранив тип роли конечного устройства |
|
enable boolean |
Включить или отключить пользователя. Варианты:
|
|
endpoint_role_type string |
Тип роли конечного устройства, назначаемой пользователю. IMC — поддерживаемый тип роли управления сервером для ролей локальных пользователей. Доступ IPMI следует указывать через Указание здесь Варианты:
|
|
password string / обязательный |
Действительный пароль для входа пользователя. |
|
role string / обязательный |
Роли, назначенные пользователю на конечном устройстве. Варианты:
|
|
username string / обязательный |
Имя пользователя, создаваемого на конечном устройстве. В настоящее время Cisco Intersight ограничивает длину имен пользователей на конечных устройствах 16 символами. |
name string / обязательный | Имя, присвоенное политике локальных пользователей. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_. |
organization string | Имя организации, которой назначен этот ресурс. Профили и политики, созданные в пользовательской организации, применяются только к устройствам в этой же организации. По умолчанию: |
password_history integer | Задает количество предыдущих паролей, которые нельзя использовать повторно при смене пароля (значение от 0 до 5). Значение 0 отключает этот параметр. По умолчанию: |
purge boolean | Аргумент purge указывает модулю считать определение ресурса исчерпывающим. Если значение равно true, все ранее настроенные имена пользователей будут удалены из политики, кроме пользователя `admin`, которого удалить нельзя. Варианты:
|
state string | Если указано Если указано Варианты:
|
tags list / элементы=dictionary | Список тегов в формате Key:<ключ, заданный пользователем> Value:<значение, заданное пользователем>. |
use_proxy boolean | Если указано Варианты:
|
validate_certs boolean | Логический параметр, управляющий проверкой TLS-сертификата api_uri Варианты:
|
Примеры
- name: Configure Local User policy
intersight_local_user_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: guest-admin
tags:
- Key: username
Value: guest
description: User named guest with admin role
local_users:
- username: guest
role: admin
password: vault_guest_password
- username: reader
role: readonly
password: vault_reader_password
- name: Configure Local User policy with IPMI user
intersight_local_user_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: ipmi-admin
description: User with IPMI account type
local_users:
- username: ipmi-user
role: admin
password: vault_ipmi_password
account_types:
- IPMI
- name: Configure Local User policy with local and IPMI access
intersight_local_user_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: local-ipmi-admin
description: User with local and IPMI account types
local_users:
- username: local-ipmi
role: admin
password: vault_local_ipmi_password
account_types:
- Local
- IPMI
- name: Delete Local User policy
intersight_local_user_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: guest-admin
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
api_response dictionary | Ответ API, возвращенный для указанного ресурса. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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/cisco/intersight/intersight_local_user_policy_module.html