f5networks.f5_modules.bigip_device_auth – Управление системной аутентификацией на BIG-IP

Примечание

Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).

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

Чтобы использовать его в книге задач, укажите: f5networks.f5_modules.bigip_device_auth.

Новое в версии 1.0.0: of f5networks.f5_modules

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

Обзор

Управление конфигурацией системной аутентификации. Этот модуль может помочь в настройке различных типов системной аутентификации. Обратите внимание, что этот модуль не может использоваться для настройки типов аутентификации APM.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
accounting string		Варианты: send-to-first-server send-to-all-servers	Указывает, как система возвращает информацию об учёте, например, какие сервисы пользователи используют и сколько сетевых ресурсов они потребляют, серверу TACACS+. Когда `send-to-first-server`, указывает, что система передаёт информацию об учёте первому доступному серверу TACACS+ в списке. Когда `send-to-all-servers`, указывает, что система передаёт информацию об учёте всем серверам TACACS+ в списке. Этот параметр поддерживается типом `tacacs`.
authentication string		Варианты: use-first-server use-all-servers	Указывает процесс, используемый системой при отправке запросов на аутентификацию. Когда `use-first-server`, указывает, что система отправляет попытки аутентификации только первому серверу в списке. Когда `use-all-servers`, указывает, что система отправляет запрос на аутентификацию каждому серверу до успешной аутентификации или до отправки запроса на все серверы в списке. Этот параметр поддерживается типом `tacacs`.
protocol_name string		Варианты: lcp ip ipx atalk vines lat xremote tn3270 telnet rlogin pad vpdn ftp http deccp osicp unknown	Указывает протокол, связанный со значением, указанным в `service_name`, который является подмножеством связанной службы, используемой для авторизации клиента или системного учёта. Обратите внимание, что большинство реализаций TACACS+ относятся к протоколу типа `ip`, поэтому попробуйте его в первую очередь.
provider dictionary добавлено в 1.0.0 of f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider string		Настраивает поставщика аутентификации для получения маркеров аутентификации с удалённого устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem boolean	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную окружения `F5_TEEM`.
	password string / required		Пароль для учётной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_PASSWORD`. псевдонимы: pass, pwd
	server string / required		Хост BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_SERVER`.
	server_port integer	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_SERVER_PORT`.
	timeout integer		Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку.
	transport string	Варианты: rest ←	Настраивает транспортное соединение, используемое при подключении к удалённому устройству.
	user string / required		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, установив переменную окружения `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверенными сертификатами. Вы можете опустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`.
secret string			Секретный ключ, используемый для шифрования и дешифрования пакетов, отправленных или полученных от сервера. Не используйте знак решётки/решётки в секрете для серверов TACACS+. При первой настройке аутентификации TACACS+ это значение обязательно.
servers raw			Указывает список IPv4-адресов серверов, использующих протокол TACACS+ (Terminal Access Controller Access System), с которыми система общается для получения данных авторизации. Для каждого адреса может быть необязательно указан альтернативный номер TCP-порта, указав ключ `port`. Если номер порта не указан, используется порт по умолчанию `49163`. Этот параметр поддерживается типом `tacacs`.
	address string		IP-адрес сервера. Это поле необходимо, если вы не указываете простой список серверов. В этом случае простой список может содержать IP-адреса серверов. См. примеры для более подробной информации.
	port string		Порт сервера.
service_name string		Варианты: slip ppp arap shell tty-daemon connection system firewall	Указывает имя службы, для использования которой требуется авторизация пользователя. Идентификация того, для чего пользователь запрашивает авторизацию, позволяет серверу TACACS+ по-разному реагировать на различные запросы авторизации. Это значение обязательно при настройке такого вида системной аутентификации. Обратите внимание, что большинство реализаций TACACS+ относятся к типу службы `ppp`, поэтому попробуйте её в первую очередь.
state string		Варианты: absent present ←	Состояние конфигурации аутентификации в системе. При значении `present`, гарантирует, что система настроена для указанного `type`. При значении `absent`, устанавливает исходный источник аутентификации системы обратно в `local`.
type string / required		Варианты: tacacs local	Тип аутентификации, который необходимо управлять этим модулем. Обратите особое внимание, что параметры, поддерживаемые этим модулем, будут различаться в зависимости от `type`, которую вы настраиваете. На данный момент этот модуль поддерживает только подмножество всех доступных типов аутентификации.
update_secret string		Варианты: always ← on_create	`always` позволит обновлять секреты, если пользователь этого захочет. `on_create` будет устанавливать секрет только тогда, когда `use_auth_source` `yes` и TACACS+ в настоящее время не является источником аутентификации.
use_for_auth boolean		Варианты: no yes	Указывает, используется ли этот источник аутентификации в системе.

Примечания

Примечание

Дополнительную информацию об использовании 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: yes
    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: yes
    state: present
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
accounting строка	изменённое	Какие серверы отправлять информацию при использовании TACACS. Пример: send-to-all-servers
authentication строка	изменённое	Процесс, используемый системой для обработки запросов на аутентификацию при использовании TACACS. Пример: use-all-servers
protocol_name строка	изменённое	Имя протокола, связанного с `service_name` для аутентификации клиента. Пример: ip
servers список / элементы=строка	изменённое	Список серверов, используемых в аутентификации TACACS. Пример: ['1.2.2.1', '4.5.5.4']
service_name строка	изменённое	Имя сервиса, для которого требуется авторизация пользователя. Пример: ppp

Авторы

Tim Rupp (@caphrim007)
Nitin Khanna (@nitinthewiz)

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