firewalld - Управление произвольными портами/службами с firewalld
Новая версия 1.4.
Обзор
- Этот модуль позволяет добавлять или удалять службы и порты TCP или UDP в активных или постоянных правилах firewalld.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- firewalld >= 0.2.11
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| immediate (добавлен в 1.9) | Значение по умолчанию: нет | Должна ли эта конфигурация применяться немедленно, если она постоянна? |
| interface (добавлен в 2.1) | Значение по умолчанию: Нет | Интерфейс, к которому вы хотите добавить/удалить зону в firewalld |
| masquerade (добавлен в 2.1) | Значение по умолчанию: Нет | Настройка маскировки, которую вы хотите включить/отключить для зон в firewalld |
| permanent | Значение по умолчанию: Нет | Должна ли эта конфигурация находиться в активной конфигурации firewalld или сохраняться после перезагрузки. Начиная с Ansible версии 2.3, операции permanent могут работать с конфигурациями firewalld, когда он не запущен (требуется firewalld >= 3.0.9). (ПРИМЕЧАНИЕ: Если это ложь, предполагается, что immediate — истина.) |
| port | Значение по умолчанию: Нет | Имя порта или диапазона портов для добавления/удаления в/из firewalld. Должно быть в формате PORT/PROTOCOL или PORT-PORT/PROTOCOL для диапазонов портов. |
| rich_rule | Значение по умолчанию: Нет | Богатое правило для добавления/удаления в/из firewalld. |
| service | Значение по умолчанию: Нет | Имя службы для добавления/удаления в/из firewalld — служба должна быть указана в выводе firewall-cmd --get-services. |
| source (добавлен в 2.0) | Значение по умолчанию: Нет | Источник/сеть, которую вы хотите добавить/удалить в/из firewalld |
| state требуется |
| Включить или отключить настройку. Для портов: Должен ли этот порт принимать (включено) или отклонять (выключено) подключения. Состояния "есть" и "отсутствует" могут использоваться только в операциях на уровне зоны (т. е. когда не установлены другие параметры, кроме зоны и состояния). |
| timeout | Значение по умолчанию: 0 | Время действия правила при не постоянных настройках. |
| zone |
системный-по-умолчанию(общедоступный) | Зона firewalld для добавления/удаления (ПРИМЕЧАНИЕ: зона по умолчанию может быть настроена на каждом системе, но «общедоступная» является значением по умолчанию из исходного кода. Доступный выбор может быть расширен в зависимости от конфигураций каждой системы, перечисленные здесь - это значения по умолчанию «из коробки»). |
Примечания
Примечание
- Не тестировался на системах на основе Debian.
- Требуются python2 bindings firewalld, которые могут быть не установлены по умолчанию, если дистрибутив перешёл на python 3
- Транзакции зон (создание, удаление) могут выполняться, используя только параметры зоны и состояния «есть» или «отсутствует». Обратите внимание, что транзакции зон должны быть явно постоянными. Это ограничение в firewalld. Это также означает, что вам нужно будет перезагрузить firewalld после добавления зоны, для которой вы хотите выполнить немедленные действия. Модуль не позаботится об этом неявно, поскольку это отменит любые ранее выполненные немедленные действия, которые не были постоянными. Поэтому, если вам требуется немедленный доступ к недавно созданной зоне, рекомендуется перезагрузить firewalld сразу после того, как функция создания зоны вернёт данные со изменившимся состоянием, и прежде чем вы выполните любые другие немедленные, непостоянные действия в этой зоне.
Примеры
- firewalld:
service: https
permanent: true
state: enabled
- firewalld:
port: 8081/tcp
permanent: true
state: disabled
- firewalld:
port: 161-162/udp
permanent: true
state: enabled
- firewalld:
zone: dmz
service: http
permanent: true
state: enabled
- firewalld:
rich_rule: 'rule service name="ftp" audit limit value="1/m" accept'
permanent: true
state: enabled
- firewalld:
source: 192.0.2.0/24
zone: internal
state: enabled
- firewalld:
zone: trusted
interface: eth2
permanent: true
state: enabled
- firewalld:
masquerade: yes
state: enabled
permanent: true
zone: dmz
- firewalld:
zone: custom
state: present
permanent: true
Состояние
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Автор
- Adam Miller (@maxamillion)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 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/firewalld_module.html
