AWS's networkfirewall service · portable interface driver.NetworkFirewall · AWS index
| Operation | Description |
|---|---|
AssociateFirewallPolicy |
|
AssociateSubnets |
|
CreateFirewall |
|
CreateFirewallPolicy |
|
CreateRuleGroup |
|
DeleteFirewall |
|
DeleteFirewallPolicy |
|
DeleteRuleGroup |
|
DescribeFirewall |
|
DescribeFirewallPolicy |
|
DescribeLoggingConfiguration |
|
DescribeRuleGroup |
|
DisassociateSubnets |
|
ListFirewallPolicies |
|
ListFirewalls |
|
ListRuleGroups |
|
ListTagsForResource |
|
TagResource |
|
UntagResource |
|
UpdateFirewallDeleteProtection |
|
UpdateFirewallPolicy |
|
UpdateLoggingConfiguration |
|
UpdateRuleGroup |
Discovered by type assertion; only some providers implement these.
AnalysisReports covers the analysis report family.
| Operation | Description |
|---|---|
GetAnalysisReport |
GetAnalysisReport returns one report (its results are always empty). |
ListAnalysisReports |
|
StartAnalysisReport |
AvailabilityZones covers the Availability-Zone associations of a transit
| Operation | Description |
|---|---|
AssociateAvailabilityZones |
|
DisassociateAvailabilityZones |
FirewallSettings covers the firewall-level setters.
| Operation | Description |
|---|---|
UpdateAvailabilityZoneChangeProtection |
|
UpdateFirewallAnalysisSettings |
|
UpdateFirewallDescription |
|
UpdateFirewallPolicyChangeProtection |
|
UpdateSubnetChangeProtection |
FlowOperations covers the flow capture / flush family.
| Operation | Description |
|---|---|
DescribeFlowOperation |
|
ListFlowOperationResults |
ListFlowOperationResults returns the operation and its (always empty, there is no |
ListFlowOperations |
|
StartFlowCapture |
|
StartFlowFlush |
Metadata covers the read-only metadata/summary operations.
| Operation | Description |
|---|---|
DescribeFirewallMetadata |
|
DescribeRuleGroupMetadata |
|
DescribeRuleGroupSummary |
ResourcePolicies covers the resource-sharing IAM policies attached to a rule
| Operation | Description |
|---|---|
DeleteResourcePolicy |
|
DescribeResourcePolicy |
|
PutResourcePolicy |
TLSInspection covers the TLS inspection configuration family.
| Operation | Description |
|---|---|
CreateTLSInspectionConfiguration |
|
DeleteTLSInspectionConfiguration |
|
DescribeTLSInspectionConfiguration |
|
ListTLSInspectionConfigurations |
|
UpdateTLSInspectionConfiguration |
VPCEndpointAssociations covers the VPC endpoint association family.
| Operation | Description |
|---|---|
CreateVpcEndpointAssociation |
|
DeleteVpcEndpointAssociation |
|
DescribeVpcEndpointAssociation |
|
ListVpcEndpointAssociations |
- Not implemented (the operations answer
InvalidRequestException: unknown operation): the proxy family (CreateProxy,CreateProxyConfiguration,CreateProxyRuleGroup,CreateProxyRules, the matching describe, update, delete and list operations,AttachRuleGroupsToProxyConfiguration,DetachRuleGroupsFromProxyConfiguration,UpdateProxyRulePriorities,UpdateProxyRuleGroupPriorities), the container association family (CreateContainerAssociationand its describe, update, delete and list operations), the transit gateway attachment operations (AcceptNetworkFirewallTransitGatewayAttachment,RejectNetworkFirewallTransitGatewayAttachment,DeleteNetworkFirewallTransitGatewayAttachment) andUpdateFirewallEncryptionConfiguration.EncryptionConfigurationon create and update requests is accepted and ignored. - There is no packet data plane. Flow capture and flush operations are accepted and complete (immediately, or after the settle window under
--async-settle) but their results list no flows. Analysis reports complete with no results. Nothing is published to theAWS/NetworkFirewallCloudWatch namespace, and the logging configuration is validated and stored but no alert, flow or TLS log is delivered to S3, CloudWatch Logs or Kinesis Data Firehose. - Checks that need another service are not made: the VPC, subnet and Availability Zone ids a firewall or VPC endpoint association names are syntax-checked only, and the certificates, certificate authorities, KMS keys, log destinations and IAM principals named in TLS inspection configurations, logging configurations and resource policies are not looked up. Resource policies are validated (JSON, allowed actions per resource kind) and stored but never evaluated; sharing through Resource Access Manager is not modeled.
- A firewall subnet's Availability Zone is the zone the subnet really sits in when the subnet exists in the emulated VPC (a firewall takes at most one subnet per zone, as in AWS, and refuses a second one). A subnet id the VPC store does not know (a library user who never created it) gets a zone derived from its id instead, so that zone is stable but not real. Each zone has its own endpoint id, fixed while the subnet stays attached, and a VPC endpoint association reports the same zone.
- A transit gateway-attached firewall can be created, described and have Availability Zones associated and disassociated, but no transit gateway attachment is created, so its status never reports a transit gateway attachment sync state.
- Firewalls, policies, rule groups and TLS inspection configurations are
READYorACTIVEas soon as they are created; there is noPROVISIONINGperiod, andDeleteFirewallremoves the record at once while answeringDELETING, so--async-settlenever shows those intermediate states for these resources (only flow operations settle).DryRunandAnalyzeRuleGroupon create and update requests are accepted and ignored, so a dry run really makes the change and no rule group analysis results are produced. - Rule content is stored and returned byte for byte. Only the parts needed for capacity and summaries are read: stateful rules (one unit per rule in
RulesString,StatefulRulesandRulesSourceListtargets) and stateless rules (the product of the element counts of the match settings, as the CreateRuleGroup reference describes). Suricata syntax, rule variables and reference sets are not validated, and a rule group whose rules need more than itsCapacityis rejected withInvalidRequestException(the exception real AWS uses for this is unconfirmed). - Behaviours the AWS reference does not state were chosen conservatively and are unconfirmed against the live service: a duplicate name answers
InvalidRequestException(the one exception every Create operation models); deleting a firewall that still has VPC endpoint associations is refused withInvalidOperationException; describing or deleting a resource policy that does not exist answersResourceNotFoundException;DescribeRuleGroupSummaryon a stateless rule group answersInvalidRequestExceptionand reports only the options named in the rule group'sSummaryConfiguration; tagging a resource does not change its update token; a request that gives both a name and an ARN uses the name. - List operations take
MaxResults(1 to 100, default 100) andNextToken, an opaque offset over results sorted by name, so it is only stable while the list does not change between pages.ListRuleGroupsfilters onType,ScopeandManagedType; the emulator holds no AWS-managed rule groups, soScope=MANAGEDor anyManagedTypereturns an empty list.