bigip_remote_role – Управление удалёнными ролями на BIG-IP

Новая версия 2.7.

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

Обзор

Управляет удалёнными ролями на BIG-IP. Удалённые роли используются в ситуациях, когда аутентификация пользователей обрабатывается вне устройства. Местный контроль доступа к BIG-IP регулируется определённой удалённой ролью. В то время как аутентификация (и, как следствие, назначение роли) обрабатывается вне устройства.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
assigned_role строка			Указывает авторизацию (уровень доступа) для учётной записи. При создании новой удалённой роли, если этот параметр не указан, значение по умолчанию — `none`. Параметр `partition_access` управляет тем, к каким разделам может получить доступ учётная запись. Выбранная роль может повлиять на разрешённые разделы. В частности, такие роли, как `administrator`, `auditor` и `resource-administrator`, требуют `partition_access` уровня `all`. Система поставляется со множеством предварительно созданных ролей. Это `none`, `guest`, `operator`, `application-editor`, `manager`, `certificate-manager`, `irule-manager`, `user-manager`, `resource-administrator`, `auditor`, `administrator`, `firewall-manager`.
attribute_string строка			Указывает атрибуты учётной записи, сохранённые в группе, в формате `cn=, ou=, dc=`. При создании новой удалённой роли этот параметр обязателен.
line_order целое число			Указывает порядок строки в файле `/config/bigip/auth/remoterole`. Серверы LDAP и Active Directory считывают этот файл построчно. Порядок информации важен; поэтому F5 рекомендует установить первую строку со значением 1000. Это позволяет в будущем вставлять строки перед первой строкой. При создании новой удалённой роли этот параметр обязателен.
name строка / обязательно			Указывает имя удалённой роли.
partition_access строка			Указывает доступные разделы для учётной записи. Этот параметр поддерживает зарезервированные имена `all` и `Common`, а также конкретные разделы, к которым пользователь может получить доступ. Пользователи, имеющие доступ к разделу, могут выполнять операции с объектами в этом разделе, как определено разрешениями, предоставленными ролью пользователя `assigned_role`. При создании новой удалённой роли, если этот параметр не указан, значение по умолчанию — `all`.
password строка / обязательно			Пароль учётной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, задав переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
provider словарь добавлено в 2.5			Объект словаря, содержащий данные подключения.
	password строка / обязательно		Пароль учётной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, задав переменную среды `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательно		Хост BIG-IP. Этот параметр можно опустить, задав переменную среды `F5_SERVER`.
	server_port целое число	По умолчанию: 443	Порт сервера BIG-IP. Этот параметр можно опустить, задав переменную среды `F5_SERVER_PORT`.
	ssh_keyfile путь		Указывает файл SSH-ключа для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспортов cli. Этот параметр можно опустить, задав переменную среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число	По умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут превышен до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: cli rest ←	Настраивает транспортное подключение для использования при подключении к удалённому устройству.
	user строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, задав переменную среды `F5_USER`.
	validate_certs логическое значение	Варианты: нет да ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами. Этот параметр можно опустить, задав переменную среды `F5_VALIDATE_CERTS`.
remote_access логическое значение		Варианты: нет да	Включает или отключает удалённый доступ для указанной группы удалённо аутентифицированных пользователей. При создании новой удалённой роли, если этот параметр не указан, значение по умолчанию — `yes`.
server строка / обязательно			Хост BIG-IP. Этот параметр можно опустить, задав переменную среды `F5_SERVER`.
server_port целое число добавлено в 2.2		По умолчанию: 443	Порт сервера BIG-IP. Этот параметр можно опустить, задав переменную среды `F5_SERVER_PORT`.
state строка		Варианты: отсутствует присутствует ←	В случае `present`, гарантирует существование удалённой роли. В случае `absent`, удаляет удалённую роль из системы.
terminal_access строка			Указывает доступность терминала для учётных записей удалённых пользователей, которым ещё не явно назначена роль пользователя. Общие значения для этого параметра включают `tmsh` и `none`, однако также можно указать пользовательские значения. При создании новой удалённой роли, если этот параметр не указан, значение по умолчанию — `none`.
user строка / обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, задав переменную среды `F5_USER`.
validate_certs логическое значение добавлено в 2.0		Варианты: нет да ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами. Этот параметр можно опустить, задав переменную среды `F5_VALIDATE_CERTS`.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
Требуется версия программного обеспечения BIG-IP >= 12.
Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы гарантировать сохранение конфигурации BIG-IP на диске, убедитесь, что включена хотя бы одна задача, использующая модуль bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения рабочей конфигурации.

Примеры

- name: Create a remote role
  bigip_remote_role:
    name: foo
    group_name: ldap_group
    line_order: 1
    attribute_string: memberOf=cn=ldap_group,cn=ldap.group,ou=ldap
    remote_access: enabled
    assigned_role: administrator
    partition_access: all
    terminal_access: none
    state: present
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Значения возврата

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

Ключ	Возвращаемое значение	Описание
assigned_role строка	изменено	Роль системы, с которой связана эта удаленная роль. Пример: administrator
attribute_string строка	изменено	Новая строка атрибутов ресурса. Пример: memberOf=cn=ldap_group,cn=ldap.group,ou=ldap
line_order целое число	изменено	Порядок удаленной роли для серверов LDAP и Active Directory. Пример: 1000
partition_access строка	изменено	Раздел, к которому роль имеет доступ. Пример: all
remote_access логическое значение	изменено	Разрешен или запрещен удаленный доступ.
terminal_access строка	изменено	Параметр терминала для удаленной роли. Пример: tmsh

Состояние

Этот модуль не гарантирует обратной совместимости. [превью]
Этот модуль поддерживается партнером Ansible. [сертифицировано]

Авторы

Tim Rupp (@caphrim007)

Подсказка

Если вы заметили проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/bigip_remote_role_module.html