Spec-Zone.ru › Ansible

f5networks.f5_modules.bigip_device_trust module – Управление отношениями доверия между 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_trust.

Добавлено в f5networks.f5_modules 1.0.0

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управление отношениями доверия между системами BIG-IP. После установления связи между устройствами их нельзя обновить. Если требуется обновление, сначала необходимо удалить устройство-партнёр, а затем добавить его в доверенную группу повторно.

Параметры

Параметр

Комментарии

peer_hostname

string

Имя узла, которое требуется связать с устройством. Это значение используется для удобной идентификации устройства в конфигурации BIG-IP.

При установлении доверия к новому устройству, если этот параметр не указан, по умолчанию используется значение peer_server.

peer_password

string

Пароль имени пользователя API удалённого устройства-партнёра, которому вы доверяете. Если это значение не указано, используется значение password или переменная среды F5_PASSWORD.

peer_server

string / обязательный

Адрес партнёра, к которому нужно подключиться и которому нужно доверять для синхронизации конфигурации. Обычно это адрес управления удалённого устройства, но также может использоваться Self IP.

peer_user

string

Имя пользователя API удалённого устройства-партнёра, которому вы доверяете. Обратите внимание: пользователя CLI нельзя использовать, если у него также нет учётной записи API. Если это значение не указано, используется значение user или переменная среды F5_USER.

provider

dictionary

добавлено в f5networks.f5_modules 1.0.0

Объект dict, содержащий сведения для подключения.

auth_provider

string

Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства.

Этот параметр используется преимущественно при работе с устройствами BIG-IQ.

no_f5_teem

boolean

Если yes, телеметрические данные TEEM не отправляются в F5.

Этот параметр можно не указывать, задав переменную среды F5_TELEMETRY_OFF.

Ранее использовавшаяся переменная F5_TEEM устарела, поскольку её название было неоднозначным.

Варианты:

  • false ← (по умолчанию)
  • true

password

псевдонимы: pass, pwd

string / обязательный

Пароль учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную среды F5_PASSWORD.

server

string / обязательный

Узел BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную среды F5_SERVER.

server_port

integer

Порт сервера BIG-IP.

Этот параметр можно не указывать, задав переменную среды F5_SERVER_PORT.

По умолчанию: 443

timeout

integer

Задаёт время ожидания в секундах при взаимодействии с сетевым устройством — как при подключении, так и при отправке команд. Если время ожидания истечёт до завершения операции, модуль завершится с ошибкой.

transport

string

Настраивает транспортное соединение для подключения к удалённому устройству.

Варианты:

  • "rest" ← (по умолчанию)

user

string / обязательный

Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь права администратора на устройстве.

Этот параметр можно не указывать, задав переменную среды F5_USER.

validate_certs

boolean

Если no, SSL-сертификаты не проверяются. Используйте этот параметр только на контролируемых вами сайтах с самоподписанными сертификатами.

Этот параметр можно не указывать, задав переменную среды F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

state

string

Если present, обеспечивает установление доверия к указанным устройствам.

Если absent, удаляет отношения доверия с устройствами.

Варианты:

  • "absent"
  • "present" ← (по умолчанию)

type

string

Указывает, добавляется ли устройство в качестве партнёра или подчинённого устройства. По умолчанию используется peer.

Различие между этими типами связано со снижением риска компрометации.

Подчинённое устройство не может подписывать сертификаты для других устройств.

Если безопасность устройства-центра доверия в домене доверия будет нарушена, риск компрометации любого подчинённого устройства будет минимизирован.

Рекомендуется назначать устройства подчинёнными в группах устройств с большим количеством участников, где риск компрометации высок.

Варианты:

  • "peer" ← (по умолчанию)
  • "subordinate"

Примечания

Примечание

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

Примеры

- name: Add trusts for all peer devices to Active device
  bigip_device_trust:
    peer_server: "{{ item.ansible_host }}"
    peer_hostname: "{{ item.inventory_hostname }}"
    peer_user: "{{ item.bigip_username }}"
    peer_password: "{{ item.bigip_password }}"
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  loop: hostvars
  when: inventory_hostname in groups['master']
  delegate_to: localhost

Возвращаемые значения

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

Ключ

Описание

peer_hostname

string

Имя удалённого узла, используемое для идентификации доверенного партнёра.

Возвращается: при изменении

Пример: "test-bigip-02.localhost.localdomain"

peer_server

string

Удалённый IP-адрес доверенного партнёра.

Возвращается: при изменении

Пример: "10.0.2.15"

Авторы

  • Tim Rupp (@caphrim007)

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 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_trust_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API