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_password string | Пароль имени пользователя API удалённого устройства-партнёра, которому вы доверяете. Если это значение не указано, используется значение |
peer_server string / обязательный | Адрес партнёра, к которому нужно подключиться и которому нужно доверять для синхронизации конфигурации. Обычно это адрес управления удалённого устройства, но также может использоваться Self IP. |
peer_user string | Имя пользователя API удалённого устройства-партнёра, которому вы доверяете. Обратите внимание: пользователя CLI нельзя использовать, если у него также нет учётной записи API. Если это значение не указано, используется значение |
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 |
Если Этот параметр можно не указывать, задав переменную среды Варианты:
|
state string | Если Если Варианты:
|
type string | Указывает, добавляется ли устройство в качестве партнёра или подчинённого устройства. По умолчанию используется Различие между этими типами связано со снижением риска компрометации. Подчинённое устройство не может подписывать сертификаты для других устройств. Если безопасность устройства-центра доверия в домене доверия будет нарушена, риск компрометации любого подчинённого устройства будет минимизирован. Рекомендуется назначать устройства подчинёнными в группах устройств с большим количеством участников, где риск компрометации высок. Варианты:
|
Примечания
Примечание
- Дополнительные сведения об использовании 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 | Имя удалённого узла, используемое для идентификации доверенного партнёра. Возвращается: при изменении Пример: |
peer_server string | Удалённый IP-адрес доверенного партнёра. Возвращается: при изменении Пример: |
Ссылки на коллекцию
© 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