asa_acl — Управление списками доступа на Cisco ASA

Новое в версии 2.2.

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

Обзор

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

Параметры

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

Примечания

Примечание

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

Примеры

# Note: examples below use the following provider dict to handle
#       transport and authentication to the node.
---
vars:
  cli:
    host: "{{ inventory_hostname }}"
    username: cisco
    password: cisco
    transport: cli
    authorize: yes
    auth_pass: cisco

---
- 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 }}"

- 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']

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Автор

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.5/modules/asa_acl_module.html