Модуль f5networks.f5_modules.bigip_device_auth – Управление системной аутентификацией на BIG-IP
Примечание
Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Чтобы использовать её в плейбуке, укажите: f5networks.f5_modules.bigip_device_auth.
Добавлено в f5networks.f5_modules 1.0.0
Обзор
- Управление конфигурацией системной аутентификации. Этот модуль помогает настроить различные типы системной аутентификации. Обратите внимание, что этот модуль нельзя использовать для настройки типов аутентификации APM.
Параметры
Параметр | Комментарии |
|---|---|
accounting string | Указывает, как система передаёт на сервер TACACS+ сведения учёта, например информацию о том, к каким службам обращаются пользователи и какой объём сетевых ресурсов они потребляют. Если задано значение Если задано значение Этот параметр поддерживается типом Варианты:
|
authentication string | Указывает процесс, используемый системой при отправке запросов аутентификации. Если задано значение Если задано значение Этот параметр поддерживается типом Варианты:
|
protocol_name string | Указывает протокол, связанный со значением, заданным в Обратите внимание, что в большинстве реализаций TACACS+ используется тип протокола Варианты:
|
provider dictionary добавлено в f5networks.f5_modules 1.0.0 | Объект dict, содержащий сведения о подключении. |
|
auth_provider string |
Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства. Этот параметр используется преимущественно при работе с устройствами BIG-IQ. |
|
no_f5_teem boolean |
Если задано значение Этот параметр можно не указывать, задав переменную среды Ранее использовавшаяся переменная Варианты:
|
|
password псевдонимы: pass, pwd string / обязательный |
Пароль учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды |
|
server string / обязательный |
Узел BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды |
|
server_port integer |
Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную среды По умолчанию: |
|
timeout integer |
Задаёт время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечёт до завершения операции, модуль сообщит об ошибке. |
|
transport string |
Настраивает транспортное соединение для подключения к удалённому устройству. Варианты:
|
|
user string / обязательный |
Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную среды |
|
validate_certs boolean |
Если задано значение Этот параметр можно не указывать, задав переменную среды Варианты:
|
secret string | Секретный ключ, используемый для шифрования и расшифровки пакетов, отправляемых на сервер или получаемых с него. Не используйте знак решётки в секрете для серверов TACACS+. При первой настройке аутентификации TACACS+ это значение обязательно. |
servers any | Задаёт список IPv4-адресов серверов, использующих протокол Terminal Access Controller Access System (TACACS)+, с которыми система обменивается данными для получения сведений об авторизации. Для каждого адреса можно указать альтернативный номер порта TCP с помощью ключа Если номер порта не указан, используется порт по умолчанию Этот параметр поддерживается типом |
|
address string |
IP-адрес сервера. Это поле обязательно, если только вы не указываете простой список серверов. В этом случае в простом списке можно указать IP-адреса серверов. Дополнительные пояснения см. в примерах. |
|
port string |
Порт сервера. |
service_name string | Задаёт имя службы, для использования которой пользователь запрашивает авторизацию. Указание того, на использование чего именно пользователь запрашивает авторизацию, позволяет серверу TACACS+ по-разному обрабатывать запросы на авторизацию различных типов. Это значение необходимо при настройке данного типа системной аутентификации. Обратите внимание, что в большинстве реализаций TACACS+ используется тип службы Варианты:
|
state string | Состояние конфигурации аутентификации в системе. Если задано значение Если задано значение Варианты:
|
type string / обязательный | Тип аутентификации, которым управляет этот модуль. Обратите особое внимание на то, что поддерживаемые этим модулем параметры зависят от настраиваемого В настоящее время этот модуль поддерживает только часть всех доступных типов аутентификации. Варианты:
|
update_secret string | Значение Значение Варианты:
|
use_for_auth boolean | Указывает, используется ли этот источник аутентификации в системе. Варианты:
|
Примечания
Примечание
- Дополнительные сведения об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется BIG-IP версии >= 12.
- Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы сохранить на диске конфигурацию, специфичную для BIG-IP, обязательно включите как минимум одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Правила использования модуля для сохранения текущей конфигурации см. в документации к нему.
Примеры
- name: Set the system auth to TACACS+, default server port
bigip_device_auth:
type: tacacs
authentication: use-all-servers
accounting: send-to-all-servers
protocol_name: ip
secret: secret
servers:
- 10.10.10.10
- 10.10.10.11
service_name: ppp
state: present
use_for_auth: true
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Set the system auth to TACACS+, override server port
bigip_device_auth:
type: tacacs
authentication: use-all-servers
protocol_name: ip
secret: secret
servers:
- address: 10.10.10.10
port: 1234
- 10.10.10.11
service_name: ppp
use_for_auth: true
state: present
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
accounting string | Серверы, на которые отправляются сведения при использовании TACACS. Возвращается: changed Пример: |
authentication string | Процесс, используемый системой для обработки запросов аутентификации при использовании TACACS. Возвращается: changed Пример: |
protocol_name string | Имя протокола, связанного с Возвращается: changed Пример: |
servers list / элементы=string | Список серверов, используемых для аутентификации TACACS. Возвращается: changed Пример: |
service_name string | Имя службы, для использования которой пользователь запрашивает авторизацию. Возвращается: changed Пример: |
Ссылки на коллекцию
© 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/f5networks/f5_modules/bigip_device_auth_module.html