Модуль cisco.ise.tacacs_command_sets – Модуль ресурсов для наборов команд TACACS

Примечание

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

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

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

Для использования в playbook укажите: cisco.ise.tacacs_command_sets.

Добавлена в cisco.ise 1.0.0

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

Обзор

Управление операциями создания, обновления и удаления ресурсов наборов команд TACACS.
Этот API создаёт наборы команд TACACS.
Этот API удаляет наборы команд TACACS.
Этот API позволяет клиенту обновлять наборы команд TACACS.

Примечание

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

Требования

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

ciscoisesdk >= 2.2.3
python >= 3.5

Параметры

Параметр	Комментарии
commands словарь	Команды наборов команд TACACS.
commandList список / элементы=словарь	Список команд наборов команд TACACS.
arguments строка	Аргументы наборов команд TACACS.
command строка	Команда наборов команд TACACS.
grant строка	Допустимые значения PERMIT, DENY, DENY_ALWAYS.
description строка	Описание наборов команд TACACS.
id строка	Идентификатор наборов команд TACACS.
ise_debug булево	Флаг для включения отладки Identity Services Engine SDK. Выборы: `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 для отправки запросов. Если значение true, используется шлюз API ISE, и запросы отправляются по адресу https://{{ise_hostname}}. Если значение false, запросы отправляются по адресу https://{{ise_hostname}}:{{port}}, где значение порта зависит от используемой службы (ERS, Mnt, UI, PxGrid). Выборы: `false` `true` ← (по умолчанию)
ise_uses_csrf_token булево добавлен в cisco.ise 3.0.0	Флаг, который сообщает SDK, отправлять ли токен CSRF в ERS API ISE. Если значение True, SDK предполагает, что проверка CSRF ISE включена. Если значение True, предполагается, что 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` ← (по умолчанию)
name строка	Имя наборов команд TACACS.
permitUnmatched булево	Флаг permitUnmatched. Выборы: `false` `true`

Примечания

Примечание

Используемые методы SDK: tacacs_command_sets.TacacsCommandSets.create_tacacs_command_sets, tacacs_command_sets.TacacsCommandSets.delete_tacacs_command_sets_by_id, tacacs_command_sets.TacacsCommandSets.update_tacacs_command_sets_by_id,
Используемые пути: post /ers/config/tacacscommandsets, delete /ers/config/tacacscommandsets/{id}, put /ers/config/tacacscommandsets/{id},
Не поддерживает check_mode
Плагин работает на узле управления и не использует плагины подключения ansible, а вместо этого встроенный менеджер подключений из Cisco ISE SDK
Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления соединения

Примеры

- name: Update by id
  cisco.ise.tacacs_command_sets:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    commands:
      commandList:
      - arguments: string
        command: string
        grant: string
    description: string
    id: string
    name: string
    permitUnmatched: true

- name: Delete by id
  cisco.ise.tacacs_command_sets:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: absent
    id: string

- name: Create
  cisco.ise.tacacs_command_sets:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    commands:
      commandList:
      - arguments: string
        command: string
        grant: string
    description: string
    name: string
    permitUnmatched: true

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

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

Ключ	Описание
ise_response словарь	Словарь или список со значением, возвращенным Cisco ISE Python SDK Возвращается: всегда Пример: `{"commands": {"commandList": [{"arguments": "string", "command": "string", "grant": "string"}]}, "description": "string", "id": "string", "link": {"href": "string", "rel": "string", "type": "string"}, "name": "string", "permitUnmatched": true}`
ise_update_response словарь добавлено в cisco.ise 1.1.0	Словарь или список со значением, возвращенным Cisco ISE Python SDK Возвращается: всегда Пример: `{"UpdatedFieldsList": {"field": "string", "newValue": "string", "oldValue": "string", "updatedField": [{"field": "string", "newValue": "string", "oldValue": "string"}]}}`

Ключ

Описание

ise_response

словарь

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

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

Пример: {"commands": {"commandList": [{"arguments": "string", "command": "string", "grant": "string"}]}, "description": "string", "id": "string", "link": {"href": "string", "rel": "string", "type": "string"}, "name": "string", "permitUnmatched": true}

ise_update_response

словарь

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

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

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

Пример: {"UpdatedFieldsList": {"field": "string", "newValue": "string", "oldValue": "string", "updatedField": [{"field": "string", "newValue": "string", "oldValue": "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/tacacs_command_sets_module.html