Skip to content

Commit 396965c

Browse files
authored
DEV-2490: Formatting for Compliance Setup (#742)
1 parent e4fa71f commit 396965c

1 file changed

Lines changed: 79 additions & 20 deletions

File tree

docs/layers/security-and-compliance/setup.mdx

Lines changed: 79 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -138,6 +138,8 @@ atmos workflow deploy/aws-config/global-collector -f compliance --from-step step
138138

139139
<Steps>
140140
<Step>
141+
### <StepNumber/> Set up AWS Config globally
142+
141143
Deploy AWS Config to each region in order to collect data for global resources such as IAM.
142144

143145
<AtmosWorkflow workflow="deploy/aws-config/global-collector" fileName="compliance" />
@@ -148,7 +150,9 @@ atmos workflow deploy/aws-config/global-collector -f compliance --from-step step
148150
</Step>
149151

150152
<Step>
151-
Deploy AWS Config into accounts that require superadmin to apply.
153+
### <StepNumber/> Set up AWS Config for SuperAdmin accounts
154+
155+
Deploy AWS Config into accounts that require SuperAdmin to apply.
152156

153157
<AtmosWorkflow workflow="deploy/aws-config/superadmin" fileName="compliance" />
154158
</Step>
@@ -158,12 +162,16 @@ atmos workflow deploy/aws-config/global-collector -f compliance --from-step step
158162

159163
<Steps>
160164
<Step>
165+
### <StepNumber/> Set up the Delegated Administrator account
166+
161167
First, deploy to each region of the Delegated Administrator account.
162168

163169
<AtmosWorkflow workflow="deploy/security-hub/step1" fileName="compliance" />
164170
</Step>
165171

166172
<Step>
173+
### <StepNumber/> Set up the Organization Management account
174+
167175
Next, using
168176
[SuperAdmin](/layers/accounts/tutorials/how-to-create-superadmin-user/),
169177
deploy to the Organization Management (root) account in order to designate the `security` account as the Organization
@@ -173,54 +181,105 @@ atmos workflow deploy/aws-config/global-collector -f compliance --from-step step
173181
</Step>
174182

175183
<Step>
184+
### <StepNumber/> Assume the identity role
185+
176186
`assume-role acme-identity`
177187
</Step>
178188

179189
<Step>
190+
### <StepNumber/> Configure Security Hub organization-wide
191+
180192
Finally, deploy the `security-hub/org-settings` component to the `security` account in order to enable and configure
181193
Security Hub in all other accounts and regions.
182194

183195
<AtmosWorkflow workflow="deploy/security-hub/step3" fileName="compliance" />
184196
</Step>
185197
</Steps>
186198

187-
## Guard Duty
199+
## GuardDuty
188200

189-
First, deploy to each region of the Delegated Administrator account.
201+
<Steps>
202+
<Step>
203+
### <StepNumber/> Set up the Delegated Administrator account
190204

191-
<AtmosWorkflow workflow="deploy/guardduty/step1" fileName="compliance" />
205+
First, deploy to each region of the Delegated Administrator account.
192206

193-
Next, deploy to the Organization Management (root) account in order to designate the `security` account as the
194-
Organization Delegated Administrator account.
207+
<AtmosWorkflow workflow="deploy/guardduty/step1" fileName="compliance" />
208+
</Step>
195209

196-
<AtmosWorkflow workflow="deploy/guardduty/step2" fileName="compliance" />
210+
<Step>
211+
### <StepNumber/> Set up the Organization Management account
197212

198-
Finally, deploy to the `security` account in order to enable and configure GuardDuty in all other accounts and regions.
213+
Next, deploy to the Organization Management (root) account in order to designate the `security` account as the
214+
Organization Delegated Administrator account.
199215

200-
<AtmosWorkflow workflow="deploy/guardduty/step3" fileName="compliance" />
216+
<AtmosWorkflow workflow="deploy/guardduty/step2" fileName="compliance" />
217+
</Step>
218+
219+
<Step>
220+
### <StepNumber/> Configure GuardDuty organization-wide
221+
222+
Finally, deploy to the `security` account in order to enable and configure GuardDuty in all other accounts and regions.
223+
224+
<AtmosWorkflow workflow="deploy/guardduty/step3" fileName="compliance" />
225+
</Step>
226+
</Steps>
201227

202228
## Route53 DNS Resolver Firewall
203229

204-
<AtmosWorkflow workflow="deploy/route53-resolver-dns-firewall-buckets" fileName="compliance" />
205-
<AtmosWorkflow workflow="deploy/route53-resolver-dns-firewall" fileName="compliance" />
230+
<Steps>
231+
<Step>
232+
### <StepNumber/> Set up DNS Firewall buckets
233+
234+
Deploy the required S3 buckets for Route53 DNS Resolver Firewall logging.
235+
236+
<AtmosWorkflow workflow="deploy/route53-resolver-dns-firewall-buckets" fileName="compliance" />
237+
</Step>
238+
239+
<Step>
240+
### <StepNumber/> Configure the DNS Firewall
241+
242+
Deploy and configure the Route53 DNS Resolver Firewall.
243+
244+
<AtmosWorkflow workflow="deploy/route53-resolver-dns-firewall" fileName="compliance" />
245+
</Step>
246+
</Steps>
206247

207248
## AWS Shield
208249

209-
:::info
250+
<Steps>
251+
<Step>
252+
### <StepNumber/> Set up AWS Shield Advanced
210253

211-
An [AWS Shield Advanced subscription](https://docs.aws.amazon.com/waf/latest/developerguide/enable-ddos-prem.html) is
212-
required in each `plat` AWS account before running this workflow.
254+
:::info
213255

214-
:::
256+
An [AWS Shield Advanced subscription](https://docs.aws.amazon.com/waf/latest/developerguide/enable-ddos-prem.html) is
257+
required in each `plat` AWS account before running this workflow.
258+
259+
:::
215260

216-
<AtmosWorkflow workflow="deploy/aws-shield" fileName="compliance" />
261+
Deploy AWS Shield Advanced protection.
262+
263+
<AtmosWorkflow workflow="deploy/aws-shield" fileName="compliance" />
264+
</Step>
265+
</Steps>
217266

218267
## AWS Inspector v2
219268

220-
Delegates Administration account for [AWS Inspector v2](https://docs.aws.amazon.com/inspector/latest/user/what-is-inspector.html) to `core-security` for all regions.
269+
<Steps>
270+
<Step>
271+
### <StepNumber/> Set up the Delegated Administrator account
221272

222-
<AtmosWorkflow workflow="deploy/aws-inspector2/step1" fileName="compliance" />
273+
Delegate Administration account for [AWS Inspector v2](https://docs.aws.amazon.com/inspector/latest/user/what-is-inspector.html) to `core-security` for all regions.
223274

224-
Enables Inspector in all regions across accounts
275+
<AtmosWorkflow workflow="deploy/aws-inspector2/step1" fileName="compliance" />
276+
</Step>
225277

226-
<AtmosWorkflow workflow="deploy/aws-inspector2/step2" fileName="compliance" />
278+
<Step>
279+
### <StepNumber/> Configure Inspector organization-wide
280+
281+
Enable Inspector in all regions across accounts.
282+
283+
<AtmosWorkflow workflow="deploy/aws-inspector2/step2" fileName="compliance" />
284+
</Step>
285+
</Steps>

0 commit comments

Comments
 (0)