Open firewall ports in RedHat-like systems - Ansible module firewalld

How to open firewall ports in RedHat-like systems with Ansible?

I'm going to show you a live Playbook and some simple Ansible code.

I'm Luca Berton and welcome to today's episode of Ansible Pilot.

Ansible open firewall ports in RedHat-like systems

Today we're talking about the Ansible module firewalld.

The full name is ansible.posix.firewalld, which means that is part of the collection targeting POSIX platforms. This module requires Ansible 2.9+.

It works in RedHat-like systems with firewalld >= 0.2.11 and python firewalld bindings.

It manages arbitrary ports/services with firewalld.

Parameters

state _string_ - enabled / present / absent / disabled

service _string_ - firewall-cmd - get-services

port _string_ - PORT/PROTOCOL or PORT-PORT/PROTOCOL

permanent _boolean_ - no/yes

immediate _boolean_ - no/yes

The parameter list is pretty wide but these are the most important options for our use case to open firewall ports.

The "state" parameter is mandatory and specifies to enable or disable a setting.

The options "enabled" accept and "disabled" reject connections for ports.

The options "present" and "absent" are for zone-level operations.

The "service" parameter specifies the name of a service to add/remove to/from firewalld. For the full list please use "firewall-cmd - get-services".

The "port" parameter specifies the name of a port or port range to add/remove to/from firewalld. The format is PORT/PROTOCOL so for example 80/TCP for HTTP connections. You could also specify a range with PORT-PORT/PROTOCOL.

The "permanent" parameter defines if the configuration should persist across reboots. Note that if "permanent" is no, "immediate" is assumed yes.

The "immediate" parameter applies immediately to the configuration of the system.

## Playbook

Let's jump in a real-life Playbook about how to open firewall ports in RedHat-like systems with Ansible Playbook.

verify-firewall.sh

``bash


firewall-cmd --state
systemctrl status firewalld
firewall-cmd --list-all
firewall-cmd --list-services
dnf info nginx



firewalld.yml

`yaml


---
name: firewalld module Playbook
  hosts: all
  become: true
  tasks:
name: nginx installed
      ansible.builtin.yum:
        name: nginx
        state: present
name: firewalld rules
      ansible.posix.firewalld:
        service: "{{ item }}"
        state: enabled
        permanent: true
        immediate: true
      with_items:
        - http
        - https

[code with ❤️ in GitHub](https://github.com/lucab85/ansible-pilot/tree/master/open%20firewall%20ports)

Conclusion

Now you know how to open firewall ports in RedHat-like systems with Ansible.