Actions, resources, and condition keys for Amazon Network Firewall
Amazon Network Firewall (service prefix: network-firewall) provides the following
service-specific operations, resources, actions, and condition keys for use in IAM permission
policies.
References:
-
Learn how to configure this service.
-
View a list of the API operations available for this service.
-
Learn how to secure this service and its resources by using IAM permission policies.
-
View the programmatic service authorization reference
for this service.
Topics
API operations defined by Amazon Network Firewall
The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.
| Operation | IAM action | Condition key | Possible value(s) | Access level |
|---|---|---|---|---|
|
AcceptNetworkFirewallTransitGatewayAttachment |
network-firewall:AcceptNetworkFirewallTransitGatewayAttachment |
Write |
||
|
AssociateAvailabilityZones |
Write |
|||
|
AssociateFirewallPolicy |
Write |
|||
|
AssociateSubnets |
Write |
|||
|
AttachRuleGroupsToProxyConfiguration |
Write |
|||
|
CreateContainerAssociation |
Write |
|||
|
CreateFirewall |
Write |
|||
Write |
||||
Tagging, Write |
||||
|
CreateFirewallPolicy |
Write |
|||
List |
||||
List |
||||
Tagging, Write |
||||
|
CreateProxy |
Write |
|||
Tagging, Write |
||||
|
CreateProxyConfiguration |
Write |
|||
Write |
||||
Tagging, Write |
||||
|
CreateProxyRuleGroup |
Write |
|||
Tagging, Write |
||||
|
CreateProxyRules |
Write |
|||
|
CreateRuleGroup |
Write |
|||
Tagging, Write |
||||
|
CreateTLSInspectionConfiguration |
Write |
|||
Tagging, Write |
||||
|
CreateVpcEndpointAssociation |
Write |
|||
List |
||||
Tagging, Write |
||||
|
DeleteContainerAssociation |
Write |
|||
|
DeleteFirewall |
Write |
|||
|
DeleteFirewallPolicy |
Write |
|||
|
DeleteNetworkFirewallTransitGatewayAttachment |
network-firewall:DeleteNetworkFirewallTransitGatewayAttachment |
Write |
||
|
DeleteProxy |
Write |
|||
|
DeleteProxyConfiguration |
Write |
|||
|
DeleteProxyRuleGroup |
Write |
|||
|
DeleteProxyRules |
Write |
|||
|
DeleteResourcePolicy |
Write |
|||
|
DeleteRuleGroup |
Write |
|||
|
DeleteTLSInspectionConfiguration |
Write |
|||
|
DeleteVpcEndpointAssociation |
Write |
|||
|
DescribeContainerAssociation |
Read |
|||
|
DescribeFirewall |
Read |
|||
|
DescribeFirewallMetadata |
Read |
|||
|
DescribeFirewallPolicy |
Read |
|||
|
DescribeFlowOperation |
Read |
|||
|
DescribeLoggingConfiguration |
Read |
|||
|
DescribeProxy |
Read |
|||
|
DescribeProxyConfiguration |
Read |
|||
|
DescribeProxyRule |
Read |
|||
|
DescribeProxyRuleGroup |
Read |
|||
|
DescribeResourcePolicy |
Read |
|||
|
DescribeRuleGroup |
Read |
|||
|
DescribeRuleGroupMetadata |
Read |
|||
|
DescribeRuleGroupSummary |
Read |
|||
|
DescribeTLSInspectionConfiguration |
Read |
|||
|
DescribeVpcEndpointAssociation |
Read |
|||
|
DetachRuleGroupsFromProxyConfiguration |
Write |
|||
|
DisassociateAvailabilityZones |
Write |
|||
|
DisassociateSubnets |
Write |
|||
|
GetAnalysisReportResults |
Read |
|||
|
ListAnalysisReports |
List |
|||
|
ListContainerAssociations |
List |
|||
|
ListFirewallPolicies |
List |
|||
|
ListFirewalls |
List |
|||
|
ListFlowOperationResults |
Read |
|||
|
ListFlowOperations |
List |
|||
|
ListProxies |
List |
|||
|
ListProxyConfigurations |
List |
|||
|
ListProxyRuleGroups |
List |
|||
|
ListRuleGroups |
List |
|||
|
ListTLSInspectionConfigurations |
List |
|||
|
ListTagsForResource |
List |
|||
|
ListVpcEndpointAssociations |
List |
|||
|
PutResourcePolicy |
Write |
|||
|
RejectNetworkFirewallTransitGatewayAttachment |
network-firewall:RejectNetworkFirewallTransitGatewayAttachment |
Write |
||
|
StartAnalysisReport |
Write |
|||
|
StartFlowCapture |
Write |
|||
|
StartFlowFlush |
Write |
|||
|
TagResource |
Tagging, Write |
|||
|
UntagResource |
Tagging, Write |
|||
|
UpdateAvailabilityZoneChangeProtection |
Write |
|||
|
UpdateContainerAssociation |
Write |
|||
|
UpdateFirewallAnalysisSettings |
Write |
|||
|
UpdateFirewallDeleteProtection |
Write |
|||
|
UpdateFirewallDescription |
Write |
|||
|
UpdateFirewallEncryptionConfiguration |
Write |
|||
|
UpdateFirewallPolicy |
List |
|||
List |
||||
Write |
||||
|
UpdateFirewallPolicyChangeProtection |
Write |
|||
|
UpdateLoggingConfiguration |
Write |
|||
|
UpdateProxy |
Write |
|||
|
UpdateProxyConfiguration |
Write |
|||
|
UpdateProxyRule |
Write |
|||
|
UpdateProxyRuleGroupPriorities |
Write |
|||
|
UpdateProxyRulePriorities |
Write |
|||
|
UpdateRuleGroup |
Write |
|||
|
UpdateSubnetChangeProtection |
Write |
|||
|
UpdateTLSInspectionConfiguration |
Write |
Actions defined by Amazon Network Firewall
You can specify the following actions in the Action element of an IAM
policy statement. Use policies to grant permissions to perform an operation in Amazon. When
you use an action in a policy, you usually allow or deny access to the API operation or CLI
command with the same name. However, in some cases, a single action controls access to more
than one operation. Alternatively, some operations require several different actions.
| Actions | Description | Resource types (*required) | Condition keys | Access level |
|---|---|---|---|---|
Grants permission to accept pending Network Firewall attachments on a transit gateway |
Write |
|||
Grants permission to associate availability zones to a firewall |
Write |
|||
Grants permission to create an association between a firewall policy and a firewall |
Write |
|||
Grants permission to associate VPC subnets to a firewall |
Write |
|||
Grants permission to attach proxy rule groups to a proxy configuration |
Write |
|||
Grants permission to create an Amazon Network Firewall container association |
Write |
|||
Grants permission to create an Amazon Network Firewall firewall |
Write |
|||
Grants permission to create an Amazon Network Firewall firewall policy |
Write |
|||
Grants permission to create an Amazon Network Firewall proxy |
Write |
|||
Grants permission to create an Amazon Network Firewall proxy configuration |
Write |
|||
Grants permission to create an Amazon Network Firewall proxy rule group |
Write |
|||
Grants permission to add proxy rules to a proxy rule group |
Write |
|||
Grants permission to create an Amazon Network Firewall rule group |
Write |
|||
Grants permission to create an Amazon Network Firewall tls inspection configuration |
Write |
|||
Grants permission to create an Amazon Network Firewall vpc endpoint association |
Write |
|||
Grants permission to delete an Amazon Network Firewall container association |
Write |
|||
Grants permission to delete a firewall |
Write |
|||
Grants permission to delete a firewall policy |
Write |
|||
Grants permission to delete Network Firewall attachments on a transit gateway |
Write |
|||
Grants permission to delete a proxy |
Write |
|||
Grants permission to delete a proxy configuration |
Write |
|||
Grants permission to delete a proxy rule group |
Write |
|||
Grants permission to remove proxy rules from a proxy rule group |
Write |
|||
Grants permission to delete a resource policy for a firewall policy or rule group or firewall |
Write |
|||
Grants permission to delete a rule group |
Write |
|||
Grants permission to delete a tls inspection configuration |
Write |
|||
Grants permission to delete a vpc endpoint association |
Write |
|||
Grants permission to retrieve the data objects that define a container association |
Read |
|||
Grants permission to retrieve the data objects that define a firewall |
Read |
|||
Grants permission to retrieve the high-level information about a firewall |
Read |
|||
Grants permission to retrieve the data objects that define a firewall policy |
Read |
|||
Grants permission to describe a flow operation performed on a firewall |
Read |
|||
Grants permission to describe the logging configuration of a firewall |
Read |
|||
Grants permission to retrieve the data objects that define a proxy |
Read |
|||
Grants permission to retrieve the data objects that define a proxy configuration |
Read |
|||
Grants permission to retrieve the data objects that define a proxy rule |
Read |
|||
Grants permission to retrieve the data objects that define a proxy rule group |
Read |
|||
Grants permission to describe a resource policy for a firewall policy or rule group or firewall |
Read |
|||
Grants permission to retrieve the data objects that define a rule group |
Read |
|||
Grants permission to retrieve the high-level information about a rule group |
Read |
|||
Grants permission to retrieve the summary information about a rule group |
Read |
|||
Grants permission to retrieve the data objects that define a tls inspection configuration |
Read |
|||
Grants permission to retrieve the data objects that define a vpc endpoint association |
Read |
|||
Grants permission to detach proxy rule groups from a proxy configuration |
Write |
|||
Grants permission to disassociate availability zones to a firewall |
Write |
|||
Grants permission to disassociate VPC subnets from a firewall |
Write |
|||
Grants permission to retrieve analysis report results of a firewall |
Read |
|||
Grants permission to list firewall analysis reports |
List |
|||
Grants permission to retrieve the metadata for container associations |
List |
|||
Grants permission to retrieve the metadata for firewall policies |
List |
|||
Grants permission to retrieve the metadata for firewalls |
List |
|||
Grants permission to list results from a flow operation performed on a firewall |
Read |
|||
Grants permission to list flow operations performed on a firewall |
List |
|||
Grants permission to retrieve the metadata for proxies |
List |
|||
Grants permission to retrieve the metadata for proxy configurations |
List |
|||
Grants permission to retrieve the metadata for proxy rule groups |
List |
|||
Grants permission to retrieve the metadata for rule groups |
List |
|||
Grants permission to retrieve the metadata for tls inspection configurations |
List |
|||
Grants permission to retrieve the tags for a resource |
List |
|||
Grants permission to retrieve the metadata for vpc endpoint associations |
List |
|||
Grants permission to put a resource policy for a firewall policy or rule group or firewall |
Write |
|||
Grants permission to reject pending Network Firewall attachments on a transit gateway |
Write |
|||
Grants permission to start an analysis report on a firewall |
Write |
|||
Grants permission to start capture operation on a firewall |
Write |
|||
Grants permission to start flush operation on a firewall |
Write |
|||
Grants permission to attach tags to a resource |
Tagging, Write |
|||
Grants permission to remove tags from a resource |
Tagging, Write |
|||
Grants permission to add or remove availability zone change protection for a firewall |
Write |
|||
Grants permission to update an Amazon Network Firewall container association |
Write |
|||
Grants permission to modify firewall analysis settings of a firewall |
Write |
|||
Grants permission to add or remove delete protection for a firewall |
Write |
|||
Grants permission to modify the description for a firewall |
Write |
|||
Grants permission to modify the encryption configuration of a firewall |
Write |
|||
Grants permission to modify a firewall policy |
Write |
|||
Grants permission to add or remove firewall policy change protection for a firewall |
Write |
|||
Grants permission to modify the logging configuration of a firewall |
Write |
|||
Grants permission to modify a proxy |
Write |
|||
Grants permission to modify a proxy configuration |
Write |
|||
Grants permission to update an existing proxy rule on a proxy rule group |
Write |
|||
Grants permission to modify rule group priorities on a proxy configuration |
Write |
|||
Grants permission to update proxy rule priorities within a proxy rule group |
Write |
|||
Grants permission to modify a rule group |
Write |
|||
Grants permission to add or remove subnet change protection for a firewall |
Write |
|||
Grants permission to modify a tls inspection configuration |
Write |
Resource types defined by Amazon Network Firewall
The following resource types are defined by this service and can be used in the
Resource element of IAM permission policy statements.
| Resource types | ARN | Condition keys |
|---|---|---|
arn:${Partition}:network-firewall:${Region}:${Account}:container-association/${Name} |
||
arn:${Partition}:network-firewall:${Region}:${Account}:firewall/${Name} |
||
arn:${Partition}:network-firewall:${Region}:${Account}:firewall-policy/${Name} |
||
arn:${Partition}:network-firewall:${Region}:${Account}:proxy/${Name} |
||
arn:${Partition}:network-firewall:${Region}:${Account}:proxy-configuration/${Name} |
||
arn:${Partition}:network-firewall:${Region}:${Account}:proxy-rule-group/${Name} |
||
arn:${Partition}:network-firewall:${Region}:${Account}:stateful-rulegroup/${Name} |
||
arn:${Partition}:network-firewall:${Region}:${Account}:stateless-rulegroup/${Name} |
||
arn:${Partition}:network-firewall:${Region}:${Account}:tls-configuration/${Name} |
||
arn:${Partition}:network-firewall:${Region}:${Account}:vpc-endpoint-association/${Name} |
Condition keys for Amazon Network Firewall
Amazon Network Firewall defines the following condition keys that can be used in the
Condition element of an IAM policy.
| Condition keys | Description | Type |
|---|---|---|
Filters access by on the allowed set of values for each of the tags |
String |
|
Filters access by the tag value associated with the resource |
String |
|
Filters access by the presence of mandatory tags in the request |
ArrayOfString |