Studio Project workflows for AWS Network Firewall policies, rule groups, and subnet associations
AWS Network Firewall is a managed, stateful network firewall and intrusion detection/prevention service for Amazon VPCs — it provides firewall policies, stateful and stateless rule groups, TLS inspection, subnet association, and logging configuration for traffic filtering across a VPC estate.
This project provides an OpenAPI spec for automating against the AWS Network Firewall REST API via an Integration Model.
| Asset | Description |
|---|---|
| OpenAPIs/ | AWS Network Firewall API OpenAPI specs — -latest plus the full dated spec |
| Studio Projects/AWS Network Firewall | 23 workflows covering common CRUD automation |
| Requirement | Version |
|---|---|
| Itential Platform | 6.x |
| AWS Network Firewall API | 2020-11-12 |
| AWS Network Firewall Integration Model | Required to build automation against the OpenAPI specs |
Import the OpenAPI spec from OpenAPIs/ as an Integration Model in Admin > Integrations, then create an integration pointing at the AWS Network Firewall service endpoint for your region.
Authentication uses AWS Signature Version 4 — requests are signed with an AWS access key ID and secret access key in the Authorization header:
Authorization: AWS4-HMAC-SHA256 Credential=<access-key-id>/<date>/<region>/network-firewall/aws4_request, SignedHeaders=..., Signature=<signature> Generate an access key ID and secret access key for an IAM user or role with network-firewall:* permissions under IAM > Users/Roles > Security credentials.
The instance's authentication/server properties should look like this once configured:
{
"authentication": {
"hmac": {
"accessKeyId": "<your-aws-access-key-id>",
"secretAccessKey": "<your-aws-secret-access-key>",
"sessionToken": ""
}
},
"server": {
"protocol": "https",
"host": "network-firewall.us-east-1.amazonaws.com",
"base_path": ""
}
} | Spec | Version | Operations | Description |
|---|---|---|---|
aws_network_firewall-latest.json | latest (curated) | 36 | Reviewed and confirmed already scoped to common CRUD for automation — see breakdown below |
aws_network_firewall-2020-11-12.json | 2020-11-12 | 36 | Full spec |
aws_network_firewall-latest.jsonReviewed and confirmed already scoped to common CRUD for automation (x-vendor-api-version: 2020-11-12, 36 operations). Every operation is CRUD or a provisioning action on the firewall/policy/rule-group resource model — there is no health, heartbeat, metrics, version-info, or other self-introspection surface to exclude, so nothing was removed.
Operations included, by category:
aws_network_firewall-2020-11-12.jsonFull spec for API version 2020-11-12 (36 operations) — the entire upstream API surface as AWS defines it. Both specs cover the same operation set.
Backed by the AWS Network Firewall:latest Integration Model (see aws_network_firewall-latest.json above). The project contains 23 workflows organized into 5 folders, one atomic workflow per API operation, covering the common-CRUD subset of the curated spec. This is an AWS JSON-protocol API — every operation is a POST distinguished by a required X-Amz-Target header, which each workflow exposes as an input alongside the request body.
| Folder | Workflows | Scope |
|---|---|---|
| Firewalls | Create, Describe, List, Delete Firewall, Update Firewall Description | Firewall lifecycle |
| Firewall Policies | Create, Describe, List, Delete, Update Firewall Policy | Firewall policy management |
| Rule Groups | Create, Describe, List, Delete, Update Rule Group | Rule group management |
| TLS Inspection Configurations | Create, Describe, List, Delete, Update TLS Inspection Configuration | TLS inspection configuration management |
| Tags | List, Tag, Untag Resource | Tagging management |
| Dependency | Notes |
|---|---|
AWS Network Firewall:latest Integration Model | Import from aws_network_firewall-latest.json before importing the project |
AWS Network Firewall integration instance | Create in Admin > Integrations with the connection properties above. Workflows are wired to an integration instance named AWS Network Firewall — update the adapter_id value in each workflow task if yours is named differently |