fortinet.fortisase:1.1.0 - configuring FortiSASE

Description

FortiSASE Ansible Collection includes the modules that are able to configure FortiSASE.

Documentation for the collection.

Requirements

• Ansible Core 2.16.0 or above.
• Python 3.10 or above.

Installation

Before using this collection, you need to install it with the Ansible Galaxy command-line tool:

ansible-galaxy collection install fortinet.fortisase

You can also include it in a requirements.yml file and install it with ansible-galaxy collection install -r requirements.yml, using the format:

collections:
  - name: fortinet.fortisase

To upgrade the collection to the latest available version, run the following command:

ansible-galaxy collection install fortinet.fortisase --upgrade

You can also install a specific version of the collection. Use the following syntax to install version 1.0.0:

ansible-galaxy collection install fortinet.fortisase:==1.0.0

See using Ansible collections for more details.

Use Cases

Create a file named hosts:

[fortisase]
public_cloud ansible_host=portal.prod.fortisase.com
# private_cloud ansible_host=<your_private_cloud_address>

[fortisase:vars]
ansible_network_os=fortinet.fortisase.fortisase
ansible_connection=httpapi
ansible_facts_modules=setup
ansible_httpapi_port=443
ansible_httpapi_use_ssl=true
ansible_httpapi_validate_certs=false
# Authentication credentials (Specify the username and password in the inventory file or in environment variables)
# ansible_user="ABCDEFGHIJKLMNOPQRSTUVWXYZ" # You can also specify the username in environment variable FORTISASE_USERNAME
# ansible_password="123123123123123!1Aa" # You can also specify the password in environment variable FORTISASE_PASSWORD

Create a file named test.yml:

- name: Get FortiSASE Facts
  hosts: fortisase
  gather_facts: false
  tasks:
    - name: Query one network dns rule
      fortinet.fortisase.fortisase_facts:
        selector: "network_dns_rules"
        params:
          primaryKey: "1"
    - name: Query all network dns rules
      fortinet.fortisase.fortisase_facts:
        selector: "network_dns_rules"
        params:
          primaryKey: null

Run the playbook:

ansible-playbook -i hosts test.yml

See example here to run your first playbook.

Testing

Testing is done by the Fortinet team.

Support

As Red Hat Ansible Certified Content, this collection is entitled to support through the Ansible Automation Platform (AAP) using the Create issue button on the top right corner. If a support case cannot be opened with Red Hat and the collection has been obtained either from Galaxy or GitHub, there may community help available on the Ansible Forum.

Release Notes and Roadmap

Please check release note here.

FortiSASE Ansible is expected to be updated every two months.

Related Information

Documentation for the collection.

Modules

The collection provides the following modules:

License Information

FortiAnalyzer Ansible Collection follows GNU General Public License v3.0.