community.network.avi_sslprofile – Модуль для настройки объекта SSLProfile Avi RESTful

Примечание

Этот плагин является частью коллекции community.network (версия 1.3.0).

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

Для использования в плейбуке укажите: community.network.avi_sslprofile.

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

Обзор

Этот модуль используется для конфигурации объекта SSLProfile.
Дополнительные примеры см. на https://github.com/avinetworks/devops

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

avisdk

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
accepted_ciphers строка			Наборы шифров, представленные как определено в http://www.openssl.org/docs/apps/ciphers.html. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как AES:3DES:RC4.
accepted_versions строка			Набор версий, принимаемых сервером.
api_context словарь			Контекст API Avi, который включает текущий идентификатор сеанса и маркер CSRF. Это позволяет пользователю выполнить одно входное окно и повторно использовать сеанс.
api_version строка		Значение по умолчанию: "16.4.4"	Версия API Avi для использования с API Avi и объектами.
avi_api_patch_op строка		Варианты: add replace delete	Операция исправления, которая используется при использовании avi_api_update_method в качестве patch.
avi_api_update_method строка		Варианты: put ← patch	Метод по умолчанию для обновления объекта — HTTP PUT. Установка на patch приведет к изменению поведения на использование HTTP PATCH.
avi_credentials словарь			Словарь учетных данных Avi, который может использоваться вместо перечисления данных входа в контроллер Avi.
	api_version строка	Значение по умолчанию: "16.4.4"	Версия контроллера Avi
	controller строка		IP-адрес или FQDN контроллера
	csrftoken строка		Маркер csrf контроллера Avi для повторного использования существующей сессии с идентификатором сессии.
	password строка		Пароль пользователя Avi в контроллере Avi.
	port строка		Порт контроллера Avi
	session_id строка		Идентификатор сессии API контроллера Avi для повторного использования существующей сессии с маркером csrf.
	tenant строка	Значение по умолчанию: "admin"	Тенент контроллера Avi
	tenant_uuid строка		UUID тенента контроллера Avi
	timeout строка	Значение по умолчанию: 300	Таймаут запроса контроллера Avi
	token строка		Токен API контроллера Avi
	username строка		Имя пользователя контроллера Avi
avi_disable_session_cache_as_fact логическое		Варианты: нет ← да	Отключает кеширование информации о сеансе avi в качестве факта.
cipher_enums строка			Варианты перечисления — tls_ecdhe_ecdsa_with_aes_128_gcm_sha256, tls_ecdhe_ecdsa_with_aes_256_gcm_sha384, tls_ecdhe_rsa_with_aes_128_gcm_sha256, tls_ecdhe_rsa_with_aes_256_gcm_sha384, tls_ecdhe_ecdsa_with_aes_128_cbc_sha256, tls_ecdhe_ecdsa_with_aes_256_cbc_sha384, tls_ecdhe_rsa_with_aes_128_cbc_sha256, tls_ecdhe_rsa_with_aes_256_cbc_sha384, tls_rsa_with_aes_128_gcm_sha256, tls_rsa_with_aes_256_gcm_sha384, tls_rsa_with_aes_128_cbc_sha256, tls_rsa_with_aes_256_cbc_sha256, tls_ecdhe_ecdsa_with_aes_128_cbc_sha, tls_ecdhe_ecdsa_with_aes_256_cbc_sha, tls_ecdhe_rsa_with_aes_128_cbc_sha, tls_ecdhe_rsa_with_aes_256_cbc_sha, tls_rsa_with_aes_128_cbc_sha, tls_rsa_with_aes_256_cbc_sha, tls_rsa_with_3des_ede_cbc_sha, tls_rsa_with_rc4_128_sha.
controller строка		Значение по умолчанию: ""	IP-адрес или имя хоста контроллера. Значение по умолчанию — переменная среды `AVI_CONTROLLER`.
description строка			Пользовательское описание объекта.
dhparam строка			Параметры DH, используемые в ssl. На данный момент они не настраиваются и установлены в 2048 бит.
enable_ssl_session_reuse логическое		Варианты: нет да	Включить повторное использование сессий ssl. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
name строка / обязательно			Имя объекта.
password строка		Значение по умолчанию: ""	Пароль пользователя Avi в контроллере Avi. Значение по умолчанию — переменная среды `AVI_PASSWORD`.
prefer_client_cipher_ordering логическое		Варианты: нет да	Предпочитать порядок шифрования ssl, представленный клиентом во время рукопожатия ssl, над указанным в профиле ssl. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как False.
send_close_notify логическое		Варианты: нет да	Отправить сообщение 'close notify' alert для чистой остановки соединения ssl. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
ssl_rating строка			Настройки sslrating для sslprofile.
ssl_session_timeout строка			Время в секундах, прежде чем сессия ssl истечет. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 86400.
state строка		Варианты: absent present ←	Состояние, которое должно быть применено к сущности.
tags строка			Список тегов.
tenant строка		Значение по умолчанию: "admin"	Имя тенента, используемого для всех вызовов API Avi и контекста объекта.
tenant_ref строка			Ссылка на объект типа tenant.
tenant_uuid строка		Значение по умолчанию: ""	UUID тенента, используемого для всех вызовов API Avi и контекста объекта.
type строка			Тип профиля ssl. Варианты перечисления — SSL_PROFILE_TYPE_APPLICATION, SSL_PROFILE_TYPE_SYSTEM. Поле введено в 17.2.8. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как SSL_PROFILE_TYPE_APPLICATION.
url строка			URL контроллера Avi для объекта.
username строка		Значение по умолчанию: ""	Имя пользователя для доступа к контроллеру Avi. Значение по умолчанию — переменная среды `AVI_USERNAME`.
uuid строка			Уникальный идентификатор объекта.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами Avi Network см. на https://www.ansible.com/ansible-avi-networks.

Примеры

- name: Create SSL profile with list of allowed ciphers
  community.network.avi_sslprofile:
    controller: '{{ controller }}'
    username: '{{ username }}'
    password: '{{ password }}'
    accepted_ciphers: >
      ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA:
      ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:
      AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:
      AES256-SHA:DES-CBC3-SHA:ECDHE-RSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:
      ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-SHA
    accepted_versions:
    - type: SSL_VERSION_TLS1
    - type: SSL_VERSION_TLS1_1
    - type: SSL_VERSION_TLS1_2
    cipher_enums:
    - TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
    - TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
    - TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
    - TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
    - TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
    - TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
    - TLS_RSA_WITH_AES_128_GCM_SHA256
    - TLS_RSA_WITH_AES_256_GCM_SHA384
    - TLS_RSA_WITH_AES_128_CBC_SHA256
    - TLS_RSA_WITH_AES_256_CBC_SHA256
    - TLS_RSA_WITH_AES_128_CBC_SHA
    - TLS_RSA_WITH_AES_256_CBC_SHA
    - TLS_RSA_WITH_3DES_EDE_CBC_SHA
    - TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
    - TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
    - TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
    - TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
    - TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
    - TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
    name: PFS-BOTH-RSA-EC
    send_close_notify: true
    ssl_rating:
      compatibility_rating: SSL_SCORE_EXCELLENT
      performance_rating: SSL_SCORE_EXCELLENT
      security_score: '100.0'
    tenant_ref: Demo

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

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

Ключ	Возвращаемое значение	Описание
obj словарь	успех, изменение	Объект SSLProfile (api/sslprofile)

Авторы

Gaurav Rastogi (@grastogi23) <grastogi@avinetworks.com>

© 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/community/network/avi_sslprofile_module.html