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

Примечание

Этот плагин является частью коллекции f5networks.f5_modules (версия 1.7.1).

Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в книге задач укажите: f5networks.f5_modules.bigip_remote_role.

Новое в версии 1.0.0: модуля f5networks.f5_modules

Обзор
Параметры
Примечания
Примеры
Значения возврата

Обзор

Управляет удаленными ролями на системе 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`.
provider словарь добавлен в версии 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщик аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ.
	no_f5_teem логическое	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Можно опустить этот параметр, установив переменную окружения `F5_TEEM`.
	password строка / обязательный		Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, установив переменную окружения `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательный		Хост BIG-IP. Можно опустить этот параметр, установив переменную окружения `F5_SERVER`.
	server_port целое число	По умолчанию: 443	Порт сервера BIG-IP. Можно опустить этот параметр, установив переменную окружения `F5_SERVER_PORT`.
	timeout целое число		Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: rest ←	Настраивает транспортное соединение для подключения к удаленному устройству.
	user строка / обязательный		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Можно опустить этот параметр, установив переменную окружения `F5_USER`.
	validate_certs логическое	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяющими сертификатами. Можно опустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`.
remote_access логическое		Варианты: no yes	Включает или отключает удаленный доступ для указанной группы удалённо аутентифицированных пользователей. При создании новой удалённой роли, если этот параметр не указан, значение по умолчанию — `yes`.
state строка		Варианты: absent present ←	Когда `present`, гарантирует существование удаленной роли. Когда `absent`, удаляет удалённую роль из системы.
terminal_access строка			Указывает доступ по терминалу для удалённых учетных записей, которым ещё не назначена роль пользователя. Типичные значения включают `tmsh` и `none`, но вы также можете указать пользовательские значения. При создании новой удаленной роли, если этот параметр не указан, значение по умолчанию — `none`.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP >= 12.
Модули F5 манипулируют только текущей конфигурацией продукта F5. Чтобы убедиться, что конфигурация BIG-IP сохранится на диске, убедитесь, что включён хотя бы один шаг, использующий модуль f5networks.f5_modules.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 строка	changed	Система роли, связанной с этой удалённой ролью. Пример: administrator
attribute_string строка	changed	Новая строка атрибутов ресурса. Пример: memberOf=cn=ldap_group,cn=ldap.group,ou=ldap
line_order целое число	changed	Порядок удалённой роли для серверов LDAP и Active Directory. Пример: 1000
partition_access строка	changed	Раздел, к которому имеет доступ роль. Пример: all
remote_access логическое	changed	Разрешен или запрещен удаленный доступ.
terminal_access строка	changed	Настройка терминала для удаленной роли. Пример: tmsh

Авторы

Tim Rupp (@caphrim007)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/f5networks/f5_modules/bigip_remote_role_module.html