Spec-Zone.ru › Ansible

модуль 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, пароль будет обновляться только при создании пользователя.

Варианты:

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

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.

По умолчанию: "https://intersight.com/api/v1"

description

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

string

Описание политики локальных пользователей, заданное пользователем.

Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или символ подчеркивания (_).

enable_password_expiry

boolean

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

Варианты:

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

enforce_strong_password

boolean

Если значение равно true, включается политика надежных паролей.

Требования к надежному паролю:

  1. Пароль должен содержать не менее 8 и не более 20 символов.
  2. Пароль не должен содержать имя пользователя.
  3. Пароль должен содержать символы как минимум из трех из следующих четырех категорий.
  1. Заглавные буквы английского алфавита (от A до Z).
  2. Строчные буквы английского алфавита (от a до z).
  3. Десятичные цифры (от 0 до 9).
  4. Неалфавитные символы (! , @, ‘#’, $, %, ^, &, *, -, _, +, =).

Варианты:

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

local_users

list / элементы=dictionary

Список локальных пользователей на конечном устройстве.

На конечном устройстве уже существует пользователь admin.

Добавляйте пользователя admin сюда, только если требуется изменить пароль или включить либо отключить пользователя.

Чтобы добавить пользователя admin, укажите имя пользователя ‘admin’, выберите роль администратора, а затем продолжите.

account_types

list / элементы=any

Список типов учетных записей, назначаемых пользователю.

Поддерживаются значения IPMI и Local.

Для обеспечения обратной совместимости по-прежнему принимаются записи словаря с ObjectType.

Если указаны эти значения, модуль сопоставляет их с соответствующими типами объектов API Intersight и не задает отдельное

поле переключателя типа учетной записи.

Используйте этот параметр, чтобы запросить доступ IPMI или комбинированный доступ к локальной учетной записи и IPMI, сохранив тип роли конечного устройства IMC.

enable

boolean

Включить или отключить пользователя.

Варианты:

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

endpoint_role_type

string

Тип роли конечного устройства, назначаемой пользователю.

IMC — поддерживаемый тип роли управления сервером для ролей локальных пользователей.

Доступ IPMI следует указывать через account_types, например IPMI.

Указание здесь IPMI отклоняется API Intersight для iam.EndPointUserRole.

Варианты:

  • "IMC" ← (по умолчанию)
  • "IPMI"

password

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

Действительный пароль для входа пользователя.

role

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

Роли, назначенные пользователю на конечном устройстве.

Варианты:

  • "admin"
  • "readonly"
  • "user"

username

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

Имя пользователя, создаваемого на конечном устройстве.

В настоящее время Cisco Intersight ограничивает длину имен пользователей на конечных устройствах 16 символами.

name

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

Имя, присвоенное политике локальных пользователей.

Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.

organization

string

Имя организации, которой назначен этот ресурс.

Профили и политики, созданные в пользовательской организации, применяются только к устройствам в этой же организации.

По умолчанию: "default"

password_history

integer

Задает количество предыдущих паролей, которые нельзя использовать повторно при смене пароля (значение от 0 до 5).

Значение 0 отключает этот параметр.

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

purge

boolean

Аргумент purge указывает модулю считать определение ресурса исчерпывающим.

Если значение равно true, все ранее настроенные имена пользователей будут удалены из политики, кроме пользователя `admin`, которого удалить нельзя.

Варианты:

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

state

string

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

Если указано absent, модуль проверит отсутствие ресурса и при необходимости удалит его.

Варианты:

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

tags

list / элементы=dictionary

Список тегов в формате Key:<ключ, заданный пользователем> Value:<значение, заданное пользователем>.

use_proxy

boolean

Если указано no, прокси использоваться не будет, даже если он задан в переменной окружения на целевых узлах.

Варианты:

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

validate_certs

boolean

Логический параметр, управляющий проверкой TLS-сертификата api_uri

Варианты:

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

Примеры

- 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, возвращенный для указанного ресурса.

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

Пример: {"api_response": {"Description": "User named guest with admin role", "EndPointUserRoles": [{"ChangePassword": true, "Enabled": true}]}}

Авторы

  • David Soper (@dsoper2)

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

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

© 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

Spec-Zone.ru

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