Actions3
- Firewall Actions
Overview
This node interacts with the FortiManager API to retrieve firewall policy details. Specifically, the "Get Policy" operation under the "Firewall" resource allows users to fetch detailed information about a specific firewall policy configured in FortiManager.
Common scenarios for this node include:
- Automating retrieval of firewall policies for auditing or compliance checks.
- Integrating FortiManager firewall policies into broader network management workflows.
- Fetching policy details dynamically to inform decision-making in security automation.
For example, a user might configure this node to get a particular firewall policy by its ID from a specified device or policy package, then use that data downstream to verify configurations or trigger alerts if certain rules are present.
Properties
| Name | Meaning |
|---|---|
| Domain | The domain of the FortiManager API to operate on. Options: CLI (CLI Configuration operations), Device Manager (Device Manager operations), Policy Manager (Policy and device configuration management), System (System commands and operations), Task (Task management operations). Default is Policy Manager. |
| Access Method | Method used to access the firewall policy. Options: Policy Package (access policy from an ADOM policy package), Device (access policy directly from a device). Default is Policy Package. |
| ADOM | Administrative Domain name within FortiManager. Required when Access Method is Policy Package. Default is "root". |
| Policy Package | Name of the policy package to access. Required when Access Method is Policy Package. Default is "default". |
| Device Name | Name of the device to retrieve the policy from. Required when Access Method is Device. |
| Policy ID | ID of the firewall policy to retrieve. Required for all cases. |
| Additional Fields | Collection of optional fields available only when Access Method is Device: - VDOM: Virtual domain name; if not specified, global policy is retrieved. - Format: Response format, options are Default or Expanded (expanded shows symbolic values). Default is Default. |
Output
The node outputs an array of JSON objects representing the firewall policy details retrieved from FortiManager. Each item corresponds to the requested policy and contains all relevant attributes as returned by the FortiManager API.
If binary data were involved (not indicated here), it would typically represent files or attachments related to the policy, but this node focuses on JSON data output.
Dependencies
- Requires connection to a FortiManager instance via an API key credential.
- The node depends on proper configuration of the FortiManager API credentials within n8n.
- Network connectivity to the FortiManager appliance must be established.
- No additional external libraries beyond those bundled with the node are required.
Troubleshooting
Common Issues:
- Incorrect or missing API credentials will cause authentication failures.
- Specifying an invalid Policy ID, Device Name, or Policy Package may result in errors or empty responses.
- Using the wrong Domain or Access Method combination can lead to unexpected results or API errors.
- Network connectivity issues between n8n and FortiManager will prevent successful API calls.
Error Messages:
- Authentication errors usually indicate invalid or expired API tokens; reconfigure credentials.
- "Policy not found" or similar messages suggest the Policy ID or other parameters do not match existing policies.
- Timeout or connection errors imply network problems; verify FortiManager accessibility.
Resolution Tips:
- Double-check all input parameters for correctness.
- Ensure the API user has sufficient permissions to access the requested domain and policies.
- Test connectivity to FortiManager outside n8n to isolate network issues.
- Enable "Continue On Fail" in the node settings to handle errors gracefully during workflow execution.