Модуль cisco.ise.system_certificate_import – Ресурсный модуль для импорта сертификата системы

Примечание

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

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

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

Чтобы использовать его в плейбуке, укажите: cisco.ise.system_certificate_import.

Новинка в cisco.ise 1.0.0

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

Описание

Управление операцией создания ресурса Импорт сертификата системы.
Импорт сертификата X509 как сертификата системы.

Примечание

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

Требования

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

ciscoisesdk >= 2.2.3
python >= 3.5

Параметры

Параметр	Комментарии
admin boolean	Использовать сертификат для аутентификации портала администрирования Cisco ISE. Варианты: `false` `true`
allowExtendedValidity boolean	Разрешить импорт сертификатов с сроком действия более 398 дней (требуется). Варианты: `false` `true`
allowOutOfDateCert boolean	Разрешить сертификаты, срок действия которых истек (требуется). Варианты: `false` `true`
allowPortalTagTransferForSameSubject boolean	Разрешить перезапись тега портала для совпадающего сертификата с тем же субъектом. Варианты: `false` `true`
allowReplacementOfCertificates boolean	Разрешить замену сертификатов (требуется). Варианты: `false` `true`
allowReplacementOfPortalGroupTag boolean	Разрешить замену тега группы портала (требуется). Варианты: `false` `true`
allowRoleTransferForSameSubject boolean	Разрешить передачу ролей для сертификата с совпадающим субъектом. Варианты: `false` `true`
allowSHA1Certificates boolean	Разрешить сертификаты, основанные на SHA1 (требуется). Варианты: `false` `true`
allowWildCardCertificates boolean	Разрешить сертификаты с подстановкой символов. Варианты: `false` `true`
data string	Содержимое сертификата (требуется).
eap boolean	Использовать сертификат для протоколов EAP, использующих туннелирование SSL/TLS. Варианты: `false` `true`
ims boolean	Использовать сертификат для службы обмена сообщениями Cisco ISE. Варианты: `false` `true`
ise_debug boolean	Флаг для Identity Services Engine SDK для включения отладки. Варианты: `false` ← (по умолчанию) `true`
ise_hostname string / обязательно	Имя хоста Identity Services Engine.
ise_password string / обязательно	Пароль Identity Services Engine для аутентификации.
ise_single_request_timeout integer добавлен в cisco.ise 3.0.0	Время ожидания (в секундах) для RESTful HTTP-запросов. По умолчанию: `60`
ise_username string / обязательно	Имя пользователя Identity Services Engine для аутентификации.
ise_uses_api_gateway boolean добавлен в cisco.ise 1.1.0	Флаг, который сообщает SDK, использовать ли шлюз API Identity Services Engine для отправки запросов. Если значение true, используется шлюз API ISE, и запросы отправляются на https://{{ise_hostname}}. Если значение false, запросы отправляются на https://{{ise_hostname}}:{{port}}, где значение порта зависит от используемой службы (ERS, Mnt, UI, PxGrid). Варианты: `false` `true` ← (по умолчанию)

ise_uses_csrf_token boolean added in cisco.ise 3.0.0	Флаг, информирующий SDK, отправляем ли мы токен CSRF в API ERS ISE. Если True, SDK предполагает, что проверка CSRF в вашем ISE включена. Если True, предполагается, что вам нужно, чтобы SDK автоматически управлял токеном CSRF. Варианты: `false` ← (по умолчанию) `true`
ise_verify boolean	Флаг для включения или отключения проверки сертификата SSL. Варианты: `false` `true` ← (по умолчанию)
ise_version string	Уведомляет SDK, какую версию Identity Services Engine использовать. По умолчанию: `"3.1_Patch_1"`
ise_wait_on_rate_limit boolean	Флаг для Identity Services Engine SDK, чтобы включить автоматическую обработку ограничения скорости. Варианты: `false` `true` ← (по умолчанию)
name string	Имя сертификата.
password string	Пароль сертификата (обязательно).
portal boolean	Использовать для портала. Варианты: `false` `true`
portalGroupTag string	Установить метку группы.
privateKeyData string	Данные закрытого ключа (обязательно).
pxgrid boolean	Использовать сертификат для контроллера pxGrid. Варианты: `false` `true`
radius boolean	Использовать сертификат для сервера RADSec. Варианты: `false` `true`
saml boolean	Использовать сертификат для подписи SAML. Варианты: `false` `true`
validateCertificateExtensions boolean	Проверить расширения сертификата. Варианты: `false` `true`

Примечания

Примечание

Используемый метод SDK: certificates.Certificates.import_system_certificate,
Используемые пути: post /api/v1/certs/system-certificate/import,
Не поддерживает check_mode
Плагин работает на контрольном узле и не использует плагины подключения Ansible, а вместо этого использует встроенный менеджер подключений Cisco ISE SDK
Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления подключения

См. также

Документация Cisco ISE по сертификатам: Полная справка по API сертификатов.

Примеры

- name: Create
  cisco.ise.system_certificate_import:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    admin: true
    allowExtendedValidity: true
    allowOutOfDateCert: true
    allowPortalTagTransferForSameSubject: true
    allowReplacementOfCertificates: true
    allowReplacementOfPortalGroupTag: true
    allowRoleTransferForSameSubject: true
    allowSHA1Certificates: true
    allowWildCardCertificates: true
    data: string
    eap: true
    ims: true
    name: string
    password: string
    portal: true
    portalGroupTag: string
    privateKeyData: string
    pxgrid: true
    radius: true
    saml: true
    validateCertificateExtensions: true

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

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

Ключ	Описание
ise_response словарь	Словарь или список со значением, возвращенным Cisco ISE Python SDK Возвращается: всегда Пример: `{"response": {"id": "string", "message": "string", "status": "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/system_certificate_import_module.html