PaloAltoNetworks / ansible-pan

Ansible modules for Palo Alto Networks NGFWs
Other
229 stars 161 forks source link
ansible ansible-modules ngfw orchestration palo-alto-networks panw provisioning security

Deprecated

This Ansible Galaxy role is now deprecated in favor of the new Ansible collection. Please use the Ansible collection instead: https://github.com/PaloAltoNetworks/pan-os-ansible.

Palo Alto Networks Ansible modules

A collection of Ansible modules that automate configuration and operational tasks on Palo Alto Networks Next Generation Firewalls -- both physical and virtualized form factor. The underlying protocol uses API calls that are wrapped within the Ansible framework.

Role / Collection Compatibility

The Palo Alto Networks PAN-OS Ansible modules were previously distributed as an Ansible Galaxy role (https://galaxy.ansible.com/paloaltonetworks/paloaltonetworks). Since Ansible 2.9, RedHat has urged developers to migrate to collections to organize and distribute their integrations. The new collection can be found here: https://galaxy.ansible.com/paloaltonetworks/panos

The 1.0 version of this collection is a straight port of the Ansible Galaxy role v2.4.0. If you are using Ansible 2.9 or later and you are using the role, then you can safely use this instead with no change in functionality. Just specify the collections spec, remove PaloAltoNetworks.paloaltonetworks from the roles spec, and you're done!

Now that the collection is live, no new features will be added to the role. All active development will take place on the collection moving forwared. Users are encouraged to upgrade to Ansible 2.9 and start using the new collection to stay up-to-date with features and bug fixes.

Installation

The recommended way to install the modules is installing the Palo Alto Networks Ansible Galaxy role:

$ ansible-galaxy install PaloAltoNetworks.paloaltonetworks

Older modules modules are part of the default Ansible distribution which is available at:

https://github.com/ansible/ansible/tree/devel/lib/ansible/modules/network/panos

It is also available as free Apache 2.0 licensed code from Palo Alto Networks Github repo if you want to see what is coming in the next release:

https://github.com/PaloAltoNetworks/ansible-pan/

Sample playbooks

Sample playbooks can be found within this repo under:

/examples
(e.g. /examples/fw_dag.yml)

More comprehensive playbooks can be found under:

/ansible-playbooks/

Ansible galaxy role

The Palo Alto Networks Ansible modules project is a collection of Ansible modules to automate configuration and operational tasks on Palo Alto Networks Next Generation Firewalls. The underlying protocol uses API calls that are wrapped within Ansible framework.

https://github.com/PaloAltoNetworks/ansible-pan/

Support

This template/solution is released under an as-is, best effort, support policy. These scripts should be seen as community supported and Palo Alto Networks will contribute our expertise as and when possible. We do not provide technical support or help in using or troubleshooting the components of the project through our normal support options such as Palo Alto Networks support teams, or ASC (Authorized Support Centers) partners and backline support options. The underlying product used (the VM-Series firewall) by the scripts or templates are still supported, but the support is only for the product functionality and not for help in deploying or using the template or script itself.

Unless explicitly tagged, all projects or work posted in our GitHub repository (at https://github.com/PaloAltoNetworks) or sites other than our official Downloads page on https://support.paloaltonetworks.com are provided under the besteffort policy.