Connect Fortinet FortiGate and FortiManager
Fortinet FortiGate is a firewall, and FortiManager manages many of them from one place. FortiGate Cloud and FortiManager Cloud are the same products run by Fortinet. StackJack connects an AI assistant…
Written By Christopher Scaminaci
Last updated 11 days ago
Fortinet FortiGate is a firewall, and FortiManager manages many of them from one place. FortiGate Cloud and FortiManager Cloud are the same products run by Fortinet. StackJack connects an AI assistant to all three, so it can check and manage the firewalls of every customer you look after.
Connecting Fortinet to StackJack gives your AI assistant a family of forti_ MCP tools. MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack.
With them, your AI can:
- Check a firewall - system status, resources, interfaces, firmware, licenses, HA peers, VPN tunnels, routes, sessions, DHCP leases, SD-WAN health
- Read the configuration - policies, addresses, services, VIPs, users, switches and access points, and the rest of the FortiOS configuration tables
- Read the logs - event and traffic logs, in pages
- Work in FortiManager - ADOMs, devices, policy packages, shared objects, revisions, tasks
- Change things (on Pro plans) - create and edit objects and policies, ban an address, close a session, bring a tunnel up or down, install a policy package
Choose how StackJack reaches your firewalls
You choose one method for each connection. Start with a cloud method if you can: the other one asks you to open a management interface to the internet.
A direct connection to a single FortiGate is not available yet. A FortiManager that you run yourself is not that method, and it works today.
FortiGate Cloud and FortiManager Cloud
Create an IAM API user
- Sign in to the FortiCloud IAM portal and open API Users, then click Add API User.
- Under permissions, add FortiGate with Admin access for FortiGate Cloud, or FortiManager Cloud for FortiManager Cloud.
- Click Download credentials and keep the file. It holds the API ID and the password, and Fortinet shows them once. Downloading again resets the password, so download it once and paste the values straight away.
Connect it in StackJack
- Open Connectors, then Fortinet, and choose FortiGate Cloud or FortiManager Cloud.
- FortiGate Cloud: choose your region (Global, United States, Europe or Japan). A key sent to the wrong region fails exactly like a wrong password.
- FortiManager Cloud: paste the instance URL from the FortiManager Cloud portal. It looks like
https://106728.ca-west-1.fortimanager.forticloud.comand ends infortimanager.forticloud.com. - Paste the IAM API ID and the IAM API password.
- Click Test connection. StackJack signs in to FortiCloud and reads one list: your devices (FortiGate Cloud) or the FortiManager system status (FortiManager Cloud). Nothing is changed.
StackJack keeps the short-lived token for you and stores the rotating refresh token Fortinet returns. You never paste a token.
A FortiManager that you run
This method needs three things on your side, and each one costs something:
- Exposure. The FortiManager's web address must be reachable from the internet. Fortinet's own hardening guidance is not to allow administration on an internet-facing interface, so weigh this against FortiManager Cloud.
- A certificate from a public authority. A FortiManager ships with a certificate signed by Fortinet's own private authority, which StackJack does not trust. The connection fails with a certificate message until you install a certificate for a public name.
- Trusted hosts. The REST API administrator must list StackJack's addresses. StackJack does not publish them: open a support ticket and ask for them.
Then create the administrator and connect it:
- In FortiManager 7.2.2 or later, create an administrator of type REST API Admin, with JSON API Access set to Read-Write (Read for read-only use), an administrator profile and ADOM scope that fit, and the trusted hosts above.
- Copy the API key. FortiManager shows it once.
- In StackJack, open Connectors, then Fortinet, choose FortiManager that you run, paste the address (add the port if it is not 443, for example
https://fortimanager.example.com:8443) and the key. - Click Test connection.
Do not turn on certificate matching ("PKI") for this administrator: StackJack sends no client certificate, so every call would fail.
What is worth knowing before you start
Name the firewall on each call
A FortiOS tool takes a vdom (the value global means the whole device). On FortiGate Cloud it also takes the device serial, and on a FortiManager it takes the adom and the device name.
FortiGate Cloud documents read access only through its proxy, so a change to a firewall goes through a FortiManager connection. One connection reaches every firewall in its FortiCloud account or its
FortiManager.
A FortiManager write is not live yet
A write to the FortiManager database (an address, a policy) changes nothing on a firewall until a policy package is installed. The install tools push configuration to live devices, so they are marked destructive and your AI client asks before they run. An install that runs longer than StackJack waits (three minutes) ends as a timeout, not as a result: read the task to see how it finished.
The surface changes with the firmware
Fortinet's API differs between firmware releases. A 404 on a tool usually means the table or route is not on that firmware. The Fortinet documentation behind this API is open to Fortinet partners only, so StackJack built the tool list from Fortinet's own automation modules; tell support when a tool does not match your firmware.
Lists are large
A FortiOS list returns the whole table unless you trim it. Pass format (for example name|comment) and filter, and rows or count for logs and sessions (StackJack caps them at 500). FortiManager lists take
fields, a filter, and a range, also capped at 500.
When Fortinet refuses a call
- A key or password is refused. StackJack does not retry it. A FortiGate counts failed sign-ins per source address, locks the address out after three in 60 seconds, and doubles the lockout each time, refusing even a valid key meanwhile. Save the new credential before you test again.
- 429 Too Many Requests. Wait a few minutes. This is not counted toward disabling the connection.
- A FortiManager error code. FortiManager reports failure in the body even when the status is 200. The message names the code and the URL.
- The direct method. The reserved direct FortiGate method is refused with its own message.
Plans and limits
Reads are available on the Free tier. Every write is Pro. Business reaches the same tools as Pro and differs by monthly call quota.
See the generated Fortinet tool reference for the current inventory, plan assignment, input schemas and destructive-action labels.
Fortinet FortiGate and FortiManager tools
forti_ · 7773 tools · Free 2973 · Pro 4800
This reference lists 7773 tools. It is too long for one page, so it is split by tool group into 3 pages. Every tool and every group is on exactly one of them.
Part 1: FortiGate and FortiOS
3476 tools in 87 groups.
- FortiGate Cloud · 2 tools
- FortiOS CMDB: alertemail · 2 tools
- FortiOS CMDB: antivirus · 14 tools
- FortiOS CMDB: application · 32 tools
- FortiOS CMDB: authentication · 12 tools
- FortiOS CMDB: automation · 2 tools
- FortiOS CMDB: casb · 20 tools
- FortiOS CMDB: certificate · 25 tools
- FortiOS CMDB: diameter filter · 5 tools
- FortiOS CMDB: dlp · 47 tools
- FortiOS CMDB: dnsfilter · 10 tools
- FortiOS CMDB: dpdk · 4 tools
- FortiOS CMDB: emailfilter · 34 tools
- FortiOS CMDB: endpoint control · 12 tools
- FortiOS CMDB: extender controller · 15 tools
- FortiOS CMDB: extender · 13 tools
- FortiOS CMDB: extension controller · 30 tools
- FortiOS CMDB: file filter · 5 tools
- FortiOS CMDB: firewall · 494 tools
- FortiOS CMDB: ftp proxy · 2 tools
- FortiOS CMDB: gtp · 40 tools
- FortiOS CMDB: hardware · 14 tools
- FortiOS CMDB: icap · 15 tools
- FortiOS CMDB: ips · 35 tools
- FortiOS CMDB: ipsec · 1 tool
- FortiOS CMDB: llm · 15 tools
- FortiOS CMDB: log · 120 tools
- FortiOS CMDB: mgmt data · 1 tool
- FortiOS CMDB: monitoring · 4 tools
- FortiOS CMDB: nsxt · 7 tools
- FortiOS CMDB: pfcp · 5 tools
- FortiOS CMDB: report · 8 tools
- FortiOS CMDB: router · 104 tools
- FortiOS CMDB: sctp filter · 5 tools
- FortiOS CMDB: ssh filter · 5 tools
- FortiOS CMDB: switch controller · 208 tools
- FortiOS CMDB: system · 660 tools
- FortiOS CMDB: telemetry controller · 22 tools
- FortiOS CMDB: user · 119 tools
- FortiOS CMDB: videofilter · 20 tools
- FortiOS CMDB: virtual patch · 5 tools
- FortiOS CMDB: voip · 5 tools
- FortiOS CMDB: vpn · 137 tools
- FortiOS CMDB: waf · 20 tools
- FortiOS CMDB: wanopt · 28 tools
- FortiOS CMDB: web proxy · 44 tools
- FortiOS CMDB: webfilter · 63 tools
- FortiOS CMDB: wireless controller · 226 tools
- FortiOS CMDB: ztna · 39 tools
- FortiOS monitor: azure · 2 tools
- FortiOS monitor: casb · 1 tool
- FortiOS monitor: endpoint control · 17 tools
- FortiOS monitor: extender controller · 5 tools
- FortiOS monitor: extension controller · 2 tools
- FortiOS monitor: firewall · 75 tools
- FortiOS monitor: firmware · 5 tools
- FortiOS monitor: forticonverter · 21 tools
- FortiOS monitor: fortiguard · 3 tools
- FortiOS monitor: fortiview · 8 tools
- FortiOS monitor: geoip · 2 tools
- FortiOS monitor: ips · 6 tools
- FortiOS monitor: license · 5 tools
- FortiOS monitor: log · 15 tools
- FortiOS monitor: network · 10 tools
- FortiOS monitor: nsx · 3 tools
- FortiOS monitor: registration · 6 tools
- FortiOS monitor: router · 22 tools
- FortiOS monitor: service · 1 tool
- FortiOS monitor: switch controller · 35 tools
- FortiOS monitor: system · 172 tools
- FortiOS monitor: telemetry controller · 2 tools
- FortiOS monitor: user · 52 tools
- FortiOS monitor: utm · 8 tools
- FortiOS monitor: videofilter · 1 tool
- FortiOS monitor: virtual wan · 5 tools
- FortiOS monitor: vpn certificate · 7 tools
- FortiOS monitor: vpn · 20 tools
- FortiOS monitor: wanopt · 6 tools
- FortiOS monitor: webcache · 2 tools
- FortiOS monitor: webfilter · 8 tools
- FortiOS monitor: wifi · 38 tools
- FortiOS monitor: web ui · 3 tools
- FortiOS monitor: sdwan · 1 tool
- FortiOS log: disk · 38 tools
- FortiOS log: fortianalyzer · 38 tools
- FortiOS log: forticloud · 38 tools
- FortiOS log: memory · 38 tools
Part 2: FortiManager
2228 tools in 34 groups.
- FortiManager objects: adom · 2 tools
- FortiManager objects: antivirus · 48 tools
- FortiManager objects: wireless controller · 286 tools
- FortiManager objects: application · 32 tools
- FortiManager objects: authentication · 4 tools
- FortiManager objects: casb · 74 tools
- FortiManager objects: certificate · 4 tools
- FortiManager objects: cifs · 18 tools
- FortiManager objects: cloud · 24 tools
- FortiManager objects: credential store · 4 tools
- FortiManager device profiles · 110 tools
- FortiManager objects: diameter filter · 4 tools
- FortiManager objects: dlp · 64 tools
- FortiManager objects: dnsfilter · 24 tools
- FortiManager device manager · 84 tools
- FortiManager objects: dynamic · 60 tools
- FortiManager objects: emailfilter · 76 tools
- FortiManager objects: endpoint control · 4 tools
- FortiManager objects: extender controller · 44 tools
- FortiManager objects: extension controller · 52 tools
- FortiManager objects: file filter · 8 tools
- FortiManager objects: firewall · 687 tools
- FortiManager objects: fmg · 32 tools
- FortiManager CLI: fmupdate · 63 tools
- FortiManager objects: global · 14 tools
- FortiManager objects: fsp · 108 tools
- FortiManager objects: gtp · 40 tools
- FortiManager objects: icap · 37 tools
- FortiManager objects: image analyzer · 1 tool
- FortiManager objects: ips · 37 tools
- FortiManager objects: isolator · 8 tools
- FortiManager objects: log · 14 tools
- FortiManager CLI: meta fields · 2 tools
- FortiManager policy packages · 159 tools
Part 3: FortiManager and Raw
2069 tools in 45 groups.
- FortiManager ADOM config: adom · 1 tool
- FortiManager ADOM config: application · 1 tool
- FortiManager ADOM config: category · 1 tool
- FortiManager ADOM config: data · 6 tools
- FortiManager ADOM config: fct · 1 tool
- FortiManager package manager · 51 tools
- FortiManager ADOM config: package · 1 tool
- FortiManager policy blocks · 38 tools
- FortiManager ADOM config: rule · 1 tool
- FortiManager objects: router · 56 tools
- FortiManager objects: sctp filter · 8 tools
- FortiManager objects: spamfilter · 56 tools
- FortiManager objects: ssh filter · 14 tools
- FortiManager objects: switch controller · 162 tools
- FortiManager objects: sys · 9 tools
- FortiManager CLI: system · 449 tools
- FortiManager objects: system · 326 tools
- FortiManager objects: task · 3 tools
- FortiManager objects: telemetry controller · 22 tools
- FortiManager objects: cli · 8 tools
- FortiManager objects: ums · 4 tools
- FortiManager objects: user · 240 tools
- FortiManager objects: videofilter · 34 tools
- FortiManager objects: virtual patch · 8 tools
- FortiManager objects: voip · 10 tools
- FortiManager objects: vpn · 100 tools
- FortiManager objects: vpnmgr · 24 tools
- FortiManager objects: waf · 72 tools
- FortiManager objects: wanopt · 22 tools
- FortiManager WAN profiles · 68 tools
- FortiManager objects: webfilter · 100 tools
- FortiManager objects: web proxy · 40 tools
- FortiManager objects: ztna · 70 tools
- FortiManager objects: deployment · 1 tool
- FortiManager ADOM config: devprof · 1 tool
- FortiManager objects: dvm · 10 tools
- FortiManager CLI: exec · 1 tool
- FortiManager global config · 19 tools
- FortiManager ADOM config: meta · 1 tool
- FortiManager ADOM config: upgrade · 1 tool
- FortiManager ADOM config: workspace · 3 tools
- FortiManager objects: securityconsole · 18 tools
- FortiManager objects: um · 2 tools
- FortiManager objects: · 2 tools
- Raw passthrough · 4 tools
Was this helpful?
More in Connector guides
Connect 3CXConnect AbleSignConnect Acronis Cyber Protect CloudConnect Action1Still need help? Ask the team