@aws-sdk/client-network-firewall 3.35.0 → 3.36.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (231) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/dist-cjs/NetworkFirewall.js +0 -1
  3. package/dist-cjs/NetworkFirewallClient.js +0 -1
  4. package/dist-cjs/commands/AssociateFirewallPolicyCommand.js +0 -1
  5. package/dist-cjs/commands/AssociateSubnetsCommand.js +0 -1
  6. package/dist-cjs/commands/CreateFirewallCommand.js +0 -1
  7. package/dist-cjs/commands/CreateFirewallPolicyCommand.js +0 -1
  8. package/dist-cjs/commands/CreateRuleGroupCommand.js +0 -1
  9. package/dist-cjs/commands/DeleteFirewallCommand.js +0 -1
  10. package/dist-cjs/commands/DeleteFirewallPolicyCommand.js +0 -1
  11. package/dist-cjs/commands/DeleteResourcePolicyCommand.js +0 -1
  12. package/dist-cjs/commands/DeleteRuleGroupCommand.js +0 -1
  13. package/dist-cjs/commands/DescribeFirewallCommand.js +0 -1
  14. package/dist-cjs/commands/DescribeFirewallPolicyCommand.js +0 -1
  15. package/dist-cjs/commands/DescribeLoggingConfigurationCommand.js +0 -1
  16. package/dist-cjs/commands/DescribeResourcePolicyCommand.js +0 -1
  17. package/dist-cjs/commands/DescribeRuleGroupCommand.js +0 -1
  18. package/dist-cjs/commands/DisassociateSubnetsCommand.js +0 -1
  19. package/dist-cjs/commands/ListFirewallPoliciesCommand.js +0 -1
  20. package/dist-cjs/commands/ListFirewallsCommand.js +0 -1
  21. package/dist-cjs/commands/ListRuleGroupsCommand.js +0 -1
  22. package/dist-cjs/commands/ListTagsForResourceCommand.js +0 -1
  23. package/dist-cjs/commands/PutResourcePolicyCommand.js +0 -1
  24. package/dist-cjs/commands/TagResourceCommand.js +0 -1
  25. package/dist-cjs/commands/UntagResourceCommand.js +0 -1
  26. package/dist-cjs/commands/UpdateFirewallDeleteProtectionCommand.js +0 -1
  27. package/dist-cjs/commands/UpdateFirewallDescriptionCommand.js +0 -1
  28. package/dist-cjs/commands/UpdateFirewallPolicyChangeProtectionCommand.js +0 -1
  29. package/dist-cjs/commands/UpdateFirewallPolicyCommand.js +0 -1
  30. package/dist-cjs/commands/UpdateLoggingConfigurationCommand.js +0 -1
  31. package/dist-cjs/commands/UpdateRuleGroupCommand.js +0 -1
  32. package/dist-cjs/commands/UpdateSubnetChangeProtectionCommand.js +0 -1
  33. package/dist-cjs/endpoints.js +0 -1
  34. package/dist-cjs/index.js +0 -1
  35. package/dist-cjs/models/index.js +0 -1
  36. package/dist-cjs/models/models_0.js +0 -1
  37. package/dist-cjs/pagination/Interfaces.js +0 -1
  38. package/dist-cjs/pagination/ListFirewallPoliciesPaginator.js +0 -1
  39. package/dist-cjs/pagination/ListFirewallsPaginator.js +0 -1
  40. package/dist-cjs/pagination/ListRuleGroupsPaginator.js +0 -1
  41. package/dist-cjs/pagination/ListTagsForResourcePaginator.js +0 -1
  42. package/dist-cjs/protocols/Aws_json1_0.js +0 -1
  43. package/dist-cjs/runtimeConfig.browser.js +2 -3
  44. package/dist-cjs/runtimeConfig.js +3 -4
  45. package/dist-cjs/runtimeConfig.native.js +0 -1
  46. package/dist-cjs/runtimeConfig.shared.js +0 -1
  47. package/dist-es/NetworkFirewall.js +0 -1
  48. package/dist-es/NetworkFirewallClient.js +0 -1
  49. package/dist-es/commands/AssociateFirewallPolicyCommand.js +0 -1
  50. package/dist-es/commands/AssociateSubnetsCommand.js +0 -1
  51. package/dist-es/commands/CreateFirewallCommand.js +0 -1
  52. package/dist-es/commands/CreateFirewallPolicyCommand.js +0 -1
  53. package/dist-es/commands/CreateRuleGroupCommand.js +0 -1
  54. package/dist-es/commands/DeleteFirewallCommand.js +0 -1
  55. package/dist-es/commands/DeleteFirewallPolicyCommand.js +0 -1
  56. package/dist-es/commands/DeleteResourcePolicyCommand.js +0 -1
  57. package/dist-es/commands/DeleteRuleGroupCommand.js +0 -1
  58. package/dist-es/commands/DescribeFirewallCommand.js +0 -1
  59. package/dist-es/commands/DescribeFirewallPolicyCommand.js +0 -1
  60. package/dist-es/commands/DescribeLoggingConfigurationCommand.js +0 -1
  61. package/dist-es/commands/DescribeResourcePolicyCommand.js +0 -1
  62. package/dist-es/commands/DescribeRuleGroupCommand.js +0 -1
  63. package/dist-es/commands/DisassociateSubnetsCommand.js +0 -1
  64. package/dist-es/commands/ListFirewallPoliciesCommand.js +0 -1
  65. package/dist-es/commands/ListFirewallsCommand.js +0 -1
  66. package/dist-es/commands/ListRuleGroupsCommand.js +0 -1
  67. package/dist-es/commands/ListTagsForResourceCommand.js +0 -1
  68. package/dist-es/commands/PutResourcePolicyCommand.js +0 -1
  69. package/dist-es/commands/TagResourceCommand.js +0 -1
  70. package/dist-es/commands/UntagResourceCommand.js +0 -1
  71. package/dist-es/commands/UpdateFirewallDeleteProtectionCommand.js +0 -1
  72. package/dist-es/commands/UpdateFirewallDescriptionCommand.js +0 -1
  73. package/dist-es/commands/UpdateFirewallPolicyChangeProtectionCommand.js +0 -1
  74. package/dist-es/commands/UpdateFirewallPolicyCommand.js +0 -1
  75. package/dist-es/commands/UpdateLoggingConfigurationCommand.js +0 -1
  76. package/dist-es/commands/UpdateRuleGroupCommand.js +0 -1
  77. package/dist-es/commands/UpdateSubnetChangeProtectionCommand.js +0 -1
  78. package/dist-es/endpoints.js +0 -1
  79. package/dist-es/index.js +0 -1
  80. package/dist-es/models/index.js +0 -1
  81. package/dist-es/models/models_0.js +0 -1
  82. package/dist-es/pagination/Interfaces.js +0 -1
  83. package/dist-es/pagination/ListFirewallPoliciesPaginator.js +0 -1
  84. package/dist-es/pagination/ListFirewallsPaginator.js +0 -1
  85. package/dist-es/pagination/ListRuleGroupsPaginator.js +0 -1
  86. package/dist-es/pagination/ListTagsForResourcePaginator.js +0 -1
  87. package/dist-es/protocols/Aws_json1_0.js +0 -1
  88. package/dist-es/runtimeConfig.browser.js +1 -2
  89. package/dist-es/runtimeConfig.js +2 -3
  90. package/dist-es/runtimeConfig.native.js +0 -1
  91. package/dist-es/runtimeConfig.shared.js +0 -1
  92. package/package.json +33 -30
  93. package/dist-cjs/NetworkFirewall.js.map +0 -1
  94. package/dist-cjs/NetworkFirewallClient.js.map +0 -1
  95. package/dist-cjs/commands/AssociateFirewallPolicyCommand.js.map +0 -1
  96. package/dist-cjs/commands/AssociateSubnetsCommand.js.map +0 -1
  97. package/dist-cjs/commands/CreateFirewallCommand.js.map +0 -1
  98. package/dist-cjs/commands/CreateFirewallPolicyCommand.js.map +0 -1
  99. package/dist-cjs/commands/CreateRuleGroupCommand.js.map +0 -1
  100. package/dist-cjs/commands/DeleteFirewallCommand.js.map +0 -1
  101. package/dist-cjs/commands/DeleteFirewallPolicyCommand.js.map +0 -1
  102. package/dist-cjs/commands/DeleteResourcePolicyCommand.js.map +0 -1
  103. package/dist-cjs/commands/DeleteRuleGroupCommand.js.map +0 -1
  104. package/dist-cjs/commands/DescribeFirewallCommand.js.map +0 -1
  105. package/dist-cjs/commands/DescribeFirewallPolicyCommand.js.map +0 -1
  106. package/dist-cjs/commands/DescribeLoggingConfigurationCommand.js.map +0 -1
  107. package/dist-cjs/commands/DescribeResourcePolicyCommand.js.map +0 -1
  108. package/dist-cjs/commands/DescribeRuleGroupCommand.js.map +0 -1
  109. package/dist-cjs/commands/DisassociateSubnetsCommand.js.map +0 -1
  110. package/dist-cjs/commands/ListFirewallPoliciesCommand.js.map +0 -1
  111. package/dist-cjs/commands/ListFirewallsCommand.js.map +0 -1
  112. package/dist-cjs/commands/ListRuleGroupsCommand.js.map +0 -1
  113. package/dist-cjs/commands/ListTagsForResourceCommand.js.map +0 -1
  114. package/dist-cjs/commands/PutResourcePolicyCommand.js.map +0 -1
  115. package/dist-cjs/commands/TagResourceCommand.js.map +0 -1
  116. package/dist-cjs/commands/UntagResourceCommand.js.map +0 -1
  117. package/dist-cjs/commands/UpdateFirewallDeleteProtectionCommand.js.map +0 -1
  118. package/dist-cjs/commands/UpdateFirewallDescriptionCommand.js.map +0 -1
  119. package/dist-cjs/commands/UpdateFirewallPolicyChangeProtectionCommand.js.map +0 -1
  120. package/dist-cjs/commands/UpdateFirewallPolicyCommand.js.map +0 -1
  121. package/dist-cjs/commands/UpdateLoggingConfigurationCommand.js.map +0 -1
  122. package/dist-cjs/commands/UpdateRuleGroupCommand.js.map +0 -1
  123. package/dist-cjs/commands/UpdateSubnetChangeProtectionCommand.js.map +0 -1
  124. package/dist-cjs/endpoints.js.map +0 -1
  125. package/dist-cjs/index.js.map +0 -1
  126. package/dist-cjs/models/index.js.map +0 -1
  127. package/dist-cjs/models/models_0.js.map +0 -1
  128. package/dist-cjs/pagination/Interfaces.js.map +0 -1
  129. package/dist-cjs/pagination/ListFirewallPoliciesPaginator.js.map +0 -1
  130. package/dist-cjs/pagination/ListFirewallsPaginator.js.map +0 -1
  131. package/dist-cjs/pagination/ListRuleGroupsPaginator.js.map +0 -1
  132. package/dist-cjs/pagination/ListTagsForResourcePaginator.js.map +0 -1
  133. package/dist-cjs/protocols/Aws_json1_0.js.map +0 -1
  134. package/dist-cjs/runtimeConfig.browser.js.map +0 -1
  135. package/dist-cjs/runtimeConfig.js.map +0 -1
  136. package/dist-cjs/runtimeConfig.native.js.map +0 -1
  137. package/dist-cjs/runtimeConfig.shared.js.map +0 -1
  138. package/dist-es/NetworkFirewall.js.map +0 -1
  139. package/dist-es/NetworkFirewallClient.js.map +0 -1
  140. package/dist-es/commands/AssociateFirewallPolicyCommand.js.map +0 -1
  141. package/dist-es/commands/AssociateSubnetsCommand.js.map +0 -1
  142. package/dist-es/commands/CreateFirewallCommand.js.map +0 -1
  143. package/dist-es/commands/CreateFirewallPolicyCommand.js.map +0 -1
  144. package/dist-es/commands/CreateRuleGroupCommand.js.map +0 -1
  145. package/dist-es/commands/DeleteFirewallCommand.js.map +0 -1
  146. package/dist-es/commands/DeleteFirewallPolicyCommand.js.map +0 -1
  147. package/dist-es/commands/DeleteResourcePolicyCommand.js.map +0 -1
  148. package/dist-es/commands/DeleteRuleGroupCommand.js.map +0 -1
  149. package/dist-es/commands/DescribeFirewallCommand.js.map +0 -1
  150. package/dist-es/commands/DescribeFirewallPolicyCommand.js.map +0 -1
  151. package/dist-es/commands/DescribeLoggingConfigurationCommand.js.map +0 -1
  152. package/dist-es/commands/DescribeResourcePolicyCommand.js.map +0 -1
  153. package/dist-es/commands/DescribeRuleGroupCommand.js.map +0 -1
  154. package/dist-es/commands/DisassociateSubnetsCommand.js.map +0 -1
  155. package/dist-es/commands/ListFirewallPoliciesCommand.js.map +0 -1
  156. package/dist-es/commands/ListFirewallsCommand.js.map +0 -1
  157. package/dist-es/commands/ListRuleGroupsCommand.js.map +0 -1
  158. package/dist-es/commands/ListTagsForResourceCommand.js.map +0 -1
  159. package/dist-es/commands/PutResourcePolicyCommand.js.map +0 -1
  160. package/dist-es/commands/TagResourceCommand.js.map +0 -1
  161. package/dist-es/commands/UntagResourceCommand.js.map +0 -1
  162. package/dist-es/commands/UpdateFirewallDeleteProtectionCommand.js.map +0 -1
  163. package/dist-es/commands/UpdateFirewallDescriptionCommand.js.map +0 -1
  164. package/dist-es/commands/UpdateFirewallPolicyChangeProtectionCommand.js.map +0 -1
  165. package/dist-es/commands/UpdateFirewallPolicyCommand.js.map +0 -1
  166. package/dist-es/commands/UpdateLoggingConfigurationCommand.js.map +0 -1
  167. package/dist-es/commands/UpdateRuleGroupCommand.js.map +0 -1
  168. package/dist-es/commands/UpdateSubnetChangeProtectionCommand.js.map +0 -1
  169. package/dist-es/endpoints.js.map +0 -1
  170. package/dist-es/index.js.map +0 -1
  171. package/dist-es/models/index.js.map +0 -1
  172. package/dist-es/models/models_0.js.map +0 -1
  173. package/dist-es/pagination/Interfaces.js.map +0 -1
  174. package/dist-es/pagination/ListFirewallPoliciesPaginator.js.map +0 -1
  175. package/dist-es/pagination/ListFirewallsPaginator.js.map +0 -1
  176. package/dist-es/pagination/ListRuleGroupsPaginator.js.map +0 -1
  177. package/dist-es/pagination/ListTagsForResourcePaginator.js.map +0 -1
  178. package/dist-es/protocols/Aws_json1_0.js.map +0 -1
  179. package/dist-es/runtimeConfig.browser.js.map +0 -1
  180. package/dist-es/runtimeConfig.js.map +0 -1
  181. package/dist-es/runtimeConfig.native.js.map +0 -1
  182. package/dist-es/runtimeConfig.shared.js.map +0 -1
  183. package/jest.config.js +0 -4
  184. package/src/NetworkFirewall.ts +0 -1254
  185. package/src/NetworkFirewallClient.ts +0 -448
  186. package/src/commands/AssociateFirewallPolicyCommand.ts +0 -99
  187. package/src/commands/AssociateSubnetsCommand.ts +0 -100
  188. package/src/commands/CreateFirewallCommand.ts +0 -101
  189. package/src/commands/CreateFirewallPolicyCommand.ts +0 -98
  190. package/src/commands/CreateRuleGroupCommand.ts +0 -98
  191. package/src/commands/DeleteFirewallCommand.ts +0 -105
  192. package/src/commands/DeleteFirewallPolicyCommand.ts +0 -95
  193. package/src/commands/DeleteResourcePolicyCommand.ts +0 -95
  194. package/src/commands/DeleteRuleGroupCommand.ts +0 -95
  195. package/src/commands/DescribeFirewallCommand.ts +0 -95
  196. package/src/commands/DescribeFirewallPolicyCommand.ts +0 -95
  197. package/src/commands/DescribeLoggingConfigurationCommand.ts +0 -100
  198. package/src/commands/DescribeResourcePolicyCommand.ts +0 -95
  199. package/src/commands/DescribeRuleGroupCommand.ts +0 -95
  200. package/src/commands/DisassociateSubnetsCommand.ts +0 -98
  201. package/src/commands/ListFirewallPoliciesCommand.ts +0 -97
  202. package/src/commands/ListFirewallsCommand.ts +0 -98
  203. package/src/commands/ListRuleGroupsCommand.ts +0 -97
  204. package/src/commands/ListTagsForResourceCommand.ts +0 -101
  205. package/src/commands/PutResourcePolicyCommand.ts +0 -109
  206. package/src/commands/TagResourceCommand.ts +0 -100
  207. package/src/commands/UntagResourceCommand.ts +0 -101
  208. package/src/commands/UpdateFirewallDeleteProtectionCommand.ts +0 -106
  209. package/src/commands/UpdateFirewallDescriptionCommand.ts +0 -99
  210. package/src/commands/UpdateFirewallPolicyChangeProtectionCommand.ts +0 -106
  211. package/src/commands/UpdateFirewallPolicyCommand.ts +0 -95
  212. package/src/commands/UpdateLoggingConfigurationCommand.ts +0 -123
  213. package/src/commands/UpdateRuleGroupCommand.ts +0 -100
  214. package/src/commands/UpdateSubnetChangeProtectionCommand.ts +0 -100
  215. package/src/endpoints.ts +0 -91
  216. package/src/index.ts +0 -37
  217. package/src/models/index.ts +0 -1
  218. package/src/models/models_0.ts +0 -3567
  219. package/src/pagination/Interfaces.ts +0 -8
  220. package/src/pagination/ListFirewallPoliciesPaginator.ts +0 -59
  221. package/src/pagination/ListFirewallsPaginator.ts +0 -59
  222. package/src/pagination/ListRuleGroupsPaginator.ts +0 -59
  223. package/src/pagination/ListTagsForResourcePaginator.ts +0 -59
  224. package/src/protocols/Aws_json1_0.ts +0 -5479
  225. package/src/runtimeConfig.browser.ts +0 -41
  226. package/src/runtimeConfig.native.ts +0 -17
  227. package/src/runtimeConfig.shared.ts +0 -17
  228. package/src/runtimeConfig.ts +0 -46
  229. package/tsconfig.es.json +0 -10
  230. package/tsconfig.json +0 -33
  231. package/tsconfig.types.json +0 -9
@@ -1,3567 +0,0 @@
1
- import { MetadataBearer as $MetadataBearer, SmithyException as __SmithyException } from "@aws-sdk/types";
2
-
3
- /**
4
- * <p>The value to use in an Amazon CloudWatch custom metric dimension. This is used in the
5
- * <code>PublishMetrics</code>
6
- * <a>CustomAction</a>. A CloudWatch custom metric dimension is a name/value pair that's
7
- * part of the identity of a metric. </p>
8
- * <p>AWS Network Firewall sets the dimension name to <code>CustomAction</code> and you provide the
9
- * dimension value. </p>
10
- * <p>For more information about CloudWatch custom metric dimensions, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html#usingDimensions">Publishing Custom Metrics</a> in the <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html">Amazon CloudWatch User
11
- * Guide</a>.</p>
12
- */
13
- export interface Dimension {
14
- /**
15
- * <p>The value to use in the custom metric dimension.</p>
16
- */
17
- Value: string | undefined;
18
- }
19
-
20
- export namespace Dimension {
21
- /**
22
- * @internal
23
- */
24
- export const filterSensitiveLog = (obj: Dimension): any => ({
25
- ...obj,
26
- });
27
- }
28
-
29
- /**
30
- * <p>Stateless inspection criteria that publishes the specified metrics to Amazon CloudWatch for the
31
- * matching packet. This setting defines a CloudWatch dimension value to be published.</p>
32
- */
33
- export interface PublishMetricAction {
34
- /**
35
- * <p></p>
36
- */
37
- Dimensions: Dimension[] | undefined;
38
- }
39
-
40
- export namespace PublishMetricAction {
41
- /**
42
- * @internal
43
- */
44
- export const filterSensitiveLog = (obj: PublishMetricAction): any => ({
45
- ...obj,
46
- });
47
- }
48
-
49
- /**
50
- * <p>A custom action to use in stateless rule actions settings. This is used in <a>CustomAction</a>.</p>
51
- */
52
- export interface ActionDefinition {
53
- /**
54
- * <p>Stateless inspection criteria that publishes the specified metrics to Amazon CloudWatch for the
55
- * matching packet. This setting defines a CloudWatch dimension value to be published.</p>
56
- * <p>You can pair this custom action with any of the standard stateless rule actions. For
57
- * example, you could pair this in a rule action with the standard action that forwards the
58
- * packet for stateful inspection. Then, when a packet matches the rule, Network Firewall
59
- * publishes metrics for the packet and forwards it. </p>
60
- */
61
- PublishMetricAction?: PublishMetricAction;
62
- }
63
-
64
- export namespace ActionDefinition {
65
- /**
66
- * @internal
67
- */
68
- export const filterSensitiveLog = (obj: ActionDefinition): any => ({
69
- ...obj,
70
- });
71
- }
72
-
73
- /**
74
- * <p>A single IP address specification. This is used in the <a>MatchAttributes</a>
75
- * source and destination specifications.</p>
76
- */
77
- export interface Address {
78
- /**
79
- * <p>Specify an IP address or a block of IP addresses in Classless Inter-Domain Routing (CIDR) notation. Network Firewall supports all address ranges for IPv4. </p>
80
- * <p>Examples: </p>
81
- * <ul>
82
- * <li>
83
- * <p>To configure Network Firewall to inspect for the IP address 192.0.2.44, specify <code>192.0.2.44/32</code>.</p>
84
- * </li>
85
- * <li>
86
- * <p>To configure Network Firewall to inspect for IP addresses from 192.0.2.0 to 192.0.2.255, specify <code>192.0.2.0/24</code>.</p>
87
- * </li>
88
- * </ul>
89
- * <p>For more information about CIDR notation, see the Wikipedia entry <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">Classless
90
- * Inter-Domain Routing</a>.</p>
91
- */
92
- AddressDefinition: string | undefined;
93
- }
94
-
95
- export namespace Address {
96
- /**
97
- * @internal
98
- */
99
- export const filterSensitiveLog = (obj: Address): any => ({
100
- ...obj,
101
- });
102
- }
103
-
104
- export interface AssociateFirewallPolicyRequest {
105
- /**
106
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
107
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
108
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
109
- */
110
- UpdateToken?: string;
111
-
112
- /**
113
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
114
- * <p>You must specify the ARN or the name, and you can specify both. </p>
115
- */
116
- FirewallArn?: string;
117
-
118
- /**
119
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
120
- * <p>You must specify the ARN or the name, and you can specify both. </p>
121
- */
122
- FirewallName?: string;
123
-
124
- /**
125
- * <p>The Amazon Resource Name (ARN) of the firewall policy.</p>
126
- */
127
- FirewallPolicyArn: string | undefined;
128
- }
129
-
130
- export namespace AssociateFirewallPolicyRequest {
131
- /**
132
- * @internal
133
- */
134
- export const filterSensitiveLog = (obj: AssociateFirewallPolicyRequest): any => ({
135
- ...obj,
136
- });
137
- }
138
-
139
- export interface AssociateFirewallPolicyResponse {
140
- /**
141
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
142
- */
143
- FirewallArn?: string;
144
-
145
- /**
146
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
147
- */
148
- FirewallName?: string;
149
-
150
- /**
151
- * <p>The Amazon Resource Name (ARN) of the firewall policy.</p>
152
- */
153
- FirewallPolicyArn?: string;
154
-
155
- /**
156
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
157
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
158
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
159
- */
160
- UpdateToken?: string;
161
- }
162
-
163
- export namespace AssociateFirewallPolicyResponse {
164
- /**
165
- * @internal
166
- */
167
- export const filterSensitiveLog = (obj: AssociateFirewallPolicyResponse): any => ({
168
- ...obj,
169
- });
170
- }
171
-
172
- /**
173
- * <p>Your request is valid, but Network Firewall couldn’t perform the operation because of a
174
- * system problem. Retry your request. </p>
175
- */
176
- export interface InternalServerError extends __SmithyException, $MetadataBearer {
177
- name: "InternalServerError";
178
- $fault: "server";
179
- Message?: string;
180
- }
181
-
182
- export namespace InternalServerError {
183
- /**
184
- * @internal
185
- */
186
- export const filterSensitiveLog = (obj: InternalServerError): any => ({
187
- ...obj,
188
- });
189
- }
190
-
191
- /**
192
- * <p>The operation failed because it's not valid. For example, you might have tried to delete
193
- * a rule group or firewall policy that's in use.</p>
194
- */
195
- export interface InvalidOperationException extends __SmithyException, $MetadataBearer {
196
- name: "InvalidOperationException";
197
- $fault: "client";
198
- Message?: string;
199
- }
200
-
201
- export namespace InvalidOperationException {
202
- /**
203
- * @internal
204
- */
205
- export const filterSensitiveLog = (obj: InvalidOperationException): any => ({
206
- ...obj,
207
- });
208
- }
209
-
210
- /**
211
- * <p>The operation failed because of a problem with your request. Examples include: </p>
212
- * <ul>
213
- * <li>
214
- * <p>You specified an unsupported parameter name or value.</p>
215
- * </li>
216
- * <li>
217
- * <p>You tried to update a property with a value that isn't among the available
218
- * types.</p>
219
- * </li>
220
- * <li>
221
- * <p>Your request references an ARN that is malformed, or corresponds to a resource
222
- * that isn't valid in the context of the request.</p>
223
- * </li>
224
- * </ul>
225
- */
226
- export interface InvalidRequestException extends __SmithyException, $MetadataBearer {
227
- name: "InvalidRequestException";
228
- $fault: "client";
229
- Message?: string;
230
- }
231
-
232
- export namespace InvalidRequestException {
233
- /**
234
- * @internal
235
- */
236
- export const filterSensitiveLog = (obj: InvalidRequestException): any => ({
237
- ...obj,
238
- });
239
- }
240
-
241
- /**
242
- * <p>The token you provided is stale or isn't valid for the operation. </p>
243
- */
244
- export interface InvalidTokenException extends __SmithyException, $MetadataBearer {
245
- name: "InvalidTokenException";
246
- $fault: "client";
247
- Message?: string;
248
- }
249
-
250
- export namespace InvalidTokenException {
251
- /**
252
- * @internal
253
- */
254
- export const filterSensitiveLog = (obj: InvalidTokenException): any => ({
255
- ...obj,
256
- });
257
- }
258
-
259
- /**
260
- * <p>Unable to locate a resource using the parameters that you provided.</p>
261
- */
262
- export interface ResourceNotFoundException extends __SmithyException, $MetadataBearer {
263
- name: "ResourceNotFoundException";
264
- $fault: "client";
265
- Message?: string;
266
- }
267
-
268
- export namespace ResourceNotFoundException {
269
- /**
270
- * @internal
271
- */
272
- export const filterSensitiveLog = (obj: ResourceNotFoundException): any => ({
273
- ...obj,
274
- });
275
- }
276
-
277
- /**
278
- * <p>Unable to process the request due to throttling limitations.</p>
279
- */
280
- export interface ThrottlingException extends __SmithyException, $MetadataBearer {
281
- name: "ThrottlingException";
282
- $fault: "client";
283
- Message?: string;
284
- }
285
-
286
- export namespace ThrottlingException {
287
- /**
288
- * @internal
289
- */
290
- export const filterSensitiveLog = (obj: ThrottlingException): any => ({
291
- ...obj,
292
- });
293
- }
294
-
295
- /**
296
- * <p>The ID for a subnet that you want to associate with the firewall. This is used with
297
- * <a>CreateFirewall</a> and <a>AssociateSubnets</a>. AWS Network Firewall
298
- * creates an instance of the associated firewall in each subnet that you specify, to filter
299
- * traffic in the subnet's Availability Zone.</p>
300
- */
301
- export interface SubnetMapping {
302
- /**
303
- * <p>The unique identifier for the subnet. </p>
304
- */
305
- SubnetId: string | undefined;
306
- }
307
-
308
- export namespace SubnetMapping {
309
- /**
310
- * @internal
311
- */
312
- export const filterSensitiveLog = (obj: SubnetMapping): any => ({
313
- ...obj,
314
- });
315
- }
316
-
317
- export interface AssociateSubnetsRequest {
318
- /**
319
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
320
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
321
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
322
- */
323
- UpdateToken?: string;
324
-
325
- /**
326
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
327
- * <p>You must specify the ARN or the name, and you can specify both. </p>
328
- */
329
- FirewallArn?: string;
330
-
331
- /**
332
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
333
- * <p>You must specify the ARN or the name, and you can specify both. </p>
334
- */
335
- FirewallName?: string;
336
-
337
- /**
338
- * <p>The IDs of the subnets that you want to associate with the firewall. </p>
339
- */
340
- SubnetMappings: SubnetMapping[] | undefined;
341
- }
342
-
343
- export namespace AssociateSubnetsRequest {
344
- /**
345
- * @internal
346
- */
347
- export const filterSensitiveLog = (obj: AssociateSubnetsRequest): any => ({
348
- ...obj,
349
- });
350
- }
351
-
352
- export interface AssociateSubnetsResponse {
353
- /**
354
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
355
- */
356
- FirewallArn?: string;
357
-
358
- /**
359
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
360
- */
361
- FirewallName?: string;
362
-
363
- /**
364
- * <p>The IDs of the subnets that are associated with the firewall. </p>
365
- */
366
- SubnetMappings?: SubnetMapping[];
367
-
368
- /**
369
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
370
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
371
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
372
- */
373
- UpdateToken?: string;
374
- }
375
-
376
- export namespace AssociateSubnetsResponse {
377
- /**
378
- * @internal
379
- */
380
- export const filterSensitiveLog = (obj: AssociateSubnetsResponse): any => ({
381
- ...obj,
382
- });
383
- }
384
-
385
- /**
386
- * <p>AWS doesn't currently have enough available capacity to fulfill your request. Try your
387
- * request later. </p>
388
- */
389
- export interface InsufficientCapacityException extends __SmithyException, $MetadataBearer {
390
- name: "InsufficientCapacityException";
391
- $fault: "server";
392
- Message?: string;
393
- }
394
-
395
- export namespace InsufficientCapacityException {
396
- /**
397
- * @internal
398
- */
399
- export const filterSensitiveLog = (obj: InsufficientCapacityException): any => ({
400
- ...obj,
401
- });
402
- }
403
-
404
- export enum AttachmentStatus {
405
- CREATING = "CREATING",
406
- DELETING = "DELETING",
407
- READY = "READY",
408
- SCALING = "SCALING",
409
- }
410
-
411
- /**
412
- * <p>The configuration and status for a single subnet that you've specified for use by the
413
- * AWS Network Firewall firewall. This is part of the <a>FirewallStatus</a>.</p>
414
- */
415
- export interface Attachment {
416
- /**
417
- * <p>The unique identifier of the subnet that you've specified to be used for a firewall
418
- * endpoint. </p>
419
- */
420
- SubnetId?: string;
421
-
422
- /**
423
- * <p>The identifier of the firewall endpoint that Network Firewall has instantiated in the
424
- * subnet. You use this to identify the firewall endpoint in the VPC route tables, when you
425
- * redirect the VPC traffic through the endpoint. </p>
426
- */
427
- EndpointId?: string;
428
-
429
- /**
430
- * <p>The current status of the firewall endpoint in the subnet. This value reflects both the
431
- * instantiation of the endpoint in the VPC subnet and the sync states that are reported in
432
- * the <code>Config</code> settings. When this value is <code>READY</code>, the endpoint is
433
- * available and configured properly to handle network traffic. When the endpoint isn't
434
- * available for traffic, this value will reflect its state, for example
435
- * <code>CREATING</code>, <code>DELETING</code>, or <code>FAILED</code>.</p>
436
- */
437
- Status?: AttachmentStatus | string;
438
- }
439
-
440
- export namespace Attachment {
441
- /**
442
- * @internal
443
- */
444
- export const filterSensitiveLog = (obj: Attachment): any => ({
445
- ...obj,
446
- });
447
- }
448
-
449
- export enum ConfigurationSyncState {
450
- IN_SYNC = "IN_SYNC",
451
- PENDING = "PENDING",
452
- }
453
-
454
- /**
455
- * <p>A key:value pair associated with an AWS resource. The key:value pair can be anything you
456
- * define. Typically, the tag key represents a category (such as "environment") and the tag
457
- * value represents a specific value within that category (such as "test," "development," or
458
- * "production"). You can add up to 50 tags to each AWS resource. </p>
459
- */
460
- export interface Tag {
461
- /**
462
- * <p>The part of the key:value pair that defines a tag. You can use a tag key to describe a
463
- * category of information, such as "customer." Tag keys are case-sensitive.</p>
464
- */
465
- Key: string | undefined;
466
-
467
- /**
468
- * <p>The part of the key:value pair that defines a tag. You can use a tag value to describe a
469
- * specific value within a category, such as "companyA" or "companyB." Tag values are
470
- * case-sensitive.</p>
471
- */
472
- Value: string | undefined;
473
- }
474
-
475
- export namespace Tag {
476
- /**
477
- * @internal
478
- */
479
- export const filterSensitiveLog = (obj: Tag): any => ({
480
- ...obj,
481
- });
482
- }
483
-
484
- export interface CreateFirewallRequest {
485
- /**
486
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
487
- */
488
- FirewallName: string | undefined;
489
-
490
- /**
491
- * <p>The Amazon Resource Name (ARN) of the <a>FirewallPolicy</a> that you want to
492
- * use for the firewall.</p>
493
- */
494
- FirewallPolicyArn: string | undefined;
495
-
496
- /**
497
- * <p>The unique identifier of the VPC where Network Firewall should create the firewall. </p>
498
- * <p>You can't change this setting after you create the firewall. </p>
499
- */
500
- VpcId: string | undefined;
501
-
502
- /**
503
- * <p>The public subnets to use for your Network Firewall firewalls. Each subnet must belong to a
504
- * different Availability Zone in the VPC. Network Firewall creates a firewall endpoint in each
505
- * subnet. </p>
506
- */
507
- SubnetMappings: SubnetMapping[] | undefined;
508
-
509
- /**
510
- * <p>A flag indicating whether it is possible to delete the firewall. A setting of <code>TRUE</code> indicates
511
- * that the firewall is protected against deletion. Use this setting to protect against
512
- * accidentally deleting a firewall that is in use. When you create a firewall, the operation initializes this flag to <code>TRUE</code>.</p>
513
- */
514
- DeleteProtection?: boolean;
515
-
516
- /**
517
- * <p>A setting indicating whether the firewall is protected against changes to the subnet associations.
518
- * Use this setting to protect against
519
- * accidentally modifying the subnet associations for a firewall that is in use. When you create a firewall, the operation initializes this setting to <code>TRUE</code>.</p>
520
- */
521
- SubnetChangeProtection?: boolean;
522
-
523
- /**
524
- * <p>A setting indicating whether the firewall is protected against a change to the firewall policy association.
525
- * Use this setting to protect against
526
- * accidentally modifying the firewall policy for a firewall that is in use. When you create a firewall, the operation initializes this setting to <code>TRUE</code>.</p>
527
- */
528
- FirewallPolicyChangeProtection?: boolean;
529
-
530
- /**
531
- * <p>A description of the firewall.</p>
532
- */
533
- Description?: string;
534
-
535
- /**
536
- * <p>The key:value pairs to associate with the resource.</p>
537
- */
538
- Tags?: Tag[];
539
- }
540
-
541
- export namespace CreateFirewallRequest {
542
- /**
543
- * @internal
544
- */
545
- export const filterSensitiveLog = (obj: CreateFirewallRequest): any => ({
546
- ...obj,
547
- });
548
- }
549
-
550
- /**
551
- * <p>The firewall defines the configuration settings for an AWS Network Firewall firewall. These settings include the firewall policy, the subnets in your VPC to use for the firewall endpoints, and any tags that are attached to the firewall AWS resource. </p>
552
- * <p>The status of the firewall, for example whether it's ready to filter network traffic,
553
- * is provided in the corresponding <a>FirewallStatus</a>. You can retrieve both
554
- * objects by calling <a>DescribeFirewall</a>.</p>
555
- */
556
- export interface Firewall {
557
- /**
558
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
559
- */
560
- FirewallName?: string;
561
-
562
- /**
563
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
564
- */
565
- FirewallArn?: string;
566
-
567
- /**
568
- * <p>The Amazon Resource Name (ARN) of the firewall policy.</p>
569
- * <p>The relationship of firewall to firewall policy is many to one. Each firewall requires
570
- * one firewall policy association, and you can use the same firewall policy for multiple
571
- * firewalls. </p>
572
- */
573
- FirewallPolicyArn: string | undefined;
574
-
575
- /**
576
- * <p>The unique identifier of the VPC where the firewall is in use. </p>
577
- */
578
- VpcId: string | undefined;
579
-
580
- /**
581
- * <p>The public subnets that Network Firewall is using for the firewall. Each subnet must belong
582
- * to a different Availability Zone. </p>
583
- */
584
- SubnetMappings: SubnetMapping[] | undefined;
585
-
586
- /**
587
- * <p>A flag indicating whether it is possible to delete the firewall. A setting of <code>TRUE</code> indicates
588
- * that the firewall is protected against deletion. Use this setting to protect against
589
- * accidentally deleting a firewall that is in use. When you create a firewall, the operation initializes this flag to <code>TRUE</code>.</p>
590
- */
591
- DeleteProtection?: boolean;
592
-
593
- /**
594
- * <p>A setting indicating whether the firewall is protected against changes to the subnet associations.
595
- * Use this setting to protect against
596
- * accidentally modifying the subnet associations for a firewall that is in use. When you create a firewall, the operation initializes this setting to <code>TRUE</code>.</p>
597
- */
598
- SubnetChangeProtection?: boolean;
599
-
600
- /**
601
- * <p>A setting indicating whether the firewall is protected against a change to the firewall policy association.
602
- * Use this setting to protect against
603
- * accidentally modifying the firewall policy for a firewall that is in use. When you create a firewall, the operation initializes this setting to <code>TRUE</code>.</p>
604
- */
605
- FirewallPolicyChangeProtection?: boolean;
606
-
607
- /**
608
- * <p>A description of the firewall.</p>
609
- */
610
- Description?: string;
611
-
612
- /**
613
- * <p>The unique identifier for the firewall. </p>
614
- */
615
- FirewallId: string | undefined;
616
-
617
- /**
618
- * <p></p>
619
- */
620
- Tags?: Tag[];
621
- }
622
-
623
- export namespace Firewall {
624
- /**
625
- * @internal
626
- */
627
- export const filterSensitiveLog = (obj: Firewall): any => ({
628
- ...obj,
629
- });
630
- }
631
-
632
- export enum FirewallStatusValue {
633
- DELETING = "DELETING",
634
- PROVISIONING = "PROVISIONING",
635
- READY = "READY",
636
- }
637
-
638
- export enum PerObjectSyncStatus {
639
- IN_SYNC = "IN_SYNC",
640
- PENDING = "PENDING",
641
- }
642
-
643
- /**
644
- * <p>Provides configuration status for a single policy or rule group that is used for a firewall endpoint. Network Firewall
645
- * provides each endpoint with the rules that are configured in the firewall policy. Each time
646
- * you add a subnet or modify the associated firewall policy, Network Firewall synchronizes the
647
- * rules in the endpoint, so it can properly filter network traffic. This is part of a <a>SyncState</a> for a firewall.</p>
648
- */
649
- export interface PerObjectStatus {
650
- /**
651
- * <p>Indicates whether this object is in sync with the version indicated in the update token.</p>
652
- */
653
- SyncStatus?: PerObjectSyncStatus | string;
654
-
655
- /**
656
- * <p>The current version of the object that is either in sync or pending synchronization. </p>
657
- */
658
- UpdateToken?: string;
659
- }
660
-
661
- export namespace PerObjectStatus {
662
- /**
663
- * @internal
664
- */
665
- export const filterSensitiveLog = (obj: PerObjectStatus): any => ({
666
- ...obj,
667
- });
668
- }
669
-
670
- /**
671
- * <p>The status of the firewall endpoint and firewall policy configuration for a single VPC
672
- * subnet. </p>
673
- * <p>For each VPC subnet that you associate with a firewall, AWS Network Firewall does the
674
- * following: </p>
675
- * <ul>
676
- * <li>
677
- * <p>Instantiates a firewall endpoint in the subnet, ready to take traffic.</p>
678
- * </li>
679
- * <li>
680
- * <p>Configures the endpoint with the current firewall policy settings, to provide the
681
- * filtering behavior for the endpoint.</p>
682
- * </li>
683
- * </ul>
684
- * <p>When you update a firewall, for example to add a subnet association or change a rule
685
- * group in the firewall policy, the affected sync states reflect out-of-sync or not ready
686
- * status until the changes are complete. </p>
687
- */
688
- export interface SyncState {
689
- /**
690
- * <p>The attachment status of the firewall's association with a single VPC subnet. For each
691
- * configured subnet, Network Firewall creates the attachment by instantiating the firewall
692
- * endpoint in the subnet so that it's ready to take traffic. This is part of the <a>FirewallStatus</a>.</p>
693
- */
694
- Attachment?: Attachment;
695
-
696
- /**
697
- * <p>The configuration status of the firewall endpoint in a single VPC subnet. Network Firewall
698
- * provides each endpoint with the rules that are configured in the firewall policy. Each time
699
- * you add a subnet or modify the associated firewall policy, Network Firewall synchronizes the
700
- * rules in the endpoint, so it can properly filter network traffic. This is part of the <a>FirewallStatus</a>.</p>
701
- */
702
- Config?: { [key: string]: PerObjectStatus };
703
- }
704
-
705
- export namespace SyncState {
706
- /**
707
- * @internal
708
- */
709
- export const filterSensitiveLog = (obj: SyncState): any => ({
710
- ...obj,
711
- });
712
- }
713
-
714
- /**
715
- * <p>Detailed information about the current status of a <a>Firewall</a>. You can retrieve this for a firewall by calling <a>DescribeFirewall</a> and providing the firewall name and ARN.</p>
716
- */
717
- export interface FirewallStatus {
718
- /**
719
- * <p>The readiness of the configured firewall to handle network traffic across all of the
720
- * Availability Zones where you've configured it. This setting is <code>READY</code> only when
721
- * the <code>ConfigurationSyncStateSummary</code> value is <code>IN_SYNC</code> and the
722
- * <code>Attachment</code>
723
- * <code>Status</code> values for all of the configured subnets are <code>READY</code>.
724
- * </p>
725
- */
726
- Status: FirewallStatusValue | string | undefined;
727
-
728
- /**
729
- * <p>The configuration sync state for the firewall. This summarizes the sync states reported
730
- * in the <code>Config</code> settings for all of the Availability Zones where you have
731
- * configured the firewall. </p>
732
- * <p>When you create a firewall or update its configuration, for example by adding a rule
733
- * group to its firewall policy, Network Firewall distributes the configuration changes to all
734
- * zones where the firewall is in use. This summary indicates whether the configuration
735
- * changes have been applied everywhere. </p>
736
- * <p>This status must be <code>IN_SYNC</code> for the firewall to be ready for use, but it
737
- * doesn't indicate that the firewall is ready. The <code>Status</code> setting indicates
738
- * firewall readiness.</p>
739
- */
740
- ConfigurationSyncStateSummary: ConfigurationSyncState | string | undefined;
741
-
742
- /**
743
- * <p>The subnets that you've configured for use by the Network Firewall firewall. This contains
744
- * one array element per Availability Zone where you've configured a subnet. These objects
745
- * provide details of the information that is summarized in the
746
- * <code>ConfigurationSyncStateSummary</code> and <code>Status</code>, broken down by zone
747
- * and configuration object. </p>
748
- */
749
- SyncStates?: { [key: string]: SyncState };
750
- }
751
-
752
- export namespace FirewallStatus {
753
- /**
754
- * @internal
755
- */
756
- export const filterSensitiveLog = (obj: FirewallStatus): any => ({
757
- ...obj,
758
- });
759
- }
760
-
761
- export interface CreateFirewallResponse {
762
- /**
763
- * <p>The configuration settings for the firewall. These settings include the firewall policy and the subnets in your VPC to use for the firewall endpoints. </p>
764
- */
765
- Firewall?: Firewall;
766
-
767
- /**
768
- * <p>Detailed information about the current status of a <a>Firewall</a>. You can retrieve this for a firewall by calling <a>DescribeFirewall</a> and providing the firewall name and ARN.</p>
769
- */
770
- FirewallStatus?: FirewallStatus;
771
- }
772
-
773
- export namespace CreateFirewallResponse {
774
- /**
775
- * @internal
776
- */
777
- export const filterSensitiveLog = (obj: CreateFirewallResponse): any => ({
778
- ...obj,
779
- });
780
- }
781
-
782
- /**
783
- * <p>Unable to perform the operation because doing so would violate a limit setting. </p>
784
- */
785
- export interface LimitExceededException extends __SmithyException, $MetadataBearer {
786
- name: "LimitExceededException";
787
- $fault: "client";
788
- Message?: string;
789
- }
790
-
791
- export namespace LimitExceededException {
792
- /**
793
- * @internal
794
- */
795
- export const filterSensitiveLog = (obj: LimitExceededException): any => ({
796
- ...obj,
797
- });
798
- }
799
-
800
- export enum RuleOrder {
801
- DEFAULT_ACTION_ORDER = "DEFAULT_ACTION_ORDER",
802
- STRICT_ORDER = "STRICT_ORDER",
803
- }
804
-
805
- /**
806
- * <p>Configuration settings for the handling of the stateful rule groups in a firewall policy. </p>
807
- */
808
- export interface StatefulEngineOptions {
809
- /**
810
- * <p>Indicates how to manage the order of stateful rule evaluation for the policy. By default, Network Firewall
811
- * leaves the rule evaluation order up to the Suricata rule processing engine. If you set
812
- * this to <code>STRICT_ORDER</code>, your rules are evaluated in the exact order that you provide them
813
- * in the policy. With strict ordering, the rule groups are evaluated by order of priority, starting from the lowest number, and
814
- * the rules in each rule group are processed in the order that they're defined. </p>
815
- */
816
- RuleOrder?: RuleOrder | string;
817
- }
818
-
819
- export namespace StatefulEngineOptions {
820
- /**
821
- * @internal
822
- */
823
- export const filterSensitiveLog = (obj: StatefulEngineOptions): any => ({
824
- ...obj,
825
- });
826
- }
827
-
828
- /**
829
- * <p>Identifier for a single stateful rule group, used in a firewall policy to refer to a
830
- * rule group. </p>
831
- */
832
- export interface StatefulRuleGroupReference {
833
- /**
834
- * <p>The Amazon Resource Name (ARN) of the stateful rule group.</p>
835
- */
836
- ResourceArn: string | undefined;
837
-
838
- /**
839
- * <p>An integer setting that indicates the order in which to run the stateful rule groups in
840
- * a single <a>FirewallPolicy</a>. This setting only applies to firewall policies
841
- * that specify the <code>STRICT_ORDER</code> rule order in the stateful engine options settings.</p>
842
- * <p>Network Firewall evalutes each stateful rule group
843
- * against a packet starting with the group that has the lowest priority setting. You must ensure
844
- * that the priority settings are unique within each policy.</p>
845
- * <p>You can change the priority settings of your rule groups at any time. To make it easier to
846
- * insert rule groups later, number them so there's a wide range in between, for example use 100,
847
- * 200, and so on. </p>
848
- */
849
- Priority?: number;
850
- }
851
-
852
- export namespace StatefulRuleGroupReference {
853
- /**
854
- * @internal
855
- */
856
- export const filterSensitiveLog = (obj: StatefulRuleGroupReference): any => ({
857
- ...obj,
858
- });
859
- }
860
-
861
- /**
862
- * <p>An optional, non-standard action to use for stateless packet handling. You can define
863
- * this in addition to the standard action that you must specify. </p>
864
- * <p>You define and name the custom actions that you want to be able to use, and then you
865
- * reference them by name in your actions settings. </p>
866
- * <p>You can use custom actions in the following places: </p>
867
- * <ul>
868
- * <li>
869
- * <p>In a rule group's <a>StatelessRulesAndCustomActions</a> specification.
870
- * The custom actions are available for use by name inside the
871
- * <code>StatelessRulesAndCustomActions</code> where you define them. You can use
872
- * them for your stateless rule actions to specify what to do with a packet that matches
873
- * the rule's match attributes. </p>
874
- * </li>
875
- * <li>
876
- * <p>In a <a>FirewallPolicy</a> specification, in
877
- * <code>StatelessCustomActions</code>. The custom actions are available for use
878
- * inside the policy where you define them. You can use them for the policy's default
879
- * stateless actions settings to specify what to do with packets that don't match any of
880
- * the policy's stateless rules. </p>
881
- * </li>
882
- * </ul>
883
- */
884
- export interface CustomAction {
885
- /**
886
- * <p>The descriptive name of the custom action. You can't change the name of a custom action after you create it.</p>
887
- */
888
- ActionName: string | undefined;
889
-
890
- /**
891
- * <p>The custom action associated with the action name.</p>
892
- */
893
- ActionDefinition: ActionDefinition | undefined;
894
- }
895
-
896
- export namespace CustomAction {
897
- /**
898
- * @internal
899
- */
900
- export const filterSensitiveLog = (obj: CustomAction): any => ({
901
- ...obj,
902
- });
903
- }
904
-
905
- /**
906
- * <p>Identifier for a single stateless rule group, used in a firewall policy to refer to the
907
- * rule group. </p>
908
- */
909
- export interface StatelessRuleGroupReference {
910
- /**
911
- * <p>The Amazon Resource Name (ARN) of the stateless rule group.</p>
912
- */
913
- ResourceArn: string | undefined;
914
-
915
- /**
916
- * <p>An integer setting that indicates the order in which to run the stateless rule groups in
917
- * a single <a>FirewallPolicy</a>. Network Firewall applies each stateless rule group
918
- * to a packet starting with the group that has the lowest priority setting. You must ensure
919
- * that the priority settings are unique within each policy.</p>
920
- */
921
- Priority: number | undefined;
922
- }
923
-
924
- export namespace StatelessRuleGroupReference {
925
- /**
926
- * @internal
927
- */
928
- export const filterSensitiveLog = (obj: StatelessRuleGroupReference): any => ({
929
- ...obj,
930
- });
931
- }
932
-
933
- /**
934
- * <p>The firewall policy defines the behavior of a firewall using a collection of stateless
935
- * and stateful rule groups and other settings. You can use one firewall policy for multiple
936
- * firewalls. </p>
937
- * <p>This, along with <a>FirewallPolicyResponse</a>, define the policy.
938
- * You can retrieve all objects for a firewall policy by calling <a>DescribeFirewallPolicy</a>.</p>
939
- */
940
- export interface FirewallPolicy {
941
- /**
942
- * <p>References to the stateless rule groups that are used in the policy. These define the
943
- * matching criteria in stateless rules. </p>
944
- */
945
- StatelessRuleGroupReferences?: StatelessRuleGroupReference[];
946
-
947
- /**
948
- * <p>The actions to take on a packet if it doesn't match any of the stateless rules in the
949
- * policy. If you want non-matching packets to be forwarded for stateful inspection, specify
950
- * <code>aws:forward_to_sfe</code>. </p>
951
- * <p>You must specify one of the standard actions: <code>aws:pass</code>,
952
- * <code>aws:drop</code>, or <code>aws:forward_to_sfe</code>. In addition, you can specify
953
- * custom actions that are compatible with your standard section choice.</p>
954
- * <p>For example, you could specify <code>["aws:pass"]</code> or you could specify
955
- * <code>["aws:pass", “customActionName”]</code>. For information about compatibility, see
956
- * the custom action descriptions under <a>CustomAction</a>.</p>
957
- */
958
- StatelessDefaultActions: string[] | undefined;
959
-
960
- /**
961
- * <p>The actions to take on a fragmented UDP packet if it doesn't match any of the stateless
962
- * rules in the policy. Network Firewall only manages UDP packet fragments and silently drops packet fragments for other protocols.
963
- * If you want non-matching fragmented UDP packets to be forwarded for
964
- * stateful inspection, specify <code>aws:forward_to_sfe</code>. </p>
965
- * <p>You must specify one of the standard actions: <code>aws:pass</code>,
966
- * <code>aws:drop</code>, or <code>aws:forward_to_sfe</code>. In addition, you can specify
967
- * custom actions that are compatible with your standard section choice.</p>
968
- * <p>For example, you could specify <code>["aws:pass"]</code> or you could specify
969
- * <code>["aws:pass", “customActionName”]</code>. For information about compatibility, see
970
- * the custom action descriptions under <a>CustomAction</a>.</p>
971
- */
972
- StatelessFragmentDefaultActions: string[] | undefined;
973
-
974
- /**
975
- * <p>The custom action definitions that are available for use in the firewall policy's
976
- * <code>StatelessDefaultActions</code> setting. You name each custom action that you
977
- * define, and then you can use it by name in your default actions specifications.</p>
978
- */
979
- StatelessCustomActions?: CustomAction[];
980
-
981
- /**
982
- * <p>References to the stateful rule groups that are used in the policy. These define the
983
- * inspection criteria in stateful rules. </p>
984
- */
985
- StatefulRuleGroupReferences?: StatefulRuleGroupReference[];
986
-
987
- /**
988
- * <p>The default actions to take on a packet that doesn't match any stateful rules.</p>
989
- */
990
- StatefulDefaultActions?: string[];
991
-
992
- /**
993
- * <p>Additional options governing how Network Firewall handles stateful rules. The stateful
994
- * rule groups that you use in your policy must have stateful rule options settings that are compatible with these settings.</p>
995
- */
996
- StatefulEngineOptions?: StatefulEngineOptions;
997
- }
998
-
999
- export namespace FirewallPolicy {
1000
- /**
1001
- * @internal
1002
- */
1003
- export const filterSensitiveLog = (obj: FirewallPolicy): any => ({
1004
- ...obj,
1005
- });
1006
- }
1007
-
1008
- export interface CreateFirewallPolicyRequest {
1009
- /**
1010
- * <p>The descriptive name of the firewall policy. You can't change the name of a firewall policy after you create it.</p>
1011
- */
1012
- FirewallPolicyName: string | undefined;
1013
-
1014
- /**
1015
- * <p>The rule groups and policy actions to use in the firewall policy.</p>
1016
- */
1017
- FirewallPolicy: FirewallPolicy | undefined;
1018
-
1019
- /**
1020
- * <p>A description of the firewall policy.</p>
1021
- */
1022
- Description?: string;
1023
-
1024
- /**
1025
- * <p>The key:value pairs to associate with the resource.</p>
1026
- */
1027
- Tags?: Tag[];
1028
-
1029
- /**
1030
- * <p>Indicates whether you want Network Firewall to just check the validity of the request, rather than run the request. </p>
1031
- * <p>If set to <code>TRUE</code>, Network Firewall checks whether the request can run successfully,
1032
- * but doesn't actually make the requested changes. The call returns the value that the request would return if you ran it with
1033
- * dry run set to <code>FALSE</code>, but doesn't make additions or changes to your resources. This option allows you to make sure that you have
1034
- * the required permissions to run the request and that your request parameters are valid. </p>
1035
- * <p>If set to <code>FALSE</code>, Network Firewall makes the requested changes to your resources. </p>
1036
- */
1037
- DryRun?: boolean;
1038
- }
1039
-
1040
- export namespace CreateFirewallPolicyRequest {
1041
- /**
1042
- * @internal
1043
- */
1044
- export const filterSensitiveLog = (obj: CreateFirewallPolicyRequest): any => ({
1045
- ...obj,
1046
- });
1047
- }
1048
-
1049
- export enum ResourceStatus {
1050
- ACTIVE = "ACTIVE",
1051
- DELETING = "DELETING",
1052
- }
1053
-
1054
- /**
1055
- * <p>The high-level properties of a firewall policy. This, along with the <a>FirewallPolicy</a>, define the policy. You can retrieve all objects for a firewall policy by calling <a>DescribeFirewallPolicy</a>. </p>
1056
- */
1057
- export interface FirewallPolicyResponse {
1058
- /**
1059
- * <p>The descriptive name of the firewall policy. You can't change the name of a firewall policy after you create it.</p>
1060
- */
1061
- FirewallPolicyName: string | undefined;
1062
-
1063
- /**
1064
- * <p>The Amazon Resource Name (ARN) of the firewall policy.</p>
1065
- * <note>
1066
- * <p>If this response is for a create request that had <code>DryRun</code> set to
1067
- * <code>TRUE</code>, then this ARN is a placeholder that isn't attached to a valid
1068
- * resource.</p>
1069
- * </note>
1070
- */
1071
- FirewallPolicyArn: string | undefined;
1072
-
1073
- /**
1074
- * <p>The unique identifier for the firewall policy. </p>
1075
- */
1076
- FirewallPolicyId: string | undefined;
1077
-
1078
- /**
1079
- * <p>A description of the firewall policy.</p>
1080
- */
1081
- Description?: string;
1082
-
1083
- /**
1084
- * <p>The current status of the firewall policy. You can retrieve this for a firewall policy
1085
- * by calling <a>DescribeFirewallPolicy</a> and providing the firewall policy's
1086
- * name or ARN.</p>
1087
- */
1088
- FirewallPolicyStatus?: ResourceStatus | string;
1089
-
1090
- /**
1091
- * <p>The key:value pairs to associate with the resource.</p>
1092
- */
1093
- Tags?: Tag[];
1094
-
1095
- /**
1096
- * <p>The number of capacity units currently consumed by the policy's stateless rules.</p>
1097
- */
1098
- ConsumedStatelessRuleCapacity?: number;
1099
-
1100
- /**
1101
- * <p>The number of capacity units currently consumed by the policy's stateful rules.</p>
1102
- */
1103
- ConsumedStatefulRuleCapacity?: number;
1104
-
1105
- /**
1106
- * <p>The number of firewalls that are associated with this firewall policy.</p>
1107
- */
1108
- NumberOfAssociations?: number;
1109
- }
1110
-
1111
- export namespace FirewallPolicyResponse {
1112
- /**
1113
- * @internal
1114
- */
1115
- export const filterSensitiveLog = (obj: FirewallPolicyResponse): any => ({
1116
- ...obj,
1117
- });
1118
- }
1119
-
1120
- export interface CreateFirewallPolicyResponse {
1121
- /**
1122
- * <p>A token used for optimistic locking. Network Firewall returns a token to your requests that access the firewall policy. The token marks the state of the policy resource at the time of the request. </p>
1123
- * <p>To make changes to the policy, you provide the token in your request. Network Firewall uses the token to ensure that the policy hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall policy again to get a current copy of it with current token. Reapply your changes as needed, then try the operation again using the new token. </p>
1124
- */
1125
- UpdateToken: string | undefined;
1126
-
1127
- /**
1128
- * <p>The high-level properties of a firewall policy. This, along with the <a>FirewallPolicy</a>, define the policy. You can retrieve all objects for a firewall policy by calling <a>DescribeFirewallPolicy</a>. </p>
1129
- */
1130
- FirewallPolicyResponse: FirewallPolicyResponse | undefined;
1131
- }
1132
-
1133
- export namespace CreateFirewallPolicyResponse {
1134
- /**
1135
- * @internal
1136
- */
1137
- export const filterSensitiveLog = (obj: CreateFirewallPolicyResponse): any => ({
1138
- ...obj,
1139
- });
1140
- }
1141
-
1142
- export enum GeneratedRulesType {
1143
- ALLOWLIST = "ALLOWLIST",
1144
- DENYLIST = "DENYLIST",
1145
- }
1146
-
1147
- export enum TargetType {
1148
- HTTP_HOST = "HTTP_HOST",
1149
- TLS_SNI = "TLS_SNI",
1150
- }
1151
-
1152
- /**
1153
- * <p>Stateful inspection criteria for a domain list rule group. </p>
1154
- * <p>For HTTPS traffic, domain filtering is SNI-based. It uses the server name indicator extension of the TLS handshake.</p>
1155
- * <p>By default, Network Firewall domain list inspection only includes traffic coming from the VPC where you deploy the firewall. To inspect traffic from IP addresses outside of the deployment VPC, you set the <code>HOME_NET</code> rule variable to include the CIDR range of the deployment VPC plus the other CIDR ranges. For more information, see <a>RuleVariables</a> in this guide and <a href="https://docs.aws.amazon.com/network-firewall/latest/developerguide/stateful-rule-groups-domain-names.html">Stateful domain list rule groups in AWS Network Firewall</a> in the <i>Network Firewall Developer Guide</i>.</p>
1156
- */
1157
- export interface RulesSourceList {
1158
- /**
1159
- * <p>The domains that you want to inspect for in your traffic flows. To provide multiple
1160
- * domains, separate them with commas. Valid domain specifications are the following:</p>
1161
- * <ul>
1162
- * <li>
1163
- * <p>Explicit names. For example, <code>abc.example.com</code> matches only the domain <code>abc.example.com</code>.</p>
1164
- * </li>
1165
- * <li>
1166
- * <p>Names that use a domain wildcard, which you indicate with an initial '<code>.</code>'. For example,<code>.example.com</code> matches <code>example.com</code> and matches all subdomains of <code>example.com</code>, such as <code>abc.example.com</code> and <code>www.example.com</code>. </p>
1167
- * </li>
1168
- * </ul>
1169
- */
1170
- Targets: string[] | undefined;
1171
-
1172
- /**
1173
- * <p>The protocols you want to inspect. Specify <code>TLS_SNI</code> for <code>HTTPS</code>. Specify <code>HTTP_HOST</code> for <code>HTTP</code>. You can specify either or both. </p>
1174
- */
1175
- TargetTypes: (TargetType | string)[] | undefined;
1176
-
1177
- /**
1178
- * <p>Whether you want to allow or deny access to the domains in your target list.</p>
1179
- */
1180
- GeneratedRulesType: GeneratedRulesType | string | undefined;
1181
- }
1182
-
1183
- export namespace RulesSourceList {
1184
- /**
1185
- * @internal
1186
- */
1187
- export const filterSensitiveLog = (obj: RulesSourceList): any => ({
1188
- ...obj,
1189
- });
1190
- }
1191
-
1192
- export enum StatefulAction {
1193
- ALERT = "ALERT",
1194
- DROP = "DROP",
1195
- PASS = "PASS",
1196
- }
1197
-
1198
- export enum StatefulRuleDirection {
1199
- ANY = "ANY",
1200
- FORWARD = "FORWARD",
1201
- }
1202
-
1203
- export enum StatefulRuleProtocol {
1204
- ANY = "IP",
1205
- DCERPC = "DCERPC",
1206
- DHCP = "DHCP",
1207
- DNS = "DNS",
1208
- FTP = "FTP",
1209
- HTTP = "HTTP",
1210
- ICMP = "ICMP",
1211
- IKEV2 = "IKEV2",
1212
- IMAP = "IMAP",
1213
- KRB5 = "KRB5",
1214
- MSN = "MSN",
1215
- NTP = "NTP",
1216
- SMB = "SMB",
1217
- SMTP = "SMTP",
1218
- SSH = "SSH",
1219
- TCP = "TCP",
1220
- TFTP = "TFTP",
1221
- TLS = "TLS",
1222
- UDP = "UDP",
1223
- }
1224
-
1225
- /**
1226
- * <p>The basic rule criteria for AWS Network Firewall to use to inspect packet headers in stateful
1227
- * traffic flow inspection. Traffic flows that match the criteria are a match for the
1228
- * corresponding <a>StatefulRule</a>. </p>
1229
- */
1230
- export interface Header {
1231
- /**
1232
- * <p>The protocol to inspect for. To specify all, you can use <code>IP</code>, because all traffic on AWS and on the internet is IP.</p>
1233
- */
1234
- Protocol: StatefulRuleProtocol | string | undefined;
1235
-
1236
- /**
1237
- * <p>The source IP address or address range to inspect for, in CIDR notation.
1238
- * To match with any address, specify <code>ANY</code>. </p>
1239
- * <p>Specify an IP address or a block of IP addresses in Classless Inter-Domain Routing (CIDR) notation. Network Firewall supports all address ranges for IPv4. </p>
1240
- * <p>Examples: </p>
1241
- * <ul>
1242
- * <li>
1243
- * <p>To configure Network Firewall to inspect for the IP address 192.0.2.44, specify <code>192.0.2.44/32</code>.</p>
1244
- * </li>
1245
- * <li>
1246
- * <p>To configure Network Firewall to inspect for IP addresses from 192.0.2.0 to 192.0.2.255, specify <code>192.0.2.0/24</code>.</p>
1247
- * </li>
1248
- * </ul>
1249
- * <p>For more information about CIDR notation, see the Wikipedia entry <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">Classless
1250
- * Inter-Domain Routing</a>.</p>
1251
- */
1252
- Source: string | undefined;
1253
-
1254
- /**
1255
- * <p>The source port to inspect for. You can specify an individual port, for
1256
- * example <code>1994</code> and you can specify a port
1257
- * range, for example <code>1990:1994</code>.
1258
- * To match with any port, specify <code>ANY</code>. </p>
1259
- */
1260
- SourcePort: string | undefined;
1261
-
1262
- /**
1263
- * <p>The direction of traffic flow to inspect. If set to <code>ANY</code>, the inspection
1264
- * matches bidirectional traffic, both from the source to the destination and from the
1265
- * destination to the source. If set to <code>FORWARD</code>, the inspection only matches
1266
- * traffic going from the source to the destination. </p>
1267
- */
1268
- Direction: StatefulRuleDirection | string | undefined;
1269
-
1270
- /**
1271
- * <p>The destination IP address or address range to inspect for, in CIDR notation.
1272
- * To match with any address, specify <code>ANY</code>. </p>
1273
- * <p>Specify an IP address or a block of IP addresses in Classless Inter-Domain Routing (CIDR) notation. Network Firewall supports all address ranges for IPv4. </p>
1274
- * <p>Examples: </p>
1275
- * <ul>
1276
- * <li>
1277
- * <p>To configure Network Firewall to inspect for the IP address 192.0.2.44, specify <code>192.0.2.44/32</code>.</p>
1278
- * </li>
1279
- * <li>
1280
- * <p>To configure Network Firewall to inspect for IP addresses from 192.0.2.0 to 192.0.2.255, specify <code>192.0.2.0/24</code>.</p>
1281
- * </li>
1282
- * </ul>
1283
- * <p>For more information about CIDR notation, see the Wikipedia entry <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">Classless
1284
- * Inter-Domain Routing</a>.</p>
1285
- */
1286
- Destination: string | undefined;
1287
-
1288
- /**
1289
- * <p>The destination port to inspect for. You can specify an individual port, for
1290
- * example <code>1994</code> and you can specify
1291
- * a port range, for example <code>1990:1994</code>.
1292
- * To match with any port, specify <code>ANY</code>. </p>
1293
- */
1294
- DestinationPort: string | undefined;
1295
- }
1296
-
1297
- export namespace Header {
1298
- /**
1299
- * @internal
1300
- */
1301
- export const filterSensitiveLog = (obj: Header): any => ({
1302
- ...obj,
1303
- });
1304
- }
1305
-
1306
- /**
1307
- * <p>Additional settings for a stateful rule. This is part of the <a>StatefulRule</a> configuration.</p>
1308
- */
1309
- export interface RuleOption {
1310
- /**
1311
- * <p></p>
1312
- */
1313
- Keyword: string | undefined;
1314
-
1315
- /**
1316
- * <p></p>
1317
- */
1318
- Settings?: string[];
1319
- }
1320
-
1321
- export namespace RuleOption {
1322
- /**
1323
- * @internal
1324
- */
1325
- export const filterSensitiveLog = (obj: RuleOption): any => ({
1326
- ...obj,
1327
- });
1328
- }
1329
-
1330
- /**
1331
- * <p>A single Suricata rules specification, for use in a stateful rule group.
1332
- * Use this option to specify a simple Suricata rule with protocol, source and destination, ports, direction, and rule options.
1333
- * For information about the Suricata <code>Rules</code> format, see
1334
- * <a href="https://suricata.readthedocs.io/en/suricata-5.0.0/rules/intro.html#">Rules Format</a>. </p>
1335
- */
1336
- export interface StatefulRule {
1337
- /**
1338
- * <p>Defines what Network Firewall should do with the packets in a traffic flow when the flow
1339
- * matches the stateful rule criteria. For all actions, Network Firewall performs the specified
1340
- * action and discontinues stateful inspection of the traffic flow. </p>
1341
- * <p>The actions for a stateful rule are defined as follows: </p>
1342
- * <ul>
1343
- * <li>
1344
- * <p>
1345
- * <b>PASS</b> - Permits the packets to go to the
1346
- * intended destination.</p>
1347
- * </li>
1348
- * <li>
1349
- * <p>
1350
- * <b>DROP</b> - Blocks the packets from going to
1351
- * the intended destination and sends an alert log message, if alert logging is configured in the <a>Firewall</a>
1352
- * <a>LoggingConfiguration</a>. </p>
1353
- * </li>
1354
- * <li>
1355
- * <p>
1356
- * <b>ALERT</b> - Permits the packets to go to the
1357
- * intended destination and sends an alert log message, if alert logging is configured in the <a>Firewall</a>
1358
- * <a>LoggingConfiguration</a>. </p>
1359
- * <p>You can use this action to test a rule that you intend to use to drop traffic. You
1360
- * can enable the rule with <code>ALERT</code> action, verify in the logs that the rule
1361
- * is filtering as you want, then change the action to <code>DROP</code>.</p>
1362
- * </li>
1363
- * </ul>
1364
- */
1365
- Action: StatefulAction | string | undefined;
1366
-
1367
- /**
1368
- * <p>The stateful inspection criteria for this rule, used to inspect traffic flows.
1369
- * </p>
1370
- */
1371
- Header: Header | undefined;
1372
-
1373
- /**
1374
- * <p>Additional options for the rule. These are the Suricata <code>RuleOptions</code> settings.</p>
1375
- */
1376
- RuleOptions: RuleOption[] | undefined;
1377
- }
1378
-
1379
- export namespace StatefulRule {
1380
- /**
1381
- * @internal
1382
- */
1383
- export const filterSensitiveLog = (obj: StatefulRule): any => ({
1384
- ...obj,
1385
- });
1386
- }
1387
-
1388
- /**
1389
- * <p>A single port range specification. This is used for source and destination port ranges
1390
- * in the stateless rule <a>MatchAttributes</a>, <code>SourcePorts</code>, and
1391
- * <code>DestinationPorts</code> settings. </p>
1392
- */
1393
- export interface PortRange {
1394
- /**
1395
- * <p>The lower limit of the port range. This must be less than or equal to the
1396
- * <code>ToPort</code> specification. </p>
1397
- */
1398
- FromPort: number | undefined;
1399
-
1400
- /**
1401
- * <p>The upper limit of the port range. This must be greater than or equal to the
1402
- * <code>FromPort</code> specification. </p>
1403
- */
1404
- ToPort: number | undefined;
1405
- }
1406
-
1407
- export namespace PortRange {
1408
- /**
1409
- * @internal
1410
- */
1411
- export const filterSensitiveLog = (obj: PortRange): any => ({
1412
- ...obj,
1413
- });
1414
- }
1415
-
1416
- export enum TCPFlag {
1417
- ACK = "ACK",
1418
- CWR = "CWR",
1419
- ECE = "ECE",
1420
- FIN = "FIN",
1421
- PSH = "PSH",
1422
- RST = "RST",
1423
- SYN = "SYN",
1424
- URG = "URG",
1425
- }
1426
-
1427
- /**
1428
- * <p>TCP flags and masks to inspect packets for, used in stateless rules <a>MatchAttributes</a> settings.</p>
1429
- */
1430
- export interface TCPFlagField {
1431
- /**
1432
- * <p>Used in conjunction with the <code>Masks</code> setting to define the flags that must be set and flags that must not be set in order for the packet to match. This setting can only specify values that are also specified in the <code>Masks</code> setting.</p>
1433
- * <p>For the flags that are specified in the masks setting, the following must be true for the packet to match: </p>
1434
- * <ul>
1435
- * <li>
1436
- * <p>The ones that are set in this flags setting must be set in the packet. </p>
1437
- * </li>
1438
- * <li>
1439
- * <p>The ones that are not set in this flags setting must also not be set in the packet. </p>
1440
- * </li>
1441
- * </ul>
1442
- */
1443
- Flags: (TCPFlag | string)[] | undefined;
1444
-
1445
- /**
1446
- * <p>The set of flags to consider in the inspection. To inspect all flags in the valid values list, leave this with no setting.</p>
1447
- */
1448
- Masks?: (TCPFlag | string)[];
1449
- }
1450
-
1451
- export namespace TCPFlagField {
1452
- /**
1453
- * @internal
1454
- */
1455
- export const filterSensitiveLog = (obj: TCPFlagField): any => ({
1456
- ...obj,
1457
- });
1458
- }
1459
-
1460
- /**
1461
- * <p>Criteria for Network Firewall to use to inspect an individual packet in stateless rule inspection. Each match attributes set can include one or more items such as IP address, CIDR range, port number, protocol, and TCP flags. </p>
1462
- */
1463
- export interface MatchAttributes {
1464
- /**
1465
- * <p>The source IP addresses and address ranges to inspect for, in CIDR notation. If not
1466
- * specified, this matches with any source address. </p>
1467
- */
1468
- Sources?: Address[];
1469
-
1470
- /**
1471
- * <p>The destination IP addresses and address ranges to inspect for, in CIDR notation. If not
1472
- * specified, this matches with any destination address. </p>
1473
- */
1474
- Destinations?: Address[];
1475
-
1476
- /**
1477
- * <p>The source ports to inspect for. If not specified, this matches with any source port.
1478
- * This setting is only used for protocols 6 (TCP) and 17 (UDP). </p>
1479
- * <p>You can specify individual ports, for example <code>1994</code> and you can specify port
1480
- * ranges, for example <code>1990:1994</code>. </p>
1481
- */
1482
- SourcePorts?: PortRange[];
1483
-
1484
- /**
1485
- * <p>The destination ports to inspect for. If not specified, this matches with any
1486
- * destination port. This setting is only used for protocols 6 (TCP) and 17 (UDP). </p>
1487
- * <p>You can specify individual ports, for example <code>1994</code> and you can specify port
1488
- * ranges, for example <code>1990:1994</code>. </p>
1489
- */
1490
- DestinationPorts?: PortRange[];
1491
-
1492
- /**
1493
- * <p>The protocols to inspect for, specified using each protocol's assigned internet protocol
1494
- * number (IANA). If not specified, this matches with any protocol. </p>
1495
- */
1496
- Protocols?: number[];
1497
-
1498
- /**
1499
- * <p>The TCP flags and masks to inspect for. If not specified, this matches with any
1500
- * settings. This setting is only used for protocol 6 (TCP).</p>
1501
- */
1502
- TCPFlags?: TCPFlagField[];
1503
- }
1504
-
1505
- export namespace MatchAttributes {
1506
- /**
1507
- * @internal
1508
- */
1509
- export const filterSensitiveLog = (obj: MatchAttributes): any => ({
1510
- ...obj,
1511
- });
1512
- }
1513
-
1514
- /**
1515
- * <p>The inspection criteria and action for a single stateless rule. AWS Network Firewall inspects each packet for the specified matching
1516
- * criteria. When a packet matches the criteria, Network Firewall performs the rule's actions on
1517
- * the packet.</p>
1518
- */
1519
- export interface RuleDefinition {
1520
- /**
1521
- * <p>Criteria for Network Firewall to use to inspect an individual packet in stateless rule inspection. Each match attributes set can include one or more items such as IP address, CIDR range, port number, protocol, and TCP flags. </p>
1522
- */
1523
- MatchAttributes: MatchAttributes | undefined;
1524
-
1525
- /**
1526
- * <p>The actions to take on a packet that matches one of the stateless rule definition's
1527
- * match attributes. You must specify a standard action and you can add custom actions. </p>
1528
- * <note>
1529
- * <p>Network Firewall only forwards a packet for stateful rule inspection if you specify
1530
- * <code>aws:forward_to_sfe</code> for a rule that the packet matches, or if the packet
1531
- * doesn't match any stateless rule and you specify <code>aws:forward_to_sfe</code> for the
1532
- * <code>StatelessDefaultActions</code> setting for the <a>FirewallPolicy</a>.</p>
1533
- * </note>
1534
- * <p>For every rule, you must specify exactly one of the following standard actions. </p>
1535
- * <ul>
1536
- * <li>
1537
- * <p>
1538
- * <b>aws:pass</b> - Discontinues all inspection of
1539
- * the packet and permits it to go to its intended destination.</p>
1540
- * </li>
1541
- * <li>
1542
- * <p>
1543
- * <b>aws:drop</b> - Discontinues all inspection of
1544
- * the packet and blocks it from going to its intended destination.</p>
1545
- * </li>
1546
- * <li>
1547
- * <p>
1548
- * <b>aws:forward_to_sfe</b> - Discontinues
1549
- * stateless inspection of the packet and forwards it to the stateful rule engine for
1550
- * inspection. </p>
1551
- * </li>
1552
- * </ul>
1553
- * <p>Additionally, you can specify a custom action.
1554
- * To
1555
- * do this, you define a custom action by name and type, then provide the name you've assigned
1556
- * to the action in this <code>Actions</code> setting. For information about the options, see
1557
- * <a>CustomAction</a>. </p>
1558
- * <p>To provide more than one action in this setting, separate the settings with a comma. For
1559
- * example, if you have a custom <code>PublishMetrics</code> action that you've named
1560
- * <code>MyMetricsAction</code>, then you could specify the standard action
1561
- * <code>aws:pass</code> and the custom action with <code>[“aws:pass”,
1562
- * “MyMetricsAction”]</code>. </p>
1563
- */
1564
- Actions: string[] | undefined;
1565
- }
1566
-
1567
- export namespace RuleDefinition {
1568
- /**
1569
- * @internal
1570
- */
1571
- export const filterSensitiveLog = (obj: RuleDefinition): any => ({
1572
- ...obj,
1573
- });
1574
- }
1575
-
1576
- /**
1577
- * <p>A single stateless rule. This is used in <a>StatelessRulesAndCustomActions</a>.</p>
1578
- */
1579
- export interface StatelessRule {
1580
- /**
1581
- * <p>Defines the stateless 5-tuple packet inspection criteria and the action to take on a
1582
- * packet that matches the criteria. </p>
1583
- */
1584
- RuleDefinition: RuleDefinition | undefined;
1585
-
1586
- /**
1587
- * <p>Indicates the order in which to run this rule relative to all of the
1588
- * rules that are defined for a stateless rule group. Network Firewall evaluates the rules in a
1589
- * rule group starting with the lowest priority setting. You must ensure that the priority
1590
- * settings are unique for the rule group. </p>
1591
- * <p>Each stateless rule group uses exactly one <code>StatelessRulesAndCustomActions</code>
1592
- * object, and each <code>StatelessRulesAndCustomActions</code> contains exactly one
1593
- * <code>StatelessRules</code> object. To ensure unique priority settings for your rule
1594
- * groups, set unique priorities for the stateless rules that you define inside any single
1595
- * <code>StatelessRules</code> object.</p>
1596
- * <p>You can change the priority settings of your rules at any time. To make it easier to
1597
- * insert rules later, number them so there's a wide range in between, for example use 100,
1598
- * 200, and so on. </p>
1599
- */
1600
- Priority: number | undefined;
1601
- }
1602
-
1603
- export namespace StatelessRule {
1604
- /**
1605
- * @internal
1606
- */
1607
- export const filterSensitiveLog = (obj: StatelessRule): any => ({
1608
- ...obj,
1609
- });
1610
- }
1611
-
1612
- /**
1613
- * <p>Stateless inspection criteria. Each stateless rule group uses exactly one of these data
1614
- * types to define its stateless rules. </p>
1615
- */
1616
- export interface StatelessRulesAndCustomActions {
1617
- /**
1618
- * <p>Defines the set of stateless rules for use in a stateless rule group. </p>
1619
- */
1620
- StatelessRules: StatelessRule[] | undefined;
1621
-
1622
- /**
1623
- * <p>Defines an array of individual custom action definitions that are available for use by
1624
- * the stateless rules in this <code>StatelessRulesAndCustomActions</code> specification. You
1625
- * name each custom action that you define, and then you can use it by name in your <a>StatelessRule</a>
1626
- * <a>RuleDefinition</a>
1627
- * <code>Actions</code> specification.</p>
1628
- */
1629
- CustomActions?: CustomAction[];
1630
- }
1631
-
1632
- export namespace StatelessRulesAndCustomActions {
1633
- /**
1634
- * @internal
1635
- */
1636
- export const filterSensitiveLog = (obj: StatelessRulesAndCustomActions): any => ({
1637
- ...obj,
1638
- });
1639
- }
1640
-
1641
- /**
1642
- * <p>The stateless or stateful rules definitions for use in a single rule group. Each rule
1643
- * group requires a single <code>RulesSource</code>. You can use an instance of this for
1644
- * either stateless rules or stateful rules. </p>
1645
- */
1646
- export interface RulesSource {
1647
- /**
1648
- * <p>Stateful inspection criteria, provided in Suricata compatible intrusion prevention
1649
- * system (IPS) rules. Suricata is an open-source network IPS that includes a standard
1650
- * rule-based language for network traffic inspection.</p>
1651
- * <p>These rules contain the inspection criteria and the action to take for traffic that
1652
- * matches the criteria, so this type of rule group doesn't have a separate action
1653
- * setting.</p>
1654
- */
1655
- RulesString?: string;
1656
-
1657
- /**
1658
- * <p>Stateful inspection criteria for a domain list rule group. </p>
1659
- */
1660
- RulesSourceList?: RulesSourceList;
1661
-
1662
- /**
1663
- * <p>An array of individual stateful rules inspection criteria to be used together in a stateful rule group.
1664
- * Use this option to specify simple Suricata rules with protocol, source and destination, ports, direction, and rule options.
1665
- * For information about the Suricata <code>Rules</code> format, see
1666
- * <a href="https://suricata.readthedocs.io/en/suricata-5.0.0/rules/intro.html#">Rules Format</a>. </p>
1667
- */
1668
- StatefulRules?: StatefulRule[];
1669
-
1670
- /**
1671
- * <p>Stateless inspection criteria to be used in a stateless rule group. </p>
1672
- */
1673
- StatelessRulesAndCustomActions?: StatelessRulesAndCustomActions;
1674
- }
1675
-
1676
- export namespace RulesSource {
1677
- /**
1678
- * @internal
1679
- */
1680
- export const filterSensitiveLog = (obj: RulesSource): any => ({
1681
- ...obj,
1682
- });
1683
- }
1684
-
1685
- /**
1686
- * <p>A list of IP addresses and address ranges, in CIDR notation. This is part of a <a>RuleVariables</a>. </p>
1687
- */
1688
- export interface IPSet {
1689
- /**
1690
- * <p>The list of IP addresses and address ranges, in CIDR notation.
1691
- *
1692
- * </p>
1693
- */
1694
- Definition: string[] | undefined;
1695
- }
1696
-
1697
- export namespace IPSet {
1698
- /**
1699
- * @internal
1700
- */
1701
- export const filterSensitiveLog = (obj: IPSet): any => ({
1702
- ...obj,
1703
- });
1704
- }
1705
-
1706
- /**
1707
- * <p>A set of port ranges for use in the rules in a rule group. </p>
1708
- */
1709
- export interface PortSet {
1710
- /**
1711
- * <p>The set of port ranges.
1712
- * </p>
1713
- */
1714
- Definition?: string[];
1715
- }
1716
-
1717
- export namespace PortSet {
1718
- /**
1719
- * @internal
1720
- */
1721
- export const filterSensitiveLog = (obj: PortSet): any => ({
1722
- ...obj,
1723
- });
1724
- }
1725
-
1726
- /**
1727
- * <p>Settings that are available for use in the rules in the <a>RuleGroup</a>
1728
- * where this is defined. </p>
1729
- */
1730
- export interface RuleVariables {
1731
- /**
1732
- * <p>A list of IP addresses and address ranges, in CIDR notation. </p>
1733
- */
1734
- IPSets?: { [key: string]: IPSet };
1735
-
1736
- /**
1737
- * <p>A list of port ranges. </p>
1738
- */
1739
- PortSets?: { [key: string]: PortSet };
1740
- }
1741
-
1742
- export namespace RuleVariables {
1743
- /**
1744
- * @internal
1745
- */
1746
- export const filterSensitiveLog = (obj: RuleVariables): any => ({
1747
- ...obj,
1748
- });
1749
- }
1750
-
1751
- /**
1752
- * <p>Additional options governing how Network Firewall handles the rule group. You can only use these for stateful rule groups.</p>
1753
- */
1754
- export interface StatefulRuleOptions {
1755
- /**
1756
- * <p>Indicates how to manage the order of the rule evaluation for the rule group. By default, Network Firewall
1757
- * leaves the rule evaluation order up to the Suricata rule processing engine. If you set
1758
- * this to <code>STRICT_ORDER</code>, your rules are evaluated in the exact order that they're listed
1759
- * in your Suricata rules string. </p>
1760
- */
1761
- RuleOrder?: RuleOrder | string;
1762
- }
1763
-
1764
- export namespace StatefulRuleOptions {
1765
- /**
1766
- * @internal
1767
- */
1768
- export const filterSensitiveLog = (obj: StatefulRuleOptions): any => ({
1769
- ...obj,
1770
- });
1771
- }
1772
-
1773
- /**
1774
- * <p>The object that defines the rules in a rule group. This, along with <a>RuleGroupResponse</a>, define the rule group. You can retrieve all objects for a rule group by calling <a>DescribeRuleGroup</a>. </p>
1775
- * <p>AWS Network Firewall uses a rule group to inspect and control network traffic.
1776
- * You define stateless rule groups to inspect individual packets and you define stateful rule groups to inspect packets in the context of their
1777
- * traffic flow. </p>
1778
- * <p>To use a rule group, you include it by reference in an Network Firewall firewall policy, then you use the policy in a firewall. You can reference a rule group from
1779
- * more than one firewall policy, and you can use a firewall policy in more than one firewall. </p>
1780
- */
1781
- export interface RuleGroup {
1782
- /**
1783
- * <p>Settings that are available for use in the rules in the rule group. You can only use
1784
- * these for stateful rule groups. </p>
1785
- */
1786
- RuleVariables?: RuleVariables;
1787
-
1788
- /**
1789
- * <p>The stateful rules or stateless rules for the rule group. </p>
1790
- */
1791
- RulesSource: RulesSource | undefined;
1792
-
1793
- /**
1794
- * <p>Additional options governing how Network Firewall handles stateful rules. The policies where you use your stateful
1795
- * rule group must have stateful rule options settings that are compatible with these settings.</p>
1796
- */
1797
- StatefulRuleOptions?: StatefulRuleOptions;
1798
- }
1799
-
1800
- export namespace RuleGroup {
1801
- /**
1802
- * @internal
1803
- */
1804
- export const filterSensitiveLog = (obj: RuleGroup): any => ({
1805
- ...obj,
1806
- });
1807
- }
1808
-
1809
- export enum RuleGroupType {
1810
- STATEFUL = "STATEFUL",
1811
- STATELESS = "STATELESS",
1812
- }
1813
-
1814
- export interface CreateRuleGroupRequest {
1815
- /**
1816
- * <p>The descriptive name of the rule group. You can't change the name of a rule group after you create it.</p>
1817
- */
1818
- RuleGroupName: string | undefined;
1819
-
1820
- /**
1821
- * <p>An object that defines the rule group rules. </p>
1822
- * <note>
1823
- * <p>You must provide either this rule group setting or a <code>Rules</code> setting, but not both. </p>
1824
- * </note>
1825
- */
1826
- RuleGroup?: RuleGroup;
1827
-
1828
- /**
1829
- * <p>A string containing stateful rule group rules specifications in Suricata flat format, with one rule
1830
- * per line. Use this to import your existing Suricata compatible rule groups. </p>
1831
- * <note>
1832
- * <p>You must provide either this rules setting or a populated <code>RuleGroup</code> setting, but not both. </p>
1833
- * </note>
1834
- * <p>You can provide your rule group specification in Suricata flat format through this setting when you create or update your rule group. The call
1835
- * response returns a <a>RuleGroup</a> object that Network Firewall has populated from your string. </p>
1836
- */
1837
- Rules?: string;
1838
-
1839
- /**
1840
- * <p>Indicates whether the rule group is stateless or stateful. If the rule group is stateless, it contains
1841
- * stateless rules. If it is stateful, it contains stateful rules. </p>
1842
- */
1843
- Type: RuleGroupType | string | undefined;
1844
-
1845
- /**
1846
- * <p>A description of the rule group. </p>
1847
- */
1848
- Description?: string;
1849
-
1850
- /**
1851
- * <p>The maximum operating resources that this rule group can use. Rule group capacity is fixed at creation.
1852
- * When you update a rule group, you are limited to this capacity. When you reference a rule group
1853
- * from a firewall policy, Network Firewall reserves this capacity for the rule group. </p>
1854
- * <p>You can retrieve the capacity that would be required for a rule group before you create the rule group by calling
1855
- * <a>CreateRuleGroup</a> with <code>DryRun</code> set to <code>TRUE</code>. </p>
1856
- * <note>
1857
- * <p>You can't change or exceed this capacity when you update the rule group, so leave
1858
- * room for your rule group to grow. </p>
1859
- * </note>
1860
- * <p>
1861
- * <b>Capacity for a stateless rule group</b>
1862
- * </p>
1863
- * <p>For a stateless rule group, the capacity required is the sum of the capacity
1864
- * requirements of the individual rules that you expect to have in the rule group. </p>
1865
- * <p>To calculate the capacity requirement of a single rule, multiply the capacity
1866
- * requirement values of each of the rule's match settings:</p>
1867
- * <ul>
1868
- * <li>
1869
- * <p>A match setting with no criteria specified has a value of 1. </p>
1870
- * </li>
1871
- * <li>
1872
- * <p>A match setting with <code>Any</code> specified has a value of 1. </p>
1873
- * </li>
1874
- * <li>
1875
- * <p>All other match settings have a value equal to the number of elements provided in
1876
- * the setting. For example, a protocol setting ["UDP"] and a source setting
1877
- * ["10.0.0.0/24"] each have a value of 1. A protocol setting ["UDP","TCP"] has a value
1878
- * of 2. A source setting ["10.0.0.0/24","10.0.0.1/24","10.0.0.2/24"] has a value of 3.
1879
- * </p>
1880
- * </li>
1881
- * </ul>
1882
- * <p>A rule with no criteria specified in any of its match settings has a capacity
1883
- * requirement of 1. A rule with protocol setting ["UDP","TCP"], source setting
1884
- * ["10.0.0.0/24","10.0.0.1/24","10.0.0.2/24"], and a single specification or no specification
1885
- * for each of the other match settings has a capacity requirement of 6. </p>
1886
- * <p>
1887
- * <b>Capacity for a stateful rule group</b>
1888
- * </p>
1889
- * <p>For
1890
- * a stateful rule group, the minimum capacity required is the number of individual rules that
1891
- * you expect to have in the rule group. </p>
1892
- */
1893
- Capacity: number | undefined;
1894
-
1895
- /**
1896
- * <p>The key:value pairs to associate with the resource.</p>
1897
- */
1898
- Tags?: Tag[];
1899
-
1900
- /**
1901
- * <p>Indicates whether you want Network Firewall to just check the validity of the request, rather than run the request. </p>
1902
- * <p>If set to <code>TRUE</code>, Network Firewall checks whether the request can run successfully,
1903
- * but doesn't actually make the requested changes. The call returns the value that the request would return if you ran it with
1904
- * dry run set to <code>FALSE</code>, but doesn't make additions or changes to your resources. This option allows you to make sure that you have
1905
- * the required permissions to run the request and that your request parameters are valid. </p>
1906
- * <p>If set to <code>FALSE</code>, Network Firewall makes the requested changes to your resources. </p>
1907
- */
1908
- DryRun?: boolean;
1909
- }
1910
-
1911
- export namespace CreateRuleGroupRequest {
1912
- /**
1913
- * @internal
1914
- */
1915
- export const filterSensitiveLog = (obj: CreateRuleGroupRequest): any => ({
1916
- ...obj,
1917
- });
1918
- }
1919
-
1920
- /**
1921
- * <p>The high-level properties of a rule group. This, along with the <a>RuleGroup</a>, define the rule group. You can retrieve all objects for a rule group by calling <a>DescribeRuleGroup</a>. </p>
1922
- */
1923
- export interface RuleGroupResponse {
1924
- /**
1925
- * <p>The Amazon Resource Name (ARN) of the rule group.</p>
1926
- * <note>
1927
- * <p>If this response is for a create request that had <code>DryRun</code> set to
1928
- * <code>TRUE</code>, then this ARN is a placeholder that isn't attached to a valid
1929
- * resource.</p>
1930
- * </note>
1931
- */
1932
- RuleGroupArn: string | undefined;
1933
-
1934
- /**
1935
- * <p>The descriptive name of the rule group. You can't change the name of a rule group after you create it.</p>
1936
- */
1937
- RuleGroupName: string | undefined;
1938
-
1939
- /**
1940
- * <p>The unique identifier for the rule group. </p>
1941
- */
1942
- RuleGroupId: string | undefined;
1943
-
1944
- /**
1945
- * <p>A description of the rule group. </p>
1946
- */
1947
- Description?: string;
1948
-
1949
- /**
1950
- * <p>Indicates whether the rule group is stateless or stateful. If the rule group is stateless, it contains
1951
- * stateless rules. If it is stateful, it contains stateful rules. </p>
1952
- */
1953
- Type?: RuleGroupType | string;
1954
-
1955
- /**
1956
- * <p>The maximum operating resources that this rule group can use. Rule group capacity is fixed at creation.
1957
- * When you update a rule group, you are limited to this capacity. When you reference a rule group
1958
- * from a firewall policy, Network Firewall reserves this capacity for the rule group. </p>
1959
- * <p>You can retrieve the capacity that would be required for a rule group before you create the rule group by calling
1960
- * <a>CreateRuleGroup</a> with <code>DryRun</code> set to <code>TRUE</code>. </p>
1961
- */
1962
- Capacity?: number;
1963
-
1964
- /**
1965
- * <p>Detailed information about the current status of a rule group. </p>
1966
- */
1967
- RuleGroupStatus?: ResourceStatus | string;
1968
-
1969
- /**
1970
- * <p>The key:value pairs to associate with the resource.</p>
1971
- */
1972
- Tags?: Tag[];
1973
-
1974
- /**
1975
- * <p>The number of capacity units currently consumed by the rule group rules. </p>
1976
- */
1977
- ConsumedCapacity?: number;
1978
-
1979
- /**
1980
- * <p>The number of firewall policies that use this rule group.</p>
1981
- */
1982
- NumberOfAssociations?: number;
1983
- }
1984
-
1985
- export namespace RuleGroupResponse {
1986
- /**
1987
- * @internal
1988
- */
1989
- export const filterSensitiveLog = (obj: RuleGroupResponse): any => ({
1990
- ...obj,
1991
- });
1992
- }
1993
-
1994
- export interface CreateRuleGroupResponse {
1995
- /**
1996
- * <p>A token used for optimistic locking. Network Firewall returns a token to your requests that access the rule group. The token marks the state of the rule group resource at the time of the request. </p>
1997
- * <p>To make changes to the rule group, you provide the token in your request. Network Firewall uses the token to ensure that the rule group hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the rule group again to get a current copy of it with a current token. Reapply your changes as needed, then try the operation again using the new token. </p>
1998
- */
1999
- UpdateToken: string | undefined;
2000
-
2001
- /**
2002
- * <p>The high-level properties of a rule group. This, along with the <a>RuleGroup</a>, define the rule group. You can retrieve all objects for a rule group by calling <a>DescribeRuleGroup</a>. </p>
2003
- */
2004
- RuleGroupResponse: RuleGroupResponse | undefined;
2005
- }
2006
-
2007
- export namespace CreateRuleGroupResponse {
2008
- /**
2009
- * @internal
2010
- */
2011
- export const filterSensitiveLog = (obj: CreateRuleGroupResponse): any => ({
2012
- ...obj,
2013
- });
2014
- }
2015
-
2016
- export interface DeleteFirewallRequest {
2017
- /**
2018
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
2019
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2020
- */
2021
- FirewallName?: string;
2022
-
2023
- /**
2024
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
2025
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2026
- */
2027
- FirewallArn?: string;
2028
- }
2029
-
2030
- export namespace DeleteFirewallRequest {
2031
- /**
2032
- * @internal
2033
- */
2034
- export const filterSensitiveLog = (obj: DeleteFirewallRequest): any => ({
2035
- ...obj,
2036
- });
2037
- }
2038
-
2039
- export interface DeleteFirewallResponse {
2040
- /**
2041
- * <p>The firewall defines the configuration settings for an AWS Network Firewall firewall. These settings include the firewall policy, the subnets in your VPC to use for the firewall endpoints, and any tags that are attached to the firewall AWS resource. </p>
2042
- * <p>The status of the firewall, for example whether it's ready to filter network traffic,
2043
- * is provided in the corresponding <a>FirewallStatus</a>. You can retrieve both
2044
- * objects by calling <a>DescribeFirewall</a>.</p>
2045
- */
2046
- Firewall?: Firewall;
2047
-
2048
- /**
2049
- * <p>Detailed information about the current status of a <a>Firewall</a>. You can retrieve this for a firewall by calling <a>DescribeFirewall</a> and providing the firewall name and ARN.</p>
2050
- */
2051
- FirewallStatus?: FirewallStatus;
2052
- }
2053
-
2054
- export namespace DeleteFirewallResponse {
2055
- /**
2056
- * @internal
2057
- */
2058
- export const filterSensitiveLog = (obj: DeleteFirewallResponse): any => ({
2059
- ...obj,
2060
- });
2061
- }
2062
-
2063
- /**
2064
- * <p>The operation you requested isn't supported by Network Firewall. </p>
2065
- */
2066
- export interface UnsupportedOperationException extends __SmithyException, $MetadataBearer {
2067
- name: "UnsupportedOperationException";
2068
- $fault: "client";
2069
- Message?: string;
2070
- }
2071
-
2072
- export namespace UnsupportedOperationException {
2073
- /**
2074
- * @internal
2075
- */
2076
- export const filterSensitiveLog = (obj: UnsupportedOperationException): any => ({
2077
- ...obj,
2078
- });
2079
- }
2080
-
2081
- export interface DeleteFirewallPolicyRequest {
2082
- /**
2083
- * <p>The descriptive name of the firewall policy. You can't change the name of a firewall policy after you create it.</p>
2084
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2085
- */
2086
- FirewallPolicyName?: string;
2087
-
2088
- /**
2089
- * <p>The Amazon Resource Name (ARN) of the firewall policy.</p>
2090
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2091
- */
2092
- FirewallPolicyArn?: string;
2093
- }
2094
-
2095
- export namespace DeleteFirewallPolicyRequest {
2096
- /**
2097
- * @internal
2098
- */
2099
- export const filterSensitiveLog = (obj: DeleteFirewallPolicyRequest): any => ({
2100
- ...obj,
2101
- });
2102
- }
2103
-
2104
- export interface DeleteFirewallPolicyResponse {
2105
- /**
2106
- * <p>The object containing the definition of the <a>FirewallPolicyResponse</a>
2107
- * that you asked to delete. </p>
2108
- */
2109
- FirewallPolicyResponse: FirewallPolicyResponse | undefined;
2110
- }
2111
-
2112
- export namespace DeleteFirewallPolicyResponse {
2113
- /**
2114
- * @internal
2115
- */
2116
- export const filterSensitiveLog = (obj: DeleteFirewallPolicyResponse): any => ({
2117
- ...obj,
2118
- });
2119
- }
2120
-
2121
- export interface DeleteResourcePolicyRequest {
2122
- /**
2123
- * <p>The Amazon Resource Name (ARN) of the rule group or firewall policy whose resource policy you want to delete. </p>
2124
- */
2125
- ResourceArn: string | undefined;
2126
- }
2127
-
2128
- export namespace DeleteResourcePolicyRequest {
2129
- /**
2130
- * @internal
2131
- */
2132
- export const filterSensitiveLog = (obj: DeleteResourcePolicyRequest): any => ({
2133
- ...obj,
2134
- });
2135
- }
2136
-
2137
- export interface DeleteResourcePolicyResponse {}
2138
-
2139
- export namespace DeleteResourcePolicyResponse {
2140
- /**
2141
- * @internal
2142
- */
2143
- export const filterSensitiveLog = (obj: DeleteResourcePolicyResponse): any => ({
2144
- ...obj,
2145
- });
2146
- }
2147
-
2148
- /**
2149
- * <p>The policy statement failed validation.</p>
2150
- */
2151
- export interface InvalidResourcePolicyException extends __SmithyException, $MetadataBearer {
2152
- name: "InvalidResourcePolicyException";
2153
- $fault: "client";
2154
- Message?: string;
2155
- }
2156
-
2157
- export namespace InvalidResourcePolicyException {
2158
- /**
2159
- * @internal
2160
- */
2161
- export const filterSensitiveLog = (obj: InvalidResourcePolicyException): any => ({
2162
- ...obj,
2163
- });
2164
- }
2165
-
2166
- export interface DeleteRuleGroupRequest {
2167
- /**
2168
- * <p>The descriptive name of the rule group. You can't change the name of a rule group after you create it.</p>
2169
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2170
- */
2171
- RuleGroupName?: string;
2172
-
2173
- /**
2174
- * <p>The Amazon Resource Name (ARN) of the rule group.</p>
2175
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2176
- */
2177
- RuleGroupArn?: string;
2178
-
2179
- /**
2180
- * <p>Indicates whether the rule group is stateless or stateful. If the rule group is stateless, it contains
2181
- * stateless rules. If it is stateful, it contains stateful rules. </p>
2182
- * <note>
2183
- * <p>This setting is required for requests that do not include the <code>RuleGroupARN</code>.</p>
2184
- * </note>
2185
- */
2186
- Type?: RuleGroupType | string;
2187
- }
2188
-
2189
- export namespace DeleteRuleGroupRequest {
2190
- /**
2191
- * @internal
2192
- */
2193
- export const filterSensitiveLog = (obj: DeleteRuleGroupRequest): any => ({
2194
- ...obj,
2195
- });
2196
- }
2197
-
2198
- export interface DeleteRuleGroupResponse {
2199
- /**
2200
- * <p>The high-level properties of a rule group. This, along with the <a>RuleGroup</a>, define the rule group. You can retrieve all objects for a rule group by calling <a>DescribeRuleGroup</a>. </p>
2201
- */
2202
- RuleGroupResponse: RuleGroupResponse | undefined;
2203
- }
2204
-
2205
- export namespace DeleteRuleGroupResponse {
2206
- /**
2207
- * @internal
2208
- */
2209
- export const filterSensitiveLog = (obj: DeleteRuleGroupResponse): any => ({
2210
- ...obj,
2211
- });
2212
- }
2213
-
2214
- export interface DescribeFirewallRequest {
2215
- /**
2216
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
2217
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2218
- */
2219
- FirewallName?: string;
2220
-
2221
- /**
2222
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
2223
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2224
- */
2225
- FirewallArn?: string;
2226
- }
2227
-
2228
- export namespace DescribeFirewallRequest {
2229
- /**
2230
- * @internal
2231
- */
2232
- export const filterSensitiveLog = (obj: DescribeFirewallRequest): any => ({
2233
- ...obj,
2234
- });
2235
- }
2236
-
2237
- export interface DescribeFirewallResponse {
2238
- /**
2239
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
2240
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
2241
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
2242
- */
2243
- UpdateToken?: string;
2244
-
2245
- /**
2246
- * <p>The configuration settings for the firewall. These settings include the firewall policy and the subnets in your VPC to use for the firewall endpoints. </p>
2247
- */
2248
- Firewall?: Firewall;
2249
-
2250
- /**
2251
- * <p>Detailed information about the current status of a <a>Firewall</a>. You can retrieve this for a firewall by calling <a>DescribeFirewall</a> and providing the firewall name and ARN.</p>
2252
- */
2253
- FirewallStatus?: FirewallStatus;
2254
- }
2255
-
2256
- export namespace DescribeFirewallResponse {
2257
- /**
2258
- * @internal
2259
- */
2260
- export const filterSensitiveLog = (obj: DescribeFirewallResponse): any => ({
2261
- ...obj,
2262
- });
2263
- }
2264
-
2265
- export interface DescribeFirewallPolicyRequest {
2266
- /**
2267
- * <p>The descriptive name of the firewall policy. You can't change the name of a firewall policy after you create it.</p>
2268
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2269
- */
2270
- FirewallPolicyName?: string;
2271
-
2272
- /**
2273
- * <p>The Amazon Resource Name (ARN) of the firewall policy.</p>
2274
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2275
- */
2276
- FirewallPolicyArn?: string;
2277
- }
2278
-
2279
- export namespace DescribeFirewallPolicyRequest {
2280
- /**
2281
- * @internal
2282
- */
2283
- export const filterSensitiveLog = (obj: DescribeFirewallPolicyRequest): any => ({
2284
- ...obj,
2285
- });
2286
- }
2287
-
2288
- export interface DescribeFirewallPolicyResponse {
2289
- /**
2290
- * <p>A token used for optimistic locking. Network Firewall returns a token to your requests that access the firewall policy. The token marks the state of the policy resource at the time of the request. </p>
2291
- * <p>To make changes to the policy, you provide the token in your request. Network Firewall uses the token to ensure that the policy hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall policy again to get a current copy of it with current token. Reapply your changes as needed, then try the operation again using the new token. </p>
2292
- */
2293
- UpdateToken: string | undefined;
2294
-
2295
- /**
2296
- * <p>The high-level properties of a firewall policy. This, along with the <a>FirewallPolicy</a>, define the policy. You can retrieve all objects for a firewall policy by calling <a>DescribeFirewallPolicy</a>. </p>
2297
- */
2298
- FirewallPolicyResponse: FirewallPolicyResponse | undefined;
2299
-
2300
- /**
2301
- * <p>The policy for the specified firewall policy. </p>
2302
- */
2303
- FirewallPolicy?: FirewallPolicy;
2304
- }
2305
-
2306
- export namespace DescribeFirewallPolicyResponse {
2307
- /**
2308
- * @internal
2309
- */
2310
- export const filterSensitiveLog = (obj: DescribeFirewallPolicyResponse): any => ({
2311
- ...obj,
2312
- });
2313
- }
2314
-
2315
- export interface DescribeLoggingConfigurationRequest {
2316
- /**
2317
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
2318
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2319
- */
2320
- FirewallArn?: string;
2321
-
2322
- /**
2323
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
2324
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2325
- */
2326
- FirewallName?: string;
2327
- }
2328
-
2329
- export namespace DescribeLoggingConfigurationRequest {
2330
- /**
2331
- * @internal
2332
- */
2333
- export const filterSensitiveLog = (obj: DescribeLoggingConfigurationRequest): any => ({
2334
- ...obj,
2335
- });
2336
- }
2337
-
2338
- export enum LogDestinationType {
2339
- CLOUDWATCH_LOGS = "CloudWatchLogs",
2340
- KINESIS_DATA_FIREHOSE = "KinesisDataFirehose",
2341
- S3 = "S3",
2342
- }
2343
-
2344
- export enum LogType {
2345
- ALERT = "ALERT",
2346
- FLOW = "FLOW",
2347
- }
2348
-
2349
- /**
2350
- * <p>Defines where AWS Network Firewall sends logs for the firewall for one log type. This is used
2351
- * in <a>LoggingConfiguration</a>. You can send each type of log to an Amazon S3 bucket, a CloudWatch log group, or a Kinesis Data Firehose delivery stream.</p>
2352
- * <p>Network Firewall generates logs for stateful rule groups. You can save alert and flow log
2353
- * types. The stateful rules engine records flow logs for all network traffic that it receives.
2354
- * It records alert logs for traffic that matches stateful rules that have the rule
2355
- * action set to <code>DROP</code> or <code>ALERT</code>. </p>
2356
- */
2357
- export interface LogDestinationConfig {
2358
- /**
2359
- * <p>The type of log to send. Alert logs report traffic that matches a <a>StatefulRule</a> with an action setting that sends an alert log message. Flow logs are
2360
- * standard network traffic flow logs. </p>
2361
- */
2362
- LogType: LogType | string | undefined;
2363
-
2364
- /**
2365
- * <p>The type of storage destination to send these logs to. You can send logs to an Amazon S3 bucket,
2366
- * a CloudWatch log group, or a Kinesis Data Firehose delivery stream.</p>
2367
- */
2368
- LogDestinationType: LogDestinationType | string | undefined;
2369
-
2370
- /**
2371
- * <p>The named location for the logs, provided in a key:value mapping that is specific to the
2372
- * chosen destination type. </p>
2373
- * <ul>
2374
- * <li>
2375
- * <p>For an Amazon S3 bucket, provide the name of the bucket, with key <code>bucketName</code>,
2376
- * and optionally provide a prefix, with key <code>prefix</code>. The following example
2377
- * specifies an Amazon S3 bucket named
2378
- * <code>DOC-EXAMPLE-BUCKET</code> and the prefix <code>alerts</code>: </p>
2379
- * <p>
2380
- * <code>"LogDestination": { "bucketName": "DOC-EXAMPLE-BUCKET", "prefix": "alerts"
2381
- * }</code>
2382
- * </p>
2383
- * </li>
2384
- * <li>
2385
- * <p>For a CloudWatch log group, provide the name of the CloudWatch log group, with key
2386
- * <code>logGroup</code>. The following example specifies a log group named
2387
- * <code>alert-log-group</code>: </p>
2388
- * <p>
2389
- * <code>"LogDestination": { "logGroup": "alert-log-group" }</code>
2390
- * </p>
2391
- * </li>
2392
- * <li>
2393
- * <p>For a Kinesis Data Firehose delivery stream, provide the name of the delivery stream, with key
2394
- * <code>deliveryStream</code>. The following example specifies a delivery stream
2395
- * named <code>alert-delivery-stream</code>: </p>
2396
- * <p>
2397
- * <code>"LogDestination": { "deliveryStream": "alert-delivery-stream"
2398
- * }</code>
2399
- * </p>
2400
- * </li>
2401
- * </ul>
2402
- */
2403
- LogDestination: { [key: string]: string } | undefined;
2404
- }
2405
-
2406
- export namespace LogDestinationConfig {
2407
- /**
2408
- * @internal
2409
- */
2410
- export const filterSensitiveLog = (obj: LogDestinationConfig): any => ({
2411
- ...obj,
2412
- });
2413
- }
2414
-
2415
- /**
2416
- * <p>Defines how AWS Network Firewall performs logging for a <a>Firewall</a>. </p>
2417
- */
2418
- export interface LoggingConfiguration {
2419
- /**
2420
- * <p>Defines the logging destinations for the logs for a firewall. Network Firewall generates
2421
- * logs for stateful rule groups. </p>
2422
- */
2423
- LogDestinationConfigs: LogDestinationConfig[] | undefined;
2424
- }
2425
-
2426
- export namespace LoggingConfiguration {
2427
- /**
2428
- * @internal
2429
- */
2430
- export const filterSensitiveLog = (obj: LoggingConfiguration): any => ({
2431
- ...obj,
2432
- });
2433
- }
2434
-
2435
- export interface DescribeLoggingConfigurationResponse {
2436
- /**
2437
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
2438
- */
2439
- FirewallArn?: string;
2440
-
2441
- /**
2442
- * <p>Defines how AWS Network Firewall performs logging for a <a>Firewall</a>. </p>
2443
- */
2444
- LoggingConfiguration?: LoggingConfiguration;
2445
- }
2446
-
2447
- export namespace DescribeLoggingConfigurationResponse {
2448
- /**
2449
- * @internal
2450
- */
2451
- export const filterSensitiveLog = (obj: DescribeLoggingConfigurationResponse): any => ({
2452
- ...obj,
2453
- });
2454
- }
2455
-
2456
- export interface DescribeResourcePolicyRequest {
2457
- /**
2458
- * <p>The Amazon Resource Name (ARN) of the rule group or firewall policy whose resource policy you want to retrieve. </p>
2459
- */
2460
- ResourceArn: string | undefined;
2461
- }
2462
-
2463
- export namespace DescribeResourcePolicyRequest {
2464
- /**
2465
- * @internal
2466
- */
2467
- export const filterSensitiveLog = (obj: DescribeResourcePolicyRequest): any => ({
2468
- ...obj,
2469
- });
2470
- }
2471
-
2472
- export interface DescribeResourcePolicyResponse {
2473
- /**
2474
- * <p>The AWS Identity and Access Management policy for the resource. </p>
2475
- */
2476
- Policy?: string;
2477
- }
2478
-
2479
- export namespace DescribeResourcePolicyResponse {
2480
- /**
2481
- * @internal
2482
- */
2483
- export const filterSensitiveLog = (obj: DescribeResourcePolicyResponse): any => ({
2484
- ...obj,
2485
- });
2486
- }
2487
-
2488
- export interface DescribeRuleGroupRequest {
2489
- /**
2490
- * <p>The descriptive name of the rule group. You can't change the name of a rule group after you create it.</p>
2491
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2492
- */
2493
- RuleGroupName?: string;
2494
-
2495
- /**
2496
- * <p>The Amazon Resource Name (ARN) of the rule group.</p>
2497
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2498
- */
2499
- RuleGroupArn?: string;
2500
-
2501
- /**
2502
- * <p>Indicates whether the rule group is stateless or stateful. If the rule group is stateless, it contains
2503
- * stateless rules. If it is stateful, it contains stateful rules. </p>
2504
- * <note>
2505
- * <p>This setting is required for requests that do not include the <code>RuleGroupARN</code>.</p>
2506
- * </note>
2507
- */
2508
- Type?: RuleGroupType | string;
2509
- }
2510
-
2511
- export namespace DescribeRuleGroupRequest {
2512
- /**
2513
- * @internal
2514
- */
2515
- export const filterSensitiveLog = (obj: DescribeRuleGroupRequest): any => ({
2516
- ...obj,
2517
- });
2518
- }
2519
-
2520
- export interface DescribeRuleGroupResponse {
2521
- /**
2522
- * <p>A token used for optimistic locking. Network Firewall returns a token to your requests that access the rule group. The token marks the state of the rule group resource at the time of the request. </p>
2523
- * <p>To make changes to the rule group, you provide the token in your request. Network Firewall uses the token to ensure that the rule group hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the rule group again to get a current copy of it with a current token. Reapply your changes as needed, then try the operation again using the new token. </p>
2524
- */
2525
- UpdateToken: string | undefined;
2526
-
2527
- /**
2528
- * <p>The object that defines the rules in a rule group. This, along with <a>RuleGroupResponse</a>, define the rule group. You can retrieve all objects for a rule group by calling <a>DescribeRuleGroup</a>. </p>
2529
- * <p>AWS Network Firewall uses a rule group to inspect and control network traffic.
2530
- * You define stateless rule groups to inspect individual packets and you define stateful rule groups to inspect packets in the context of their
2531
- * traffic flow. </p>
2532
- * <p>To use a rule group, you include it by reference in an Network Firewall firewall policy, then you use the policy in a firewall. You can reference a rule group from
2533
- * more than one firewall policy, and you can use a firewall policy in more than one firewall. </p>
2534
- */
2535
- RuleGroup?: RuleGroup;
2536
-
2537
- /**
2538
- * <p>The high-level properties of a rule group. This, along with the <a>RuleGroup</a>, define the rule group. You can retrieve all objects for a rule group by calling <a>DescribeRuleGroup</a>. </p>
2539
- */
2540
- RuleGroupResponse: RuleGroupResponse | undefined;
2541
- }
2542
-
2543
- export namespace DescribeRuleGroupResponse {
2544
- /**
2545
- * @internal
2546
- */
2547
- export const filterSensitiveLog = (obj: DescribeRuleGroupResponse): any => ({
2548
- ...obj,
2549
- });
2550
- }
2551
-
2552
- export interface DisassociateSubnetsRequest {
2553
- /**
2554
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
2555
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
2556
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
2557
- */
2558
- UpdateToken?: string;
2559
-
2560
- /**
2561
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
2562
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2563
- */
2564
- FirewallArn?: string;
2565
-
2566
- /**
2567
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
2568
- * <p>You must specify the ARN or the name, and you can specify both. </p>
2569
- */
2570
- FirewallName?: string;
2571
-
2572
- /**
2573
- * <p>The unique identifiers for the subnets that you want to disassociate. </p>
2574
- */
2575
- SubnetIds: string[] | undefined;
2576
- }
2577
-
2578
- export namespace DisassociateSubnetsRequest {
2579
- /**
2580
- * @internal
2581
- */
2582
- export const filterSensitiveLog = (obj: DisassociateSubnetsRequest): any => ({
2583
- ...obj,
2584
- });
2585
- }
2586
-
2587
- export interface DisassociateSubnetsResponse {
2588
- /**
2589
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
2590
- */
2591
- FirewallArn?: string;
2592
-
2593
- /**
2594
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
2595
- */
2596
- FirewallName?: string;
2597
-
2598
- /**
2599
- * <p>The IDs of the subnets that are associated with the firewall. </p>
2600
- */
2601
- SubnetMappings?: SubnetMapping[];
2602
-
2603
- /**
2604
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
2605
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
2606
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
2607
- */
2608
- UpdateToken?: string;
2609
- }
2610
-
2611
- export namespace DisassociateSubnetsResponse {
2612
- /**
2613
- * @internal
2614
- */
2615
- export const filterSensitiveLog = (obj: DisassociateSubnetsResponse): any => ({
2616
- ...obj,
2617
- });
2618
- }
2619
-
2620
- /**
2621
- * <p>High-level information about a firewall, returned by operations like create and
2622
- * describe. You can use the information provided in the metadata to retrieve and manage a
2623
- * firewall.</p>
2624
- */
2625
- export interface FirewallMetadata {
2626
- /**
2627
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
2628
- */
2629
- FirewallName?: string;
2630
-
2631
- /**
2632
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
2633
- */
2634
- FirewallArn?: string;
2635
- }
2636
-
2637
- export namespace FirewallMetadata {
2638
- /**
2639
- * @internal
2640
- */
2641
- export const filterSensitiveLog = (obj: FirewallMetadata): any => ({
2642
- ...obj,
2643
- });
2644
- }
2645
-
2646
- /**
2647
- * <p>High-level information about a firewall policy, returned by operations like create and
2648
- * describe. You can use the information provided in the metadata to retrieve and manage a
2649
- * firewall policy. You can retrieve all objects for a firewall policy by calling <a>DescribeFirewallPolicy</a>. </p>
2650
- */
2651
- export interface FirewallPolicyMetadata {
2652
- /**
2653
- * <p>The descriptive name of the firewall policy. You can't change the name of a firewall policy after you create it.</p>
2654
- */
2655
- Name?: string;
2656
-
2657
- /**
2658
- * <p>The Amazon Resource Name (ARN) of the firewall policy.</p>
2659
- */
2660
- Arn?: string;
2661
- }
2662
-
2663
- export namespace FirewallPolicyMetadata {
2664
- /**
2665
- * @internal
2666
- */
2667
- export const filterSensitiveLog = (obj: FirewallPolicyMetadata): any => ({
2668
- ...obj,
2669
- });
2670
- }
2671
-
2672
- export interface ListFirewallPoliciesRequest {
2673
- /**
2674
- * <p>When you request a list of objects with a <code>MaxResults</code> setting, if the number of objects that are still available
2675
- * for retrieval exceeds the maximum you requested, Network Firewall returns a <code>NextToken</code>
2676
- * value in the response. To retrieve the next batch of objects, use the token returned from the prior request in your next request.</p>
2677
- */
2678
- NextToken?: string;
2679
-
2680
- /**
2681
- * <p>The maximum number of objects that you want Network Firewall to return for this request. If more
2682
- * objects are available, in the response, Network Firewall provides a
2683
- * <code>NextToken</code> value that you can use in a subsequent call to get the next batch of objects.</p>
2684
- */
2685
- MaxResults?: number;
2686
- }
2687
-
2688
- export namespace ListFirewallPoliciesRequest {
2689
- /**
2690
- * @internal
2691
- */
2692
- export const filterSensitiveLog = (obj: ListFirewallPoliciesRequest): any => ({
2693
- ...obj,
2694
- });
2695
- }
2696
-
2697
- export interface ListFirewallPoliciesResponse {
2698
- /**
2699
- * <p>When you request a list of objects with a <code>MaxResults</code> setting, if the number of objects that are still available
2700
- * for retrieval exceeds the maximum you requested, Network Firewall returns a <code>NextToken</code>
2701
- * value in the response. To retrieve the next batch of objects, use the token returned from the prior request in your next request.</p>
2702
- */
2703
- NextToken?: string;
2704
-
2705
- /**
2706
- * <p>The metadata for the firewall policies. Depending on your setting for max results and
2707
- * the number of firewall policies that you have, this might not be the full list. </p>
2708
- */
2709
- FirewallPolicies?: FirewallPolicyMetadata[];
2710
- }
2711
-
2712
- export namespace ListFirewallPoliciesResponse {
2713
- /**
2714
- * @internal
2715
- */
2716
- export const filterSensitiveLog = (obj: ListFirewallPoliciesResponse): any => ({
2717
- ...obj,
2718
- });
2719
- }
2720
-
2721
- export interface ListFirewallsRequest {
2722
- /**
2723
- * <p>When you request a list of objects with a <code>MaxResults</code> setting, if the number of objects that are still available
2724
- * for retrieval exceeds the maximum you requested, Network Firewall returns a <code>NextToken</code>
2725
- * value in the response. To retrieve the next batch of objects, use the token returned from the prior request in your next request.</p>
2726
- */
2727
- NextToken?: string;
2728
-
2729
- /**
2730
- * <p>The unique identifiers of the VPCs that you want Network Firewall to retrieve the firewalls
2731
- * for. Leave this blank to retrieve all firewalls that you have defined.</p>
2732
- */
2733
- VpcIds?: string[];
2734
-
2735
- /**
2736
- * <p>The maximum number of objects that you want Network Firewall to return for this request. If more
2737
- * objects are available, in the response, Network Firewall provides a
2738
- * <code>NextToken</code> value that you can use in a subsequent call to get the next batch of objects.</p>
2739
- */
2740
- MaxResults?: number;
2741
- }
2742
-
2743
- export namespace ListFirewallsRequest {
2744
- /**
2745
- * @internal
2746
- */
2747
- export const filterSensitiveLog = (obj: ListFirewallsRequest): any => ({
2748
- ...obj,
2749
- });
2750
- }
2751
-
2752
- export interface ListFirewallsResponse {
2753
- /**
2754
- * <p>When you request a list of objects with a <code>MaxResults</code> setting, if the number of objects that are still available
2755
- * for retrieval exceeds the maximum you requested, Network Firewall returns a <code>NextToken</code>
2756
- * value in the response. To retrieve the next batch of objects, use the token returned from the prior request in your next request.</p>
2757
- */
2758
- NextToken?: string;
2759
-
2760
- /**
2761
- * <p>The firewall metadata objects for the VPCs that you specified. Depending on your setting
2762
- * for max results and the number of firewalls you have, a single call might not be the full
2763
- * list. </p>
2764
- */
2765
- Firewalls?: FirewallMetadata[];
2766
- }
2767
-
2768
- export namespace ListFirewallsResponse {
2769
- /**
2770
- * @internal
2771
- */
2772
- export const filterSensitiveLog = (obj: ListFirewallsResponse): any => ({
2773
- ...obj,
2774
- });
2775
- }
2776
-
2777
- export interface ListRuleGroupsRequest {
2778
- /**
2779
- * <p>When you request a list of objects with a <code>MaxResults</code> setting, if the number of objects that are still available
2780
- * for retrieval exceeds the maximum you requested, Network Firewall returns a <code>NextToken</code>
2781
- * value in the response. To retrieve the next batch of objects, use the token returned from the prior request in your next request.</p>
2782
- */
2783
- NextToken?: string;
2784
-
2785
- /**
2786
- * <p>The maximum number of objects that you want Network Firewall to return for this request. If more
2787
- * objects are available, in the response, Network Firewall provides a
2788
- * <code>NextToken</code> value that you can use in a subsequent call to get the next batch of objects.</p>
2789
- */
2790
- MaxResults?: number;
2791
- }
2792
-
2793
- export namespace ListRuleGroupsRequest {
2794
- /**
2795
- * @internal
2796
- */
2797
- export const filterSensitiveLog = (obj: ListRuleGroupsRequest): any => ({
2798
- ...obj,
2799
- });
2800
- }
2801
-
2802
- /**
2803
- * <p>High-level information about a rule group, returned by <a>ListRuleGroups</a>.
2804
- * You can use the information provided in the metadata to retrieve and manage a
2805
- * rule group.</p>
2806
- */
2807
- export interface RuleGroupMetadata {
2808
- /**
2809
- * <p>The descriptive name of the rule group. You can't change the name of a rule group after you create it.</p>
2810
- */
2811
- Name?: string;
2812
-
2813
- /**
2814
- * <p>The Amazon Resource Name (ARN) of the rule group.</p>
2815
- */
2816
- Arn?: string;
2817
- }
2818
-
2819
- export namespace RuleGroupMetadata {
2820
- /**
2821
- * @internal
2822
- */
2823
- export const filterSensitiveLog = (obj: RuleGroupMetadata): any => ({
2824
- ...obj,
2825
- });
2826
- }
2827
-
2828
- export interface ListRuleGroupsResponse {
2829
- /**
2830
- * <p>When you request a list of objects with a <code>MaxResults</code> setting, if the number of objects that are still available
2831
- * for retrieval exceeds the maximum you requested, Network Firewall returns a <code>NextToken</code>
2832
- * value in the response. To retrieve the next batch of objects, use the token returned from the prior request in your next request.</p>
2833
- */
2834
- NextToken?: string;
2835
-
2836
- /**
2837
- * <p>The rule group metadata objects that you've defined. Depending on your setting for max
2838
- * results and the number of rule groups, this might not be the full list. </p>
2839
- */
2840
- RuleGroups?: RuleGroupMetadata[];
2841
- }
2842
-
2843
- export namespace ListRuleGroupsResponse {
2844
- /**
2845
- * @internal
2846
- */
2847
- export const filterSensitiveLog = (obj: ListRuleGroupsResponse): any => ({
2848
- ...obj,
2849
- });
2850
- }
2851
-
2852
- export interface ListTagsForResourceRequest {
2853
- /**
2854
- * <p>When you request a list of objects with a <code>MaxResults</code> setting, if the number of objects that are still available
2855
- * for retrieval exceeds the maximum you requested, Network Firewall returns a <code>NextToken</code>
2856
- * value in the response. To retrieve the next batch of objects, use the token returned from the prior request in your next request.</p>
2857
- */
2858
- NextToken?: string;
2859
-
2860
- /**
2861
- * <p>The maximum number of objects that you want Network Firewall to return for this request. If more
2862
- * objects are available, in the response, Network Firewall provides a
2863
- * <code>NextToken</code> value that you can use in a subsequent call to get the next batch of objects.</p>
2864
- */
2865
- MaxResults?: number;
2866
-
2867
- /**
2868
- * <p>The Amazon Resource Name (ARN) of the resource.</p>
2869
- */
2870
- ResourceArn: string | undefined;
2871
- }
2872
-
2873
- export namespace ListTagsForResourceRequest {
2874
- /**
2875
- * @internal
2876
- */
2877
- export const filterSensitiveLog = (obj: ListTagsForResourceRequest): any => ({
2878
- ...obj,
2879
- });
2880
- }
2881
-
2882
- export interface ListTagsForResourceResponse {
2883
- /**
2884
- * <p>When you request a list of objects with a <code>MaxResults</code> setting, if the number of objects that are still available
2885
- * for retrieval exceeds the maximum you requested, Network Firewall returns a <code>NextToken</code>
2886
- * value in the response. To retrieve the next batch of objects, use the token returned from the prior request in your next request.</p>
2887
- */
2888
- NextToken?: string;
2889
-
2890
- /**
2891
- * <p>The tags that are associated with the resource. </p>
2892
- */
2893
- Tags?: Tag[];
2894
- }
2895
-
2896
- export namespace ListTagsForResourceResponse {
2897
- /**
2898
- * @internal
2899
- */
2900
- export const filterSensitiveLog = (obj: ListTagsForResourceResponse): any => ({
2901
- ...obj,
2902
- });
2903
- }
2904
-
2905
- /**
2906
- * <p>Unable to send logs to a configured logging destination. </p>
2907
- */
2908
- export interface LogDestinationPermissionException extends __SmithyException, $MetadataBearer {
2909
- name: "LogDestinationPermissionException";
2910
- $fault: "client";
2911
- Message?: string;
2912
- }
2913
-
2914
- export namespace LogDestinationPermissionException {
2915
- /**
2916
- * @internal
2917
- */
2918
- export const filterSensitiveLog = (obj: LogDestinationPermissionException): any => ({
2919
- ...obj,
2920
- });
2921
- }
2922
-
2923
- export interface PutResourcePolicyRequest {
2924
- /**
2925
- * <p>The Amazon Resource Name (ARN) of the account that you want to share rule groups and firewall policies with.</p>
2926
- */
2927
- ResourceArn: string | undefined;
2928
-
2929
- /**
2930
- * <p>The AWS Identity and Access Management policy statement that lists the accounts that you want to share your rule group or firewall policy with
2931
- * and the operations that you want the accounts to be able to perform. </p>
2932
- * <p>For a rule group resource, you can specify the following operations in the Actions section of the statement:</p>
2933
- * <ul>
2934
- * <li>
2935
- * <p>network-firewall:CreateFirewallPolicy</p>
2936
- * </li>
2937
- * <li>
2938
- * <p>network-firewall:UpdateFirewallPolicy</p>
2939
- * </li>
2940
- * <li>
2941
- * <p>network-firewall:ListRuleGroups</p>
2942
- * </li>
2943
- * </ul>
2944
- * <p>For a firewall policy resource, you can specify the following operations in the Actions section of the statement:</p>
2945
- * <ul>
2946
- * <li>
2947
- * <p>network-firewall:CreateFirewall</p>
2948
- * </li>
2949
- * <li>
2950
- * <p>network-firewall:UpdateFirewall</p>
2951
- * </li>
2952
- * <li>
2953
- * <p>network-firewall:AssociateFirewallPolicy</p>
2954
- * </li>
2955
- * <li>
2956
- * <p>network-firewall:ListFirewallPolicies</p>
2957
- * </li>
2958
- * </ul>
2959
- * <p>In the Resource section of the statement, you specify the ARNs for the rule groups and firewall policies that you want to share with the account that you specified in <code>Arn</code>.</p>
2960
- */
2961
- Policy: string | undefined;
2962
- }
2963
-
2964
- export namespace PutResourcePolicyRequest {
2965
- /**
2966
- * @internal
2967
- */
2968
- export const filterSensitiveLog = (obj: PutResourcePolicyRequest): any => ({
2969
- ...obj,
2970
- });
2971
- }
2972
-
2973
- export interface PutResourcePolicyResponse {}
2974
-
2975
- export namespace PutResourcePolicyResponse {
2976
- /**
2977
- * @internal
2978
- */
2979
- export const filterSensitiveLog = (obj: PutResourcePolicyResponse): any => ({
2980
- ...obj,
2981
- });
2982
- }
2983
-
2984
- export interface TagResourceRequest {
2985
- /**
2986
- * <p>The Amazon Resource Name (ARN) of the resource.</p>
2987
- */
2988
- ResourceArn: string | undefined;
2989
-
2990
- /**
2991
- * <p></p>
2992
- */
2993
- Tags: Tag[] | undefined;
2994
- }
2995
-
2996
- export namespace TagResourceRequest {
2997
- /**
2998
- * @internal
2999
- */
3000
- export const filterSensitiveLog = (obj: TagResourceRequest): any => ({
3001
- ...obj,
3002
- });
3003
- }
3004
-
3005
- export interface TagResourceResponse {}
3006
-
3007
- export namespace TagResourceResponse {
3008
- /**
3009
- * @internal
3010
- */
3011
- export const filterSensitiveLog = (obj: TagResourceResponse): any => ({
3012
- ...obj,
3013
- });
3014
- }
3015
-
3016
- export interface UntagResourceRequest {
3017
- /**
3018
- * <p>The Amazon Resource Name (ARN) of the resource.</p>
3019
- */
3020
- ResourceArn: string | undefined;
3021
-
3022
- /**
3023
- * <p></p>
3024
- */
3025
- TagKeys: string[] | undefined;
3026
- }
3027
-
3028
- export namespace UntagResourceRequest {
3029
- /**
3030
- * @internal
3031
- */
3032
- export const filterSensitiveLog = (obj: UntagResourceRequest): any => ({
3033
- ...obj,
3034
- });
3035
- }
3036
-
3037
- export interface UntagResourceResponse {}
3038
-
3039
- export namespace UntagResourceResponse {
3040
- /**
3041
- * @internal
3042
- */
3043
- export const filterSensitiveLog = (obj: UntagResourceResponse): any => ({
3044
- ...obj,
3045
- });
3046
- }
3047
-
3048
- /**
3049
- * <p>Unable to change the resource because your account doesn't own it. </p>
3050
- */
3051
- export interface ResourceOwnerCheckException extends __SmithyException, $MetadataBearer {
3052
- name: "ResourceOwnerCheckException";
3053
- $fault: "client";
3054
- Message?: string;
3055
- }
3056
-
3057
- export namespace ResourceOwnerCheckException {
3058
- /**
3059
- * @internal
3060
- */
3061
- export const filterSensitiveLog = (obj: ResourceOwnerCheckException): any => ({
3062
- ...obj,
3063
- });
3064
- }
3065
-
3066
- export interface UpdateFirewallDeleteProtectionRequest {
3067
- /**
3068
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
3069
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
3070
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
3071
- */
3072
- UpdateToken?: string;
3073
-
3074
- /**
3075
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3076
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3077
- */
3078
- FirewallArn?: string;
3079
-
3080
- /**
3081
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3082
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3083
- */
3084
- FirewallName?: string;
3085
-
3086
- /**
3087
- * <p>A flag indicating whether it is possible to delete the firewall. A setting of <code>TRUE</code> indicates
3088
- * that the firewall is protected against deletion. Use this setting to protect against
3089
- * accidentally deleting a firewall that is in use. When you create a firewall, the operation initializes this flag to <code>TRUE</code>.</p>
3090
- */
3091
- DeleteProtection: boolean | undefined;
3092
- }
3093
-
3094
- export namespace UpdateFirewallDeleteProtectionRequest {
3095
- /**
3096
- * @internal
3097
- */
3098
- export const filterSensitiveLog = (obj: UpdateFirewallDeleteProtectionRequest): any => ({
3099
- ...obj,
3100
- });
3101
- }
3102
-
3103
- export interface UpdateFirewallDeleteProtectionResponse {
3104
- /**
3105
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3106
- */
3107
- FirewallArn?: string;
3108
-
3109
- /**
3110
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3111
- */
3112
- FirewallName?: string;
3113
-
3114
- /**
3115
- * <p></p>
3116
- */
3117
- DeleteProtection?: boolean;
3118
-
3119
- /**
3120
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
3121
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
3122
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
3123
- */
3124
- UpdateToken?: string;
3125
- }
3126
-
3127
- export namespace UpdateFirewallDeleteProtectionResponse {
3128
- /**
3129
- * @internal
3130
- */
3131
- export const filterSensitiveLog = (obj: UpdateFirewallDeleteProtectionResponse): any => ({
3132
- ...obj,
3133
- });
3134
- }
3135
-
3136
- export interface UpdateFirewallDescriptionRequest {
3137
- /**
3138
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
3139
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
3140
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
3141
- */
3142
- UpdateToken?: string;
3143
-
3144
- /**
3145
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3146
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3147
- */
3148
- FirewallArn?: string;
3149
-
3150
- /**
3151
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3152
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3153
- */
3154
- FirewallName?: string;
3155
-
3156
- /**
3157
- * <p>The new description for the firewall. If you omit this setting, Network Firewall removes
3158
- * the description for the firewall.</p>
3159
- */
3160
- Description?: string;
3161
- }
3162
-
3163
- export namespace UpdateFirewallDescriptionRequest {
3164
- /**
3165
- * @internal
3166
- */
3167
- export const filterSensitiveLog = (obj: UpdateFirewallDescriptionRequest): any => ({
3168
- ...obj,
3169
- });
3170
- }
3171
-
3172
- export interface UpdateFirewallDescriptionResponse {
3173
- /**
3174
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3175
- */
3176
- FirewallArn?: string;
3177
-
3178
- /**
3179
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3180
- */
3181
- FirewallName?: string;
3182
-
3183
- /**
3184
- * <p>A description of the firewall.</p>
3185
- */
3186
- Description?: string;
3187
-
3188
- /**
3189
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
3190
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
3191
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
3192
- */
3193
- UpdateToken?: string;
3194
- }
3195
-
3196
- export namespace UpdateFirewallDescriptionResponse {
3197
- /**
3198
- * @internal
3199
- */
3200
- export const filterSensitiveLog = (obj: UpdateFirewallDescriptionResponse): any => ({
3201
- ...obj,
3202
- });
3203
- }
3204
-
3205
- export interface UpdateFirewallPolicyRequest {
3206
- /**
3207
- * <p>A token used for optimistic locking. Network Firewall returns a token to your requests that access the firewall policy. The token marks the state of the policy resource at the time of the request. </p>
3208
- * <p>To make changes to the policy, you provide the token in your request. Network Firewall uses the token to ensure that the policy hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall policy again to get a current copy of it with current token. Reapply your changes as needed, then try the operation again using the new token. </p>
3209
- */
3210
- UpdateToken: string | undefined;
3211
-
3212
- /**
3213
- * <p>The Amazon Resource Name (ARN) of the firewall policy.</p>
3214
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3215
- */
3216
- FirewallPolicyArn?: string;
3217
-
3218
- /**
3219
- * <p>The descriptive name of the firewall policy. You can't change the name of a firewall policy after you create it.</p>
3220
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3221
- */
3222
- FirewallPolicyName?: string;
3223
-
3224
- /**
3225
- * <p>The updated firewall policy to use for the firewall. </p>
3226
- */
3227
- FirewallPolicy: FirewallPolicy | undefined;
3228
-
3229
- /**
3230
- * <p>A description of the firewall policy.</p>
3231
- */
3232
- Description?: string;
3233
-
3234
- /**
3235
- * <p>Indicates whether you want Network Firewall to just check the validity of the request, rather than run the request. </p>
3236
- * <p>If set to <code>TRUE</code>, Network Firewall checks whether the request can run successfully,
3237
- * but doesn't actually make the requested changes. The call returns the value that the request would return if you ran it with
3238
- * dry run set to <code>FALSE</code>, but doesn't make additions or changes to your resources. This option allows you to make sure that you have
3239
- * the required permissions to run the request and that your request parameters are valid. </p>
3240
- * <p>If set to <code>FALSE</code>, Network Firewall makes the requested changes to your resources. </p>
3241
- */
3242
- DryRun?: boolean;
3243
- }
3244
-
3245
- export namespace UpdateFirewallPolicyRequest {
3246
- /**
3247
- * @internal
3248
- */
3249
- export const filterSensitiveLog = (obj: UpdateFirewallPolicyRequest): any => ({
3250
- ...obj,
3251
- });
3252
- }
3253
-
3254
- export interface UpdateFirewallPolicyResponse {
3255
- /**
3256
- * <p>A token used for optimistic locking. Network Firewall returns a token to your requests that access the firewall policy. The token marks the state of the policy resource at the time of the request. </p>
3257
- * <p>To make changes to the policy, you provide the token in your request. Network Firewall uses the token to ensure that the policy hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall policy again to get a current copy of it with current token. Reapply your changes as needed, then try the operation again using the new token. </p>
3258
- */
3259
- UpdateToken: string | undefined;
3260
-
3261
- /**
3262
- * <p>The high-level properties of a firewall policy. This, along with the <a>FirewallPolicy</a>, define the policy. You can retrieve all objects for a firewall policy by calling <a>DescribeFirewallPolicy</a>. </p>
3263
- */
3264
- FirewallPolicyResponse: FirewallPolicyResponse | undefined;
3265
- }
3266
-
3267
- export namespace UpdateFirewallPolicyResponse {
3268
- /**
3269
- * @internal
3270
- */
3271
- export const filterSensitiveLog = (obj: UpdateFirewallPolicyResponse): any => ({
3272
- ...obj,
3273
- });
3274
- }
3275
-
3276
- export interface UpdateFirewallPolicyChangeProtectionRequest {
3277
- /**
3278
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
3279
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
3280
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
3281
- */
3282
- UpdateToken?: string;
3283
-
3284
- /**
3285
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3286
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3287
- */
3288
- FirewallArn?: string;
3289
-
3290
- /**
3291
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3292
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3293
- */
3294
- FirewallName?: string;
3295
-
3296
- /**
3297
- * <p>A setting indicating whether the firewall is protected against a change to the firewall policy association.
3298
- * Use this setting to protect against
3299
- * accidentally modifying the firewall policy for a firewall that is in use. When you create a firewall, the operation initializes this setting to <code>TRUE</code>.</p>
3300
- */
3301
- FirewallPolicyChangeProtection: boolean | undefined;
3302
- }
3303
-
3304
- export namespace UpdateFirewallPolicyChangeProtectionRequest {
3305
- /**
3306
- * @internal
3307
- */
3308
- export const filterSensitiveLog = (obj: UpdateFirewallPolicyChangeProtectionRequest): any => ({
3309
- ...obj,
3310
- });
3311
- }
3312
-
3313
- export interface UpdateFirewallPolicyChangeProtectionResponse {
3314
- /**
3315
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
3316
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
3317
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
3318
- */
3319
- UpdateToken?: string;
3320
-
3321
- /**
3322
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3323
- */
3324
- FirewallArn?: string;
3325
-
3326
- /**
3327
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3328
- */
3329
- FirewallName?: string;
3330
-
3331
- /**
3332
- * <p>A setting indicating whether the firewall is protected against a change to the firewall policy association.
3333
- * Use this setting to protect against
3334
- * accidentally modifying the firewall policy for a firewall that is in use. When you create a firewall, the operation initializes this setting to <code>TRUE</code>.</p>
3335
- */
3336
- FirewallPolicyChangeProtection?: boolean;
3337
- }
3338
-
3339
- export namespace UpdateFirewallPolicyChangeProtectionResponse {
3340
- /**
3341
- * @internal
3342
- */
3343
- export const filterSensitiveLog = (obj: UpdateFirewallPolicyChangeProtectionResponse): any => ({
3344
- ...obj,
3345
- });
3346
- }
3347
-
3348
- export interface UpdateLoggingConfigurationRequest {
3349
- /**
3350
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3351
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3352
- */
3353
- FirewallArn?: string;
3354
-
3355
- /**
3356
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3357
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3358
- */
3359
- FirewallName?: string;
3360
-
3361
- /**
3362
- * <p>Defines how Network Firewall performs logging for a firewall. If you omit this setting,
3363
- * Network Firewall disables logging for the firewall.</p>
3364
- */
3365
- LoggingConfiguration?: LoggingConfiguration;
3366
- }
3367
-
3368
- export namespace UpdateLoggingConfigurationRequest {
3369
- /**
3370
- * @internal
3371
- */
3372
- export const filterSensitiveLog = (obj: UpdateLoggingConfigurationRequest): any => ({
3373
- ...obj,
3374
- });
3375
- }
3376
-
3377
- export interface UpdateLoggingConfigurationResponse {
3378
- /**
3379
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3380
- */
3381
- FirewallArn?: string;
3382
-
3383
- /**
3384
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3385
- */
3386
- FirewallName?: string;
3387
-
3388
- /**
3389
- * <p>Defines how AWS Network Firewall performs logging for a <a>Firewall</a>. </p>
3390
- */
3391
- LoggingConfiguration?: LoggingConfiguration;
3392
- }
3393
-
3394
- export namespace UpdateLoggingConfigurationResponse {
3395
- /**
3396
- * @internal
3397
- */
3398
- export const filterSensitiveLog = (obj: UpdateLoggingConfigurationResponse): any => ({
3399
- ...obj,
3400
- });
3401
- }
3402
-
3403
- export interface UpdateRuleGroupRequest {
3404
- /**
3405
- * <p>A token used for optimistic locking. Network Firewall returns a token to your requests that access the rule group. The token marks the state of the rule group resource at the time of the request. </p>
3406
- * <p>To make changes to the rule group, you provide the token in your request. Network Firewall uses the token to ensure that the rule group hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the rule group again to get a current copy of it with a current token. Reapply your changes as needed, then try the operation again using the new token. </p>
3407
- */
3408
- UpdateToken: string | undefined;
3409
-
3410
- /**
3411
- * <p>The Amazon Resource Name (ARN) of the rule group.</p>
3412
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3413
- */
3414
- RuleGroupArn?: string;
3415
-
3416
- /**
3417
- * <p>The descriptive name of the rule group. You can't change the name of a rule group after you create it.</p>
3418
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3419
- */
3420
- RuleGroupName?: string;
3421
-
3422
- /**
3423
- * <p>An object that defines the rule group rules. </p>
3424
- * <note>
3425
- * <p>You must provide either this rule group setting or a <code>Rules</code> setting, but not both. </p>
3426
- * </note>
3427
- */
3428
- RuleGroup?: RuleGroup;
3429
-
3430
- /**
3431
- * <p>A string containing stateful rule group rules specifications in Suricata flat format, with one rule
3432
- * per line. Use this to import your existing Suricata compatible rule groups. </p>
3433
- * <note>
3434
- * <p>You must provide either this rules setting or a populated <code>RuleGroup</code> setting, but not both. </p>
3435
- * </note>
3436
- * <p>You can provide your rule group specification in Suricata flat format through this setting when you create or update your rule group. The call
3437
- * response returns a <a>RuleGroup</a> object that Network Firewall has populated from your string. </p>
3438
- */
3439
- Rules?: string;
3440
-
3441
- /**
3442
- * <p>Indicates whether the rule group is stateless or stateful. If the rule group is stateless, it contains
3443
- * stateless rules. If it is stateful, it contains stateful rules. </p>
3444
- * <note>
3445
- * <p>This setting is required for requests that do not include the <code>RuleGroupARN</code>.</p>
3446
- * </note>
3447
- */
3448
- Type?: RuleGroupType | string;
3449
-
3450
- /**
3451
- * <p>A description of the rule group. </p>
3452
- */
3453
- Description?: string;
3454
-
3455
- /**
3456
- * <p>Indicates whether you want Network Firewall to just check the validity of the request, rather than run the request. </p>
3457
- * <p>If set to <code>TRUE</code>, Network Firewall checks whether the request can run successfully,
3458
- * but doesn't actually make the requested changes. The call returns the value that the request would return if you ran it with
3459
- * dry run set to <code>FALSE</code>, but doesn't make additions or changes to your resources. This option allows you to make sure that you have
3460
- * the required permissions to run the request and that your request parameters are valid. </p>
3461
- * <p>If set to <code>FALSE</code>, Network Firewall makes the requested changes to your resources. </p>
3462
- */
3463
- DryRun?: boolean;
3464
- }
3465
-
3466
- export namespace UpdateRuleGroupRequest {
3467
- /**
3468
- * @internal
3469
- */
3470
- export const filterSensitiveLog = (obj: UpdateRuleGroupRequest): any => ({
3471
- ...obj,
3472
- });
3473
- }
3474
-
3475
- export interface UpdateRuleGroupResponse {
3476
- /**
3477
- * <p>A token used for optimistic locking. Network Firewall returns a token to your requests that access the rule group. The token marks the state of the rule group resource at the time of the request. </p>
3478
- * <p>To make changes to the rule group, you provide the token in your request. Network Firewall uses the token to ensure that the rule group hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the rule group again to get a current copy of it with a current token. Reapply your changes as needed, then try the operation again using the new token. </p>
3479
- */
3480
- UpdateToken: string | undefined;
3481
-
3482
- /**
3483
- * <p>The high-level properties of a rule group. This, along with the <a>RuleGroup</a>, define the rule group. You can retrieve all objects for a rule group by calling <a>DescribeRuleGroup</a>. </p>
3484
- */
3485
- RuleGroupResponse: RuleGroupResponse | undefined;
3486
- }
3487
-
3488
- export namespace UpdateRuleGroupResponse {
3489
- /**
3490
- * @internal
3491
- */
3492
- export const filterSensitiveLog = (obj: UpdateRuleGroupResponse): any => ({
3493
- ...obj,
3494
- });
3495
- }
3496
-
3497
- export interface UpdateSubnetChangeProtectionRequest {
3498
- /**
3499
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
3500
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
3501
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
3502
- */
3503
- UpdateToken?: string;
3504
-
3505
- /**
3506
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3507
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3508
- */
3509
- FirewallArn?: string;
3510
-
3511
- /**
3512
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3513
- * <p>You must specify the ARN or the name, and you can specify both. </p>
3514
- */
3515
- FirewallName?: string;
3516
-
3517
- /**
3518
- * <p>A setting indicating whether the firewall is protected against changes to the subnet associations.
3519
- * Use this setting to protect against
3520
- * accidentally modifying the subnet associations for a firewall that is in use. When you create a firewall, the operation initializes this setting to <code>TRUE</code>.</p>
3521
- */
3522
- SubnetChangeProtection: boolean | undefined;
3523
- }
3524
-
3525
- export namespace UpdateSubnetChangeProtectionRequest {
3526
- /**
3527
- * @internal
3528
- */
3529
- export const filterSensitiveLog = (obj: UpdateSubnetChangeProtectionRequest): any => ({
3530
- ...obj,
3531
- });
3532
- }
3533
-
3534
- export interface UpdateSubnetChangeProtectionResponse {
3535
- /**
3536
- * <p>An optional token that you can use for optimistic locking. Network Firewall returns a token to your requests that access the firewall. The token marks the state of the firewall resource at the time of the request. </p>
3537
- * <p>To make an unconditional change to the firewall, omit the token in your update request. Without the token, Network Firewall performs your updates regardless of whether the firewall has changed since you last retrieved it.</p>
3538
- * <p>To make a conditional change to the firewall, provide the token in your update request. Network Firewall uses the token to ensure that the firewall hasn't changed since you last retrieved it. If it has changed, the operation fails with an <code>InvalidTokenException</code>. If this happens, retrieve the firewall again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token. </p>
3539
- */
3540
- UpdateToken?: string;
3541
-
3542
- /**
3543
- * <p>The Amazon Resource Name (ARN) of the firewall.</p>
3544
- */
3545
- FirewallArn?: string;
3546
-
3547
- /**
3548
- * <p>The descriptive name of the firewall. You can't change the name of a firewall after you create it.</p>
3549
- */
3550
- FirewallName?: string;
3551
-
3552
- /**
3553
- * <p>A setting indicating whether the firewall is protected against changes to the subnet associations.
3554
- * Use this setting to protect against
3555
- * accidentally modifying the subnet associations for a firewall that is in use. When you create a firewall, the operation initializes this setting to <code>TRUE</code>.</p>
3556
- */
3557
- SubnetChangeProtection?: boolean;
3558
- }
3559
-
3560
- export namespace UpdateSubnetChangeProtectionResponse {
3561
- /**
3562
- * @internal
3563
- */
3564
- export const filterSensitiveLog = (obj: UpdateSubnetChangeProtectionResponse): any => ({
3565
- ...obj,
3566
- });
3567
- }