...
Itential Platform Pricing Explore flexible plans and options for your team
Itential logo

Fortinet FortiGate – Studio Project

Studio Project workflows for FortiGate golden config compliance, interface configuration, and backup/config snapshot

FortiGate is Fortinet's network security appliance line, providing firewall, VPN, and routing functionality configured either via CLI (SSH) or the FortiOS REST API.

This project provides two ways to automate against FortiGate: netmiko over SSH/CLI (the same pattern used for Cisco IOS and Arista EOS), or a custom IG5 device driver over the FortiOS REST API for HTTP-based access — see Inventory Manager Configuration below.

Requirements: Itential Platform >= 6.4 · Itential Gateway >= 5.0 (only if using the fortigate-rest device driver)

Table of Contents

Contents

Asset Description
device-drivers/fortigate-rest IG5 Python FortiOS REST driver — is-alive, get-config, plus a generic REST passthrough
Configuration Parsers/fortios.json Config Manager parser defining the fortios device type
Golden Configurations/FortiGate - Simple Golden config tree covering admin access, password policy, NTP, syslog, and interface hardening — requires the fortios parser
Studio Projects/FortiGate 4 workflows — golden config compliance, interface configuration (with pre/post checks and diff), interface reset, and backup/config snapshot

Inventory Manager Configuration

FortiGate devices can be automated two ways. Pick per device based on whether you want CLI (SSH) or REST (FortiOS API) access — both can coexist across different nodes in the same inventory.

Option 1: netmiko (SSH/CLI)

Itential Platform ships with a netmiko driver for FortiGate out of the box — no additional driver install required. Broker actions (is-alive, run-command, get-config, set-config) are wired automatically when the inventory is created with createBrokerActions: true, the same as Cisco IOS and Arista EOS.

{
  "name": "my-fortigate-device",
  "attributes": {
    "itential_host": "192.0.2.200",
    "itential_port": 22,
    "itential_driver": "netmiko",
    "itential_platform": "fortinet",
    "itential_user": "admin",
    "itential_password": "changeme"
  }
}
Attribute Type Description
itential_host string Management IP or hostname of the device
itential_port integer SSH port (default: 22)
itential_driver string Driver to use — must be netmiko
itential_platform string Netmiko device type — fortinet for FortiOS
itential_user string SSH username
itential_password string SSH password

Option 2: fortigate-rest (FortiOS REST API over HTTP)

Use this instead of netmiko when you want HTTP-based access to FortiGate's REST API rather than SSH/CLI — no SSH access required, and all operations go over HTTPS to the management interface. Requires the fortigate-rest device driver registered in Itential Gateway 5.x.

See device-drivers/fortigate-rest/README.md for full setup details, the API-token authentication model, and a generic REST passthrough (fortigate-rest-call) for calling any FortiOS REST endpoint directly from a workflow.

Node attributes:

{
  "name": "fortigate-01",
  "attributes": {
    "itential_host": "192.0.2.200",
    "itential_port": 443,
    "itential_driver": "fortigate-rest",
    "itential_password": "<FortiOS API token>",
    "itential_driver_options": {
      "fortigate-rest": {
        "vdom": "root",
        "verify_ssl": false,
        "timeout": 30,
        "backup_scope": "global"
      }
    }
  }
}

Action mapping — wire the supported broker contracts to this driver's IG5 services, replacing cluster-itential with your own cluster_id:

[
  {
    "name": "is-alive",
    "action_type": "iag5-service",
    "action_config": {
      "service_name": "fortigate-rest-is-alive",
      "cluster_id": "cluster-itential"
    },
    "action_parameters": {}
  },
  {
    "name": "get-config",
    "action_type": "iag5-service",
    "action_config": {
      "service_name": "fortigate-rest-get-config",
      "cluster_id": "cluster-itential"
    },
    "action_parameters": {}
  }
]

Choosing API vs SSH — and a Hybrid Setup

FortiOS's REST API is a structured, object-model interface (/api/v2/cmdb/*, /api/v2/monitor/*) — Fortinet's own support guidance is explicit that it isn't a CLI replacement, so it has no endpoint for executing arbitrary commands. That's a deliberate product design choice, not a driver limitation: fortigate-rest implements is-alive and get-config faithfully, but can't offer real run-command/set-config broker actions. Only SSH/CLI gives you those.

Use fortigate-rest (REST/API) when:

  • SSH access to the management interface isn't available or is restricted by policy.
  • You want structured JSON responses instead of parsing CLI text output.
  • You're doing targeted object-level changes — firewall policies, addresses, and similar cmdb objects — via fortigate-rest-call.
  • You want a lighter-weight reachability check or config snapshot without opening a CLI session.

Use netmiko (SSH/CLI) when:

  • You need arbitrary operational commands (run-command) or Config Manager CLI-diff remediation (set-config).
  • You need CLI-only functionality that has no cmdb REST equivalent.

Hybrid — no broker override needed (recommended for most deployments): fortigate-rest's connection resolution (main.py) reads itential_host, itential_password, and itential_driver_options.fortigate-rest.* directly off the node — it never looks at the node's top-level itential_driver or its actions array. That means a single node can be set up as Option 1 (itential_driver: netmiko, broker actions auto-wired for Config Manager/generic device operations) and also carry an itential_driver_options.fortigate-rest block for the REST token/settings:

{
  "name": "fortigate-01",
  "attributes": {
    "itential_host": "192.0.2.200",
    "itential_port": 22,
    "itential_driver": "netmiko",
    "itential_platform": "fortinet",
    "itential_user": "admin",
    "itential_password": "changeme",
    "itential_driver_options": {
      "fortigate-rest": {
        "api_token": "<FortiOS API token>",
        "vdom": "root",
        "verify_ssl": false
      }
    }
  }
}

Note the api_token override here — itential_password is already doing double duty as the SSH password for netmiko, so the REST token (a separate credential in FortiOS) goes in itential_driver_options.fortigate-rest.api_token instead. With this in place, a Studio Project workflow can call fortigate-rest-is-alive, fortigate-rest-get-config, or fortigate-rest-call as an Automation Gateway task against this same node at any time, resolving host/token from these attributes — independent of whatever the node's broker actions are wired to. No changes to the actions array, and no second node needed.

Hybrid — broker-level override: only reach for this if you specifically want the platform's own broker-driven features (Config Manager compliance/backup, generic device get-config/is-alive calls) to use REST instead of CLI, rather than just calling the service directly from a workflow:

  1. Create the node with itential_driver: netmiko / itential_platform: fortinet (Option 1) so Itential Platform auto-wires all four broker actions via createBrokerActions: true.
  2. In Inventory Manager, edit just the is-alive and get-config action entries to override their action_config to fortigate-rest-is-alive / fortigate-rest-get-config (Option 2's services) instead.
  3. Leave run-command and set-config on their auto-generated netmiko mapping, since those need CLI access anyway.

This still requires the same itential_driver_options.fortigate-rest block as above.

Device Drivers

fortigate-rest

A native Python FortiOS REST driver for IG5. Use this for HTTP-based FortiGate automation instead of SSH/CLI — useful when SSH access to the management interface isn't available, or when you'd rather work directly against FortiOS REST endpoints from a workflow.

See device-drivers/fortigate-rest/README.md for full documentation including all operations, the API-token authentication model, and local testing. That README also has the Inventory Manager action mapping JSON needed to wire the broker contracts (is-alive, get-config) to this driver's IG5 services.

Deploying this driver: copy device-drivers/fortigate-rest/ into your own automation repo — the one Itential Gateway already tracks, or a new one dedicated to your drivers. Don't add this repo (itential/assets) as an Itential Gateway repositories source just to pull one driver; that clones the entire community assets repo, which is unnecessarily large for a single driver.

After copying, update the repositories entry and working-directory paths in import.yaml to point at your own repo, then either:

iagctl db import import.yaml --force

or copy just the services/decorators blocks into your Itential Gateway's existing import.yaml.

Dependencies: requests>=2.28.0

Configuration Parsers

fortios

Defines the fortios device type in Config Manager. This parser must be imported before the FortiGate - Simple golden configuration tree can be created or used. It tokenizes FortiOS CLI configuration (config / edit / set / next / end blocks) using the cisco-ios lexer template, treating each line as a sequence of words delimited by whitespace, with quoted strings preserved as single tokens. It adds a # comment rule on top of the base cisco-ios rules to correctly skip the #-prefixed metadata header lines (#config-version=..., #buildno=...) that FortiOS always emits at the top of a configuration export.

Import via Config Manager → Configuration Parsers → Import.


Golden Configurations

One golden configuration tree is provided. It ships with no device bindings — bind it to your devices in Config Manager after importing.

FortiGate - Simple

Device type: fortios

Baseline configuration using literal matching. Covers admin session timeout, password policy (status + minimum length), NTP sync to a named server, syslog forwarding, and a handful of security-hardening checks: disallows disabling the HTTPS admin redirect, disallows a wide-open trusthost1 0.0.0.0 0.0.0.0 management ACL, and disallows telnet/HTTP management access on port1. Use this as a starting point when all devices in a group are expected to share identical configuration values with no variation.

Before importing: The fortios parser must be registered in Config Manager first (see Configuration Parsers above). Then bind the root node's devices to match your Inventory Manager device name(s).

Dependencies: fortios parser

Studio Projects

FortiGate Project

A netmiko-based automation showcase — every workflow here uses Config Manager and Gateway Manager's generic device operations (backUpDevice, getDeviceConfig, runComplianceForDevice, sendConfig), which need a device wired to Option 1 (netmiko) since sendConfig requires real set-config support. fortigate-rest alone (Option 2) can't run these workflows as-is — see Choosing API vs SSH — and a Hybrid Setup if you want to mix in REST calls elsewhere.

The project contains 4 workflows across 3 folders:

Folder Workflow What it does
Golden Configuration FortiGate - Run Compliance Runs a golden config compliance check against a device and returns the graded report
Interface Configuration FortiGate - Interface Configuration Renders and pushes an interface config (IP, management access, description) with a manual approval gate, pre/post checks, and a diff
Interface Configuration FortiGate - Delete Interface Configuration Resets an interface back to unconfigured, with the same approval gate
Backup Configuration FortiGate - Backup Configuration Backs up a device's running configuration into Config Manager and returns the live config text

Each workflow starts with a JSON form collecting a device name (Itential::fortigate1 — replace with your own Inventory::NodeName) plus, for the interface workflows, the interface/IP/mask/access/description values. The interface workflows also carry two Jinja2 templates (FortiGate Interface Config, FortiGate Interface Delete) and a MOP command template (FortiGate Interface Check) used for both the pre- and post-push checks.

FortiGate - Run Compliance and the golden config tree above are already wired together — its runComplianceForDevice task targets the exact treeId that Golden Configurations/FortiGate - Simple.json ships with, and Config Manager's golden config import preserves that ID verbatim. Import the fortios parser and the FortiGate - Simple tree (see above) before this project, bind the tree to your device, and the compliance workflow resolves with no manual editing.

Dependencies:

Dependency Notes
A netmiko-wired FortiGate node See Option 1 above. Update the device-name default in each JSON form (or just type your own at run time)
cluster_1 Itential Gateway cluster The interface workflows' sendConfig tasks target a cluster named cluster_1 — update this in the canvas if yours is named differently
fortios parser + FortiGate - Simple golden config tree Import both (see Configuration Parsers / Golden Configurations above) and bind the tree to your device before running FortiGate - Run Compliance

Agentic Infrastructure Operations Start Here

See how Itential connects AI reasoning to governed execution across your entire infrastructure.