cisco.asa.asa_acl – (устаревший, удалён после 2022-06-01) Управление списками доступа на Cisco ASA

Примечание

Этот плагин входит в состав коллекции cisco.asa (версия 1.0.4).

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

Для использования в плейбуке укажите: cisco.asa.asa_acl.

Новое в версии 1.0.0: из cisco.asa

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

УСТАРЕЛО

Удалено в: главной версии после 2022-06-01
Почему: Выпущены новые и обновлённые модули с большей функциональностью в Ansible 2.10
Альтернатива: asa_acl

Обзор

Этот модуль позволяет работать со списками доступа на устройстве Cisco ASA.

Примечание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
after список / элементы=строка			Упорядоченный набор команд, которые нужно добавить в конец стека команд, если требуется внесение изменений. Точно так же, как и в случае с before, это позволяет разработчику плейбука добавить набор команд, которые будут выполнены после набора команд.
authorize логическое значение		Варианты: нет ← да	Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` и `become: yes`. Для получения дополнительной информации см. Руководство по сетям. Указывает модулю войти в привилегированный режим на удалённом устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
before список / элементы=строка			Упорядоченный набор команд, которые нужно поместить в стек команд, если требуется изменение. Это позволяет разработчику плейбука выполнить команды конфигурации перед внесением любых изменений без влияния на способ сопоставления набора команд с системой.
config строка			Модуль по умолчанию подключается к удалённому устройству и получает текущую конфигурацию, чтобы использовать её в качестве основы для сравнения с содержимым источника. Бывают случаи, когда нежелательно получать текущую конфигурацию для каждой задачи в плейбуке. Параметр config позволяет реализатору указать конфигурацию для использования в качестве базовой конфигурации для сравнения.
context строка			Указывает, какой контекст использовать, если вы работаете в режиме нескольких контекстов на ASA. По умолчанию используется текущий контекст, в который вы вошли.
force логическое значение		Варианты: нет ← да	Параметр force указывает модулю не учитывать текущую конфигурацию устройства. Если установлено в значение true, модуль отправит содержимое src на устройство без предварительной проверки, настроено ли оно уже.
lines список / элементы=строка / обязательно			Упорядоченный набор команд, которые должны быть настроены в разделе. Команды должны быть идентичными командам, найденным в конфигурации устройства. Обратите внимание на синтаксис команд конфигурации, так как некоторые команды автоматически изменяются анализатором конфигурации устройства. псевдонимы: команды
match строка		Варианты: строка ← строго точно	Указывает модулю, как выполнять сопоставление набора команд с текущей конфигурацией устройства. Если match установлено в строка, команды сопоставляются построчно. Если match установлено в строго, строки команд сопоставляются с учётом позиции. Наконец, если match установлено в точно, строки команд должны совпадать точно.
passwords логическое значение		Варианты: нет да	Указывает, какой контекст использовать, если вы работаете в режиме нескольких контекстов на ASA. По умолчанию используется текущий контекст, в который вы вошли.
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Для получения дополнительной информации см. Руководство по сетям. Объект словаря, содержащий данные подключения.
	auth_pass строка		Указывает пароль, который нужно использовать для входа в привилегированный режим на удалённом устройстве. Если authorize false, то этот аргумент ничего не делает. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize логическое значение	Варианты: нет ← да	Указывает модулю войти в привилегированный режим на удалённом устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	host строка		Указывает имя хоста DNS или адрес для подключения к удалённому устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port целое число		Указывает порт для подключения к удалённому устройству.
	ssh_keyfile путь		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает время ожидания бездействия соединения в секундах. Полезно, если консоль зависает перед продолжением. Например, при сохранении конфигураций.
	username строка		Указывает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_USERNAME`.
replace строка		Варианты: строка ← блок	Указывает модулю, как выполнить конфигурацию на устройстве. Если параметр replace установлен в строка, изменённые строки передаются на устройство в режиме конфигурации. Если параметр replace установлен в блок, весь блок команд передаётся на устройство в режиме конфигурации, если хотя бы одна строка неверна.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в Руководстве по сетям Ansible

Примеры

- cisco.asa.asa_acl:
    lines:
    - access-list ACL-ANSIBLE extended permit tcp any any eq 82
    - access-list ACL-ANSIBLE extended permit tcp any any eq www
    - access-list ACL-ANSIBLE extended permit tcp any any eq 97
    - access-list ACL-ANSIBLE extended permit tcp any any eq 98
    - access-list ACL-ANSIBLE extended permit tcp any any eq 99
    before: clear configure access-list ACL-ANSIBLE
    match: strict
    replace: block
    provider: '{{ cli }}'

- cisco.asa.asa_acl:
    lines:
    - access-list ACL-OUTSIDE extended permit tcp any any eq www
    - access-list ACL-OUTSIDE extended permit tcp any any eq https
    context: customer_a
    provider: '{{ cli }}'

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

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

Ключ	Возвращаемое значение	Описание
updates список / элементы=строка	всегда	Набор команд, которые будут отправлены на удалённое устройство Пример: ['access-list ACL-OUTSIDE extended permit tcp any any eq www']

Статус

Этот модуль будет удалён в следующей крупной версии после 2022-06-01. [устарел]
Для получения дополнительной информации см. УСТАРЕЛО.

Авторы

Patrick Ogenstad (@ogenstad)

© 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/cisco/asa/asa_acl_module.html