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. | ||
| provider словарь добавлен в 2.5 | Объект словаря, содержащий сведения о подключении. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ. | ||
| 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 целое число | Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для подключения к удалённому устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, задав переменную среды F5_USER. | ||
| validate_certs булево |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах, использующих самозаверяющие сертификаты.Вы можете опустить этот параметр, задав переменную среды F5_VALIDATE_CERTS. | |
| remote_access булево |
| Включает или отключает удалённый доступ для указанной группы удалённо аутентифицированных пользователей. При создании новой удалённой роли, если этот параметр не указан, значение по умолчанию — yes. | |
| state строка |
| В случае present, гарантирует, что удалённая роль существует.В случае absent, удаляет удалённую роль из системы. | |
| terminal_access строка | Указывает доступ на основе терминала для удалённых учётных записей, которым ещё не явно назначена роль пользователя. Общие значения для этого включают tmsh и none, но также можно указать пользовательские значения.При создании новой удалённой роли, если этот параметр не указан, значение по умолчанию — none. | ||
Примечания
Примечание
- Дополнительную информацию об использовании 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.9/modules/bigip_remote_role_module.html
