cisco.ise.ipsec модуль — Модуль ресурсов для Ipsec

Примечание

Этот модуль является частью коллекции cisco.ise (версия 2.9.3).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install cisco.ise. Для использования этого модуля потребуются дополнительные требования, см. Требования для получения подробностей.

Для использования в книге задач укажите: cisco.ise.ipsec.

Новая в cisco.ise 1.0.0

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

Обзор

Управление операциями создания и обновления ресурса Ipsec.
Создаёт соединение IPsec.
Обновляет конфигурацию существующего соединения IPsec.

Примечание

Этот модуль имеет соответствующий плагин действий.

Требования

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

ciscoisesdk >= 2.2.3
python >= 3.5

Параметры

Параметр	Комментарии
authType строка	Тип аутентификации для установления соединения.
certId строка	Идентификатор сертификата для установления соединения.
configureVti логическое значение	Тип аутентификации для установления соединения. Варианты: `false` `true`
espAhProtocol строка	Протокол шифрования, используемый для установления соединения.
hostName строка	Имя узла.
iface строка	Ethernet-порт узла.
ikeReAuthTime целое число	Время повторной аутентификации IKE.
ikeVersion строка	Версия IKE.
ise_debug логическое значение	Флаг для включения отладки в SDK Identity Services Engine. Варианты: `false` ← (по умолчанию) `true`
ise_hostname строка / обязательно	Имя хоста Identity Services Engine.
ise_password строка / обязательно	Пароль Identity Services Engine для аутентификации.
ise_single_request_timeout целое число добавлено в cisco.ise 3.0.0	Таймаут (в секундах) для запросов RESTful HTTP. По умолчанию: `60`
ise_username строка / обязательно	Имя пользователя Identity Services Engine для аутентификации.
ise_uses_api_gateway логическое значение добавлено в cisco.ise 1.1.0	Флаг, информирующий SDK, использовать ли API шлюз Identity Services Engine для отправки запросов. Если значение истинно, используется API шлюз ISE, и запросы отправляются по адресу https://{{ise_hostname}}. Если ложно, запросы отправляются по адресу https://{{ise_hostname}}:{{port}}, где значение порта зависит от используемой службы (ERS, Mnt, UI, PxGrid). Варианты: `false` `true` ← (по умолчанию)
ise_uses_csrf_token логическое значение добавлено в cisco.ise 3.0.0	Флаг, информирующий SDK, нужно ли отправлять токен CSRF в API ISE ERS. Если значение истинно, SDK предполагает, что проверка CSRF в ISE включена. Если значение истинно, предполагается, что SDK должен автоматически управлять токеном CSRF. Варианты: `false` ← (по умолчанию) `true`
ise_verify логическое значение	Флаг для включения или отключения проверки сертификата SSL. Варианты: `false` `true` ← (по умолчанию)
ise_version строка	Информирует SDK о версии Identity Services Engine, которую использовать. По умолчанию: `"3.1_Patch_1"`
ise_wait_on_rate_limit логическое значение	Флаг для включения автоматической обработки ограничения скорости в Identity Services Engine SDK. Варианты: `false` `true` ← (по умолчанию)
localInternalIp строка	Локальный внутренний IP-адрес туннеля.
modeOption строка	Тип режима, используемый для установления соединения.
nadIp строка	IP-адрес NAD для установления соединения.
phaseOneDHGroup строка	Группа DH первой фазы, используемая для установления соединения.

END_OF_DOCUMENT_MARKER

алгоритм шифрования фазы 1 строка	Алгоритм шифрования первой фазы, используемый для установления соединения.
алгоритм хеширования фазы 1 строка	Алгоритм хеширования первой фазы, используемый для установления соединения.
время жизни соединения фазы 1 целое число	Время жизни соединения первой фазы.
группа DH второй фазы строка	Группа DH второй фазы, используемая для установления соединения.
алгоритм шифрования фазы 2 строка	Алгоритм шифрования второй фазы, используемый для установления соединения.
алгоритм хеширования фазы 2 строка	Алгоритм хеширования второй фазы, используемый для установления соединения.
время жизни соединения фазы 2 целое число	Время жизни соединения второй фазы.
предварительный общий ключ (PSK) строка	Предварительный общий ключ, используемый для установления соединения.
внутренний IP-адрес удаленного узла строка	IP-адрес удалённого туннеля.

Примечания

Примечание

Используемые методы SDK: native_ipsec.NativeIpsec.create_ipsec_connection, native_ipsec.NativeIpsec.update_ipsec_connection_config,
Используемые пути: post /api/v1/ipsec, put /api/v1/ipsec,
Не поддерживает check_mode
Плагин работает на узле управления и не использует плагины подключения ansible, а вместо этого использует встроенный диспетчер подключений из Cisco ISE SDK
Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления соединения

Примеры

- name: Update all
  cisco.ise.ipsec:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    authType: string
    certId: string
    configureVti: true
    espAhProtocol: string
    hostName: string
    iface: string
    ikeReAuthTime: 0
    ikeVersion: string
    localInternalIp: string
    modeOption: string
    nadIp: string
    phaseOneDHGroup: string
    phaseOneEncryptionAlgo: string
    phaseOneHashAlgo: string
    phaseOneLifeTime: 0
    phaseTwoDHGroup: string
    phaseTwoEncryptionAlgo: string
    phaseTwoHashAlgo: string
    phaseTwoLifeTime: 0
    psk: string
    remotePeerInternalIp: string

- name: Create
  cisco.ise.ipsec:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    authType: string
    certId: string
    configureVti: true
    espAhProtocol: string
    hostName: string
    iface: string
    ikeReAuthTime: 0
    ikeVersion: string
    localInternalIp: string
    modeOption: string
    nadIp: string
    phaseOneDHGroup: string
    phaseOneEncryptionAlgo: string
    phaseOneHashAlgo: string
    phaseOneLifeTime: 0
    phaseTwoDHGroup: string
    phaseTwoEncryptionAlgo: string
    phaseTwoHashAlgo: string
    phaseTwoLifeTime: 0
    psk: string
    remotePeerInternalIp: string

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

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

Ключ	Описание
ответ_ise список / элементы=словарь	Словарь или список с ответом, возвращённым Cisco ISE Python SDK Возвращается: всегда Пример: "[\n {\n \"authType\": \"string\",\n \"certId\": \"string\",\n \"configureVti\": true,\n \"createTime\": \"string\",\n \"espAhProtocol\": \"string\",\n \"hostName\": \"string\",\n \"id\": \"string\",\n \"iface\": \"string\",\n \"ikeReAuthTime\": 0,\n \"ikeVersion\": \"string\",\n \"localInternalIp\": \"string\",\n \"modeOption\": \"string\",\n \"nadIp\": \"string\",\n \"phaseOneDHGroup\": \"string\",\n \"phaseOneEncryptionAlgo\": \"string\",\n \"phaseOneHashAlgo\": \"string\",\n \"phaseOneLifeTime\": 0,\n \"phaseTwoDHGroup\": \"string\",\n \"phaseTwoEncryptionAlgo\": \"string\",\n \"phaseTwoHashAlgo\": \"string\",\n \"phaseTwoLifeTime\": 0,\n \"psk\": \"string\",\n \"remotePeerInternalIp\": \"string\",\n \"status\": \"string\",\n \"updateTime\": \"string\"\n }\n]\n"
ответ_ise_обновления словарь добавлен в cisco.ise 1.1.0	Словарь или список с ответом, возвращённым Cisco ISE Python SDK Возвращается: всегда Пример: {"response": {"authType": "string", "certId": "string", "configureVti": true, "createTime": "string", "espAhProtocol": "string", "hostName": "string", "id": "string", "iface": "string", "ikeReAuthTime": 0, "ikeVersion": "string", "link": {"href": "string", "rel": "string", "type": "string"}, "localInternalIp": "string", "modeOption": "string", "nadIp": "string", "phaseOneDHGroup": "string", "phaseOneEncryptionAlgo": "string", "phaseOneHashAlgo": "string", "phaseOneLifeTime": 0, "phaseTwoDHGroup": "string", "phaseTwoEncryptionAlgo": "string", "phaseTwoHashAlgo": "string", "phaseTwoLifeTime": 0, "psk": "string", "remotePeerInternalIp": "string", "status": "string", "updateTime": "string"}, "version": "string"}

Ключ

Описание

ответ_ise

список / элементы=словарь

Словарь или список с ответом, возвращённым Cisco ISE Python SDK

Возвращается: всегда

Пример: "[\n {\n \"authType\": \"string\",\n \"certId\": \"string\",\n \"configureVti\": true,\n \"createTime\": \"string\",\n \"espAhProtocol\": \"string\",\n \"hostName\": \"string\",\n \"id\": \"string\",\n \"iface\": \"string\",\n \"ikeReAuthTime\": 0,\n \"ikeVersion\": \"string\",\n \"localInternalIp\": \"string\",\n \"modeOption\": \"string\",\n \"nadIp\": \"string\",\n \"phaseOneDHGroup\": \"string\",\n \"phaseOneEncryptionAlgo\": \"string\",\n \"phaseOneHashAlgo\": \"string\",\n \"phaseOneLifeTime\": 0,\n \"phaseTwoDHGroup\": \"string\",\n \"phaseTwoEncryptionAlgo\": \"string\",\n \"phaseTwoHashAlgo\": \"string\",\n \"phaseTwoLifeTime\": 0,\n \"psk\": \"string\",\n \"remotePeerInternalIp\": \"string\",\n \"status\": \"string\",\n \"updateTime\": \"string\"\n }\n]\n"

ответ_ise_обновления

словарь

добавлен в cisco.ise 1.1.0

Словарь или список с ответом, возвращённым Cisco ISE Python SDK

Возвращается: всегда

Пример: {"response": {"authType": "string", "certId": "string", "configureVti": true, "createTime": "string", "espAhProtocol": "string", "hostName": "string", "id": "string", "iface": "string", "ikeReAuthTime": 0, "ikeVersion": "string", "link": {"href": "string", "rel": "string", "type": "string"}, "localInternalIp": "string", "modeOption": "string", "nadIp": "string", "phaseOneDHGroup": "string", "phaseOneEncryptionAlgo": "string", "phaseOneHashAlgo": "string", "phaseOneLifeTime": 0, "phaseTwoDHGroup": "string", "phaseTwoEncryptionAlgo": "string", "phaseTwoHashAlgo": "string", "phaseTwoLifeTime": 0, "psk": "string", "remotePeerInternalIp": "string", "status": "string", "updateTime": "string"}, "version": "string"}

Авторы

Rafael Campos (@racampos)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/ise/ipsec_module.html