junipernetworks.junos.junos_acls – Модуль ресурсов ACL
Примечание
Этот плагин входит в коллекцию junipernetworks.junos (версия 1.2.1).
Для его установки используйте: ansible-galaxy collection install junipernetworks.junos.
Для использования в плейбуке укажите: junipernetworks.junos.junos_acls.
Новое в версии 1.0.0: модуля junipernetworks.junos
Обзор
- Этот модуль обеспечивает декларативное управление ACL/фильтрами на устройствах Juniper JUNOS
Примечание
У этого модуля есть соответствующий плагин действий.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ncclient (>=v0.6.4)
- xmltodict (>=0.12.0)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | ||||||
|---|---|---|---|---|---|---|---|---|
| config список / элементы=словарь | Словарь опций acls | |||||||
| acls список / элементы=словарь | Список списков управления доступом (ACL). | |||||||
| aces список / элементы=словарь | Список записей управления доступом (ACE) для данного списка управления доступом (ACL). | |||||||
| destination словарь | Указывает место назначения для фильтра. | |||||||
| address строка | Сопоставление IP адреса назначения | |||||||
| port_protocol словарь | Укажите порт назначения или протокол. | |||||||
| eq строка | Сопоставить только пакеты на заданном номере порта. | |||||||
| range словарь | Сопоставить только пакеты в диапазоне номеров портов | |||||||
| end целое число | Укажите конец диапазона портов | |||||||
| start целое число | Укажите начало диапазона портов | |||||||
| prefix_list строка | Сопоставить IP-префиксы назначения в именованном списке | |||||||
| grant строка |
| Действие, которое необходимо выполнить после сопоставления условия (разрешить, отклонить/отбросить) | ||||||
| name строка / обязательно | Имя термина фильтра | |||||||
| protocol строка | Укажите протокол для сопоставления. Обратитесь к документации поставщика для получения допустимых значений. | |||||||
| protocol_options словарь | Все возможные подопции для выбранного протокола. | |||||||
| icmp словарь | Опции протокола ICMP. | |||||||
| dod_host_prohibited логическое значение |
| Запрещённый хост | ||||||
| dod_net_prohibited логическое значение |
| Запрещённая сеть | ||||||
| echo логическое значение |
| Эхо (ping) | ||||||
| echo_reply логическое значение |
| Ответ эхо | ||||||
| host_redirect логическое значение |
| Перенаправление хоста | ||||||
| host_tos_redirect логическое значение |
| Перенаправление хоста для TOS | ||||||
| host_tos_unreachable логическое значение |
| Недоступный хост для TOS | ||||||
| host_unknown логическое значение |
| Неизвестный хост | ||||||
| host_unreachable логическое значение |
| Недоступный хост | ||||||
| net_redirect логическое значение |
| Перенаправление сети | ||||||
| net_tos_redirect логическое значение |
| Перенаправление сети для TOS | ||||||
| network_unknown логическое значение |
| Неизвестная сеть | ||||||
| port_unreachable логическое значение |
| Недоступный порт | ||||||
| protocol_unreachable логическое значение |
| Недоступный протокол | ||||||
| reassembly_timeout логическое значение |
| Тайм-аут повторного сборки | ||||||
| redirect логическое значение |
| Все перенаправления | ||||||
| router_advertisement логическое значение |
| Реклама маршрутизатора | ||||||
| router_solicitation логическое значение |
| Запросы маршрутизатора | ||||||
| source_route_failed boolean |
| Ошибка маршрутизации источника | ||||||
| time_exceeded boolean |
| Время истекло. | ||||||
| ttl_exceeded boolean |
| Превышен TTL. | ||||||
| source dictionary | Указывает источник для фильтра. | |||||||
| address string | IP-адрес источника для использования в фильтре. | |||||||
| port_protocol dictionary | Укажите порт источника или протокол. | |||||||
| eq string | Сопоставить только пакеты по указанному номеру порта. | |||||||
| range dictionary | Сопоставить только пакеты в диапазоне номеров портов | |||||||
| end integer | Укажите конец диапазона портов | |||||||
| start integer | Укажите начало диапазона портов | |||||||
| prefix_list string | Список префиксов IP-адресов источника для использования в фильтре | |||||||
| name string / required | Имя используемого фильтра acl. | |||||||
| afi string / required |
| Семейство протоколов, используемое фильтром acl. | ||||||
| state string |
| Состояние, в котором должна остаться конфигурация | ||||||
Примечания
Примечание
- Для этого модуля требуется, чтобы на управляемом устройстве была включена служба netconf.
- Этот модуль работает с подключением
netconf. См. параметры платформы Junos OS. - Проверено на JunOS v18.4R1
Примеры
# Using merged
# Before state:
# -------------
#
# admin# show firewall
- name: Merge JUNOS acl
junipernetworks.junos.junos_acls:
config:
- afi: ipv4
acls:
- name: allow_ssh_acl
aces:
- name: ssh_rule
source:
port_protocol:
eq: ssh
protocol: tcp
state: merged
# After state:
# -------------
# admin# show firewall
# family inet {
# filter allow_ssh_acl {
# term ssh_rule {
# from {
# protocol tcp;
# source-port ssh;
# }
# }
# }
# }
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| after list / elements=string | при изменении | Результат вызова модели конфигурации. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше. |
| before list / elements=string | всегда | Конфигурация до вызова модели. Пример: Возвращаемая конфигурация всегда будет в том же формате, что и параметры выше. |
| commands list / elements=string | всегда | Набор команд, отправленных на удалённое устройство. Пример: ['команда 1', 'команда 2', 'команда 3'] |
Авторы
- Daniel Mellado (@dmellado)
© 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/junipernetworks/junos/junos_acls_module.html
