Модуль infoblox.nios_modules.nios_adminuser — настройка Adminuser Infoblox NIOS

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

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

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

Чтобы использовать модуль в плейбуке, укажите: infoblox.nios_modules.nios_adminuser.

Добавлено в infoblox.nios_modules 1.8.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Добавляет и/или удаляет экземпляры объектов adminuser на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS adminuser с помощью интерфейса Infoblox WAPI через REST.

Требования

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

infoblox-client

Параметры

Параметр	Комментарии
admin_groups list / elements=string / обязательный	Названия групп администраторов, в которые входит этот пользователь-администратор. В настоящее время можно указать только одну группу администраторов.
auth_method string	Метод аутентификации пользователя-администратора. Варианты: `"KEYPAIR"` ← (по умолчанию) `"KEYPAIR_PASSWORD"`
auth_type string	Тип аутентификации пользователя-администратора. Варианты: `"LOCAL"` ← (по умолчанию) `"REMOTE"` `"SAML"` `"SAML_LOCAL"`
ca_certificate_issuer string	Сертификат CA, используемый для поиска пользователя при аутентификации.
client_certificate_serial_number string	Серийный номер сертификата клиента.
comment string	Задает текстовый комментарий для экземпляра этого объекта. Указанный текст будет сохранен в экземпляре объекта.
disable boolean	Определяет, отключен ли пользователь-администратор. Если задано значение False, пользователь-администратор включен. Варианты: `false` ← (по умолчанию) `true`
email string	Адрес электронной почты пользователя-администратора.
enable_certificate_authentication boolean	Определяет, разрешен ли пользователю вход только с помощью сертификата. Обычная аутентификация по имени пользователя и паролю для этого пользователя будет отключена. Варианты: `false` ← (по умолчанию) `true`
extattrs dictionary	Позволяет настроить расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
name string / обязательный	Задает имя adminuser для добавления в систему или удаления из нее. Пользователи также могут изменить имя, передав словарь с ключами new_name и old_name. См. примеры.
password string	Пароль для входа администратора.
provider dictionary	Словарь с параметрами подключения.
cert string	Указывает файл сертификата клиента с дайджестом конфигурации x509 для дополнительного уровня защиты соединения с удаленным экземпляром NIOS. Значение также можно указать с помощью переменной окружения `INFOBLOX_CERT`.
host string	Указывает DNS-имя хоста или адрес для подключения к удаленному экземпляру NIOS WAPI через REST. Значение также можно указать с помощью переменной окружения `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте описание здесь По умолчанию: `10`
http_pool_maxsize integer	Вставьте описание здесь По умолчанию: `10`
http_request_timeout integer	Время ожидания ответа Значение также можно указать с помощью переменной окружения `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key string	Указывает файл закрытого ключа для шифрования с помощью сертификата при подключении к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной окружения `INFOBLOX_KEY`.
max_results integer	Указывает максимальное количество возвращаемых объектов. Если задано отрицательное число, устройство вернет ошибку, когда количество возвращаемых объектов превысит это значение. Значение также можно указать с помощью переменной окружения `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries integer	Задает количество повторных попыток до признания соединения работоспособным. Значение также можно указать с помощью переменной окружения `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password string	Указывает пароль для аутентификации при подключении к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной окружения `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание здесь Варианты: `false` `true` ← (по умолчанию)
username string	Задает имя пользователя для аутентификации при подключении к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной окружения `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify boolean	Логическое значение, включающее или отключающее проверку SSL-сертификатов. Значение также можно указать с помощью переменной окружения `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Указывает используемую версию WAPI. Значение также можно указать с помощью переменной окружения `INFOBLOX_WAPI_VERSION`. До версии ansible 2.8 по умолчанию использовалась WAPI 1.4. По умолчанию: `"2.12.3"`
ssh_keys list / elements=dictionary	Список ключей SSH пользователя-администратора. По умолчанию: `[]`
key_name string	Уникальный идентификатор ключа.
key_type string	Тип ключа SSH. Варианты: `"ECDSA"` `"ED25519"` `"RSA"`
key_value string	Текст ключа SSH.
state string	Задает требуемое состояние экземпляра объекта на сервере NIOS. Если задано значение `present`, объект настраивается на устройстве; если задано значение `absent`, объект удаляется с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`
time_zone string	Часовой пояс этого пользователя-администратора. По умолчанию: `"UTC"`
use_ssh_keys boolean	Включает или отключает аутентификацию с помощью пары ключей SSH. Варианты: `false` ← (по умолчанию) `true`
use_time_zone boolean	Флаг использования параметра time_zone. Варианты: `false` ← (по умолчанию) `true`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль необходимо запускать локально. Для этого можно указать connection: local.
Дополнительные сведения об использовании Infoblox с Ansible см. в :ref:`nios_guide`.

Примеры

- name: Create a new admin user
  infoblox.nios_modules.nios_adminuser:
    name: ansible_user
    admin_groups: admin-group
    password: "secure_password"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update admin user name
  infoblox.nios_modules.nios_adminuser:
    name: {new_name: new_user, old_name: ansible_user}
    admin_groups: admin-group
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create admin user with remote authentication
  infoblox.nios_modules.nios_adminuser:
    name: remote_admin_user
    admin_groups: admin-group
    auth_type: "REMOTE"
    email: "admin@example.com"
    use_time_zone: true
    time_zone: 'US/Hawaii'
    extattrs:
      Site: "USA"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create admin user with ssh keys
  infoblox.nios_modules.nios_adminuser:
    name: cloud_user
    admin_groups: cloud-api-only
    comment: "Created by Ansible"
    disable : false
    password: "secure_password"
    use_ssh_keys: true
    ssh_keys:
      - key_name: "sshkey1"
        key_type: "RSA"
        key_value: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
      - key_name: "sshkey2"
        key_type: "ECDSA"
        key_value: "{{ lookup('file', '~/.ssh/id_ecdsa.pub') }}"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update admin user to enable certificate authentication
  infoblox.nios_modules.nios_adminuser:
    name: admin_user
    admin_groups: admin-group
    enable_certificate_authentication: true
    ca_certificate_issuer: 'CN="ib-root-ca"'
    client_certificate_serial_number: "397F9435000100000031"
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove admin user
  infoblox.nios_modules.nios_adminuser:
    name: new_user
    admin_groups: admin-group
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Nitish K S (@nitish-ks)

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

© 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/infoblox/nios_modules/nios_adminuser_module.html