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

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

Обзор

Этот модуль используется для настройки объекта 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 словарь добавлен в 2.5			Контекст API Avi, включающий текущий идентификатор сеанса и токен CSRF. Это позволяет пользователю выполнить единый вход и повторно использовать сеанс.
api_version строка		По умолчанию: "16.4.4"	Версия API Avi для использования с API Avi и объектами.
avi_api_patch_op - добавлен в 2.5		Варианты: add replace delete	Операция обновления для использования при использовании avi_api_update_method как patch.
avi_api_update_method - добавлен в 2.5		Варианты: put ← patch	Метод по умолчанию для обновления объекта — HTTP PUT. Установка на patch переопределит это поведение для использования HTTP PATCH.
avi_credentials словарь добавлен в 2.5			Словарь учетных данных Avi, который можно использовать вместо перечисления данных входа в контроллер Avi.
	api_version -	По умолчанию: "16.4.4"	Версия контроллера Avi
	controller -		IP-адрес или SQDN контроллера Avi
	csrftoken -		Токен csrf API контроллера 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 булево добавлен в 2.6		Варианты: нет да	Отключает кеширование информации о сеансе 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' для чистого завершения соединения ssl. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как True.
ssl_rating -			Настройки sslrating для sslprofile.
ssl_session_timeout -			Время в секундах до истечения срока действия сеанса ssl. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как 86400.
state -		Варианты: отсутствует есть ←	Состояние, которое должно быть применено к сущности.
tags -			Список тегов.
tenant строка		По умолчанию: "admin"	Имя тенейнта, используемого для всех вызовов API Avi и контекста объекта.
tenant_ref -			Ссылка на объект типа tenant.
tenant_uuid строка		По умолчанию: ""	UUID тенейнта, используемого для всех вызовов API Avi и контекста объекта.
type - добавлен в 2.6			Тип профиля ssl. Варианты перечисления - SSL_PROFILE_TYPE_APPLICATION, SSL_PROFILE_TYPE_SYSTEM. Поле введено в 17.2.8. Значение по умолчанию, если не указано в API или модуле, интерпретируется контроллером Avi как SSL_PROFILE_TYPE_APPLICATION.
url -			URL контроллера Avi объекта.

Имя пользователя строка		По умолчанию: ""	Имя пользователя, используемое для доступа к контроллеру Avi. Значение по умолчанию — переменная среды `AVI_USERNAME`.
uuid -			Уникальный идентификатор объекта.

Примечания

Примечание

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

Примеры

- name: Create SSL profile with list of allowed ciphers
  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

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

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

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

Статус

Этот модуль не гарантирует обратную совместимость. [предварительная версия]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.9/modules/avi_sslprofile_module.html