Модуль f5networks.f5_modules.bigip_ssl_ocsp – Управление конфигурациями OCSP на 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_ssl_ocsp.

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

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

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

Управление конфигурациями OCSP в системе BIG-IP.

Параметры

Параметр	Комментарии
cache_error_timeout integer	Задаёт срок хранения ответа об ошибке в кэше в секундах.
cache_timeout string	Задаёт срок хранения ответа OCSP в кэше в секундах.
certificate string	Задаёт сертификат, используемый для подписания запроса OCSP.
clock_skew integer	Задаёт допустимую абсолютную разницу показаний часов ответчика и системы BIG-IP в секундах.
connection_timeout integer	Задаёт интервал времени в секундах, по истечении которого система BIG-IP разрывает соединение с ответчиком OCSP.
connections_limit integer	Задаёт максимально допустимое количество соединений в секунду для средства проверки сертификатов OCSP.
dns_resolver string	Задаёт внутренний DNS-резолвер, который система BIG-IP использует для получения ответа OCSP. Для этого необходимо указать один или несколько DNS-серверов в конфигурации DNS-резолвера. Используйте этот параметр, если имеется DNS-сервер, способный разрешать имена ответчиков OCSP, либо ответчик OCSP доступен через один из интерфейсов системы BIG-IP.
hash_algorithm string	Задаёт алгоритм хеширования, используемый для подписания запроса OCSP. Варианты: `"sha256"` `"sha1"`
key string	Задаёт ключ, используемый для подписания запроса OCSP.
name string / обязательный	Задаёт имя средства проверки сертификатов OCSP.
partition string	Раздел устройства, в котором будут управляться ресурсы. По умолчанию: `"Common"`
passphrase string	Задаёт парольную фразу, используемую для подписания запроса OCSP.
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` ← (по умолчанию)
proxy_server_pool string	Задаёт пул прокси-серверов, который система BIG-IP использует для получения ответа OCSP. Для этого необходимо создать пул с прокси-серверами. Используйте этот параметр, если ответчик OCSP недоступен ни через один из интерфейсов системы BIG-IP либо один или несколько серверов могут проксировать HTTP-запросы к внешнему серверу и получать ответы.
responder_url string	Задаёт абсолютный URL, который переопределяет URL ответчика OCSP, полученный из расширений AIA сертификата. URL должен использовать протокол HTTP.
route_domain string	Задаёт домен маршрутизации для получения ответа OCSP с использованием HTTP forward proxy.
state string	Если задано значение `present`, обеспечивает наличие ресурса. Если задано значение `absent`, обеспечивает отсутствие ресурса. Варианты: `"present"` ← (по умолчанию) `"absent"`
status_age integer	Задаёт максимально допустимое отставание времени «thisUpdate» в ответе OCSP, принимаемое системой BIG-IP.
strict_responder_checking boolean	Задаёт, следует ли проверять наличие расширения для подписания OCSP в сертификате ответчика. Варианты: `false` `true`
trusted_responders string	Задаёт сертификаты, используемые для проверки ответа OCSP, если сертификат ответчика не включён в ответ.
update_password string	`always` позволяет пользователю обновлять пароли. `on_create` задаёт пароль только для вновь созданных средств проверки OCSP. Варианты: `"always"` ← (по умолчанию) `"on_create"`

Примечания

Примечание

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

Примеры

- name: Create a OCSP validator
  bigip_ssl_ocsp:
    name: foo
    proxy_server_pool: validators-pool
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ	Описание
cache_error_timeout integer	Новое значение времени хранения ошибок кэширования ответов. Возвращается: при изменении Пример: `3600`
cache_timeout string	Новое значение времени кэширования ответов. Возвращается: при изменении Пример: `"indefinite"`
certificate string	Новое значение сертификата для подписания запроса. Возвращается: при изменении Пример: `"/Common/cert1"`
clock_skew integer	Новое значение допустимого расхождения часов при проверке ответа. Возвращается: при изменении Пример: `300`
connection_timeout integer	Новое значение времени ожидания соединения. Возвращается: при изменении Пример: `8`
connections_limit integer	Новое значение предельного количества параллельных соединений. Возвращается: при изменении Пример: `50`
dns_resolver string	Новое значение DNS-резолвера. Возвращается: при изменении Пример: `"/Common/resolver1"`
hash_algorithm string	Новое значение алгоритма хеширования для подписания запроса. Возвращается: при изменении Пример: `"sha256"`
key string	Новое значение ключа для подписания запроса. Возвращается: при изменении Пример: `"/Common/key1"`
proxy_server_pool string	Новое значение пула прокси-серверов. Возвращается: при изменении Пример: `"/Common/pool1"`
responder_url string	Новое значение URL ответчика для соединения. Возвращается: при изменении Пример: `"http://responder.site.com"`
route_domain string	Новое значение домена маршрутизации. Возвращается: при изменении Пример: `"/Common/0"`
status_age integer	Новое значение возраста статуса для проверки ответа. Возвращается: при изменении Пример: `0`
strict_responder_checking boolean	Новое значение параметра строгой проверки сертификата ответчика при проверке ответа. Возвращается: при изменении Пример: `true`
trusted_responders integer	Новое значение доверенных ответчиков для проверки ответа. Возвращается: при изменении Пример: `"/Common/default"`

Авторы

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_ssl_ocsp_module.html