[8.16] Updates CSPM guides to include agentless option #5863

benironside · 2024-09-26T21:44:19Z

Fixes #5606 by updating the CSPM deployment documentation to include the new agentless deployment option. Also fixes #4579 by updating the language about the Role ARN configuration field in the AWS guides.

Previews: Set up CSPM on azure
On GCP
On AWS
CSPM landing page

github-actions · 2024-09-26T21:44:34Z

A documentation preview will be available soon.

🔨 Buildkite builds
📚 HTML diff
📙 Preview page

Request a new doc build by commenting

Rebuild this PR: run docs-build
Rebuild this PR and all Elastic docs: run docs-build rebuild

_{run docs-build is much faster than run docs-build rebuild. A rebuild should only be needed in rare situations.}

_{If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here.}

joepeeples

A few line-edits, content looks good!

docs/cloud-native-security/cspm-get-started-aws.asciidoc

docs/serverless/cloud-native-security/cspm-get-started.mdx

docs/cloud-native-security/cspm-get-started-aws.asciidoc

docs/serverless/cloud-native-security/cspm-get-started.mdx

Co-authored-by: Joe Peeples <joe.peeples@elastic.co>

docs/cloud-native-security/cspm-get-started-aws.asciidoc

Omolola-Akinleye · 2024-10-15T16:58:36Z

docs/cloud-native-security/cspm-get-started-aws.asciidoc

@@ -208,7 +224,7 @@ image::images/cspm-aws-auth-3.png[The EC2 page in AWS, showing the Modify IAM ro
 .. Click *Update IAM role*.
 .. Return to {kib} and <<cspm-finish-manual, finish manual setup>>.

-IMPORTANT: Make sure to deploy the CSPM integration to this EC2 instance. When completing setup in {kib}, in the *Setup Access* section, select *Assume role* and leave *Role ARN* empty. Click *Save and continue*.
+IMPORTANT: Make sure to deploy the CSPM integration to this EC2 instance. When completing setup in {kib}, in the *Setup Access* section, select *Assume role*. Leave **Role ARN** empty unless you want to specify a role the ((agent)) should assume instead of the default role for your EC2 instance. Click *Save and continue*.

 [discrete]
 [[cspm-use-keys-directly]]


@smriti0321 I think there are a few callouts or troubleshooting guide for missing regarding Agentless Onboarding.

Once agentless integration has been created, then the status column which takes a few refreshes to see the updated agent count. A callout message talking about the agentless deployment experience taking a minute or two before agent is enrolled and/or ingesting data could be useful here.

Customer enters the wrong credentials with deployed agent. Maybe guide the customer through that experience to rectify an issue with the Edit Flow or restarting with the deletion flow then creation flow again.

Agent is offline or unhealthy then inform customer can still access fleets agents page or explore errors in Logs Explorer.

Deletion flow - warn the customer that deletion will remove resources and stop data ingestion

Changing the fleet server will cause breaking changes. @smriti0321 See comment.

Great inputs @Omolola-Akinleye
@benironside is it possible to cover these in the FAQ for CSPM or you recommend any other place for troubleshooting agentless integrations?

I think the FAQ seems like a good option. Let's cover this in our next sync

incorporated Smriti's review

benironside · 2024-10-31T20:31:04Z

Opened #6044 to track adding the troubleshooting steps that Omolola identified

nastasha-solomon

I left a few minor corrections and edits for your consideration, but looks great overall!

docs/cloud-native-security/cspm-get-started-aws.asciidoc

docs/cloud-native-security/cspm-get-started-azure.asciidoc

docs/cloud-native-security/cspm-get-started-gcp.asciidoc

docs/serverless/cloud-native-security/cspm-get-started-azure.mdx

docs/serverless/cloud-native-security/cspm-get-started-gcp.mdx

docs/serverless/cloud-native-security/cspm-get-started.mdx

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

colleenmcginnis · 2024-11-06T00:34:04Z

@benironside I updated this PR to edit the serverless AsciiDoc file instead of the MDX file based on the changes made in #6061. Let me know if you have any questions!

* Updates AWS CSPM guides to include agentless option * Creates placeholder for agentless integrations page * Update docs/cloud-native-security/cspm-get-started-aws.asciidoc Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/serverless/cloud-native-security/cspm-get-started.mdx Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/cloud-native-security/cspm-get-started-aws.asciidoc Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/serverless/cloud-native-security/cspm-get-started.mdx Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * minor update * Adds agentless options to CSPM docs * Expand steps within the relevant sections * Adds serverless updates * Apply suggestions from code review Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> * update serverless asciidoc files instead of mdx files * polishes serverless versions --------- Co-authored-by: Joe Peeples <joe.peeples@elastic.co> Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> Co-authored-by: Colleen McGinnis <colleen.mcginnis@elastic.co> (cherry picked from commit 4e0ee5f) # Conflicts: # docs/serverless/cloud-native-security/cspm-get-started-azure.asciidoc # docs/serverless/cloud-native-security/cspm-get-started-gcp.asciidoc # docs/serverless/cloud-native-security/cspm-get-started.asciidoc # docs/serverless/cloud-native-security/cspm.asciidoc # docs/serverless/index.asciidoc

…#5863) (#6109) * [8.16] Updates CSPM guides to include agentless option (#5863) * Updates AWS CSPM guides to include agentless option * Creates placeholder for agentless integrations page * Update docs/cloud-native-security/cspm-get-started-aws.asciidoc Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/serverless/cloud-native-security/cspm-get-started.mdx Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/cloud-native-security/cspm-get-started-aws.asciidoc Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/serverless/cloud-native-security/cspm-get-started.mdx Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * minor update * Adds agentless options to CSPM docs * Expand steps within the relevant sections * Adds serverless updates * Apply suggestions from code review Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> * update serverless asciidoc files instead of mdx files * polishes serverless versions --------- Co-authored-by: Joe Peeples <joe.peeples@elastic.co> Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> Co-authored-by: Colleen McGinnis <colleen.mcginnis@elastic.co> (cherry picked from commit 4e0ee5f) # Conflicts: # docs/serverless/cloud-native-security/cspm-get-started-azure.asciidoc # docs/serverless/cloud-native-security/cspm-get-started-gcp.asciidoc # docs/serverless/cloud-native-security/cspm-get-started.asciidoc # docs/serverless/cloud-native-security/cspm.asciidoc # docs/serverless/index.asciidoc * Delete docs/serverless directory and its contents --------- Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

#5863) (#6110) * [8.16] Updates CSPM guides to include agentless option (#5863) * Updates AWS CSPM guides to include agentless option * Creates placeholder for agentless integrations page * Update docs/cloud-native-security/cspm-get-started-aws.asciidoc Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/serverless/cloud-native-security/cspm-get-started.mdx Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/cloud-native-security/cspm-get-started-aws.asciidoc Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/serverless/cloud-native-security/cspm-get-started.mdx Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * minor update * Adds agentless options to CSPM docs * Expand steps within the relevant sections * Adds serverless updates * Apply suggestions from code review Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> * update serverless asciidoc files instead of mdx files * polishes serverless versions --------- Co-authored-by: Joe Peeples <joe.peeples@elastic.co> Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> Co-authored-by: Colleen McGinnis <colleen.mcginnis@elastic.co> (cherry picked from commit 4e0ee5f) # Conflicts: # docs/serverless/cloud-native-security/cspm-get-started-azure.asciidoc # docs/serverless/cloud-native-security/cspm-get-started-gcp.asciidoc # docs/serverless/cloud-native-security/cspm-get-started.asciidoc # docs/serverless/cloud-native-security/cspm.asciidoc # docs/serverless/index.asciidoc * Delete docs/serverless directory and its contents * Update docs/cloud-native-security/cloud-native-security-index.asciidoc --------- Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

* Updates AWS CSPM guides to include agentless option * Creates placeholder for agentless integrations page * Update docs/cloud-native-security/cspm-get-started-aws.asciidoc Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/serverless/cloud-native-security/cspm-get-started.mdx Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/cloud-native-security/cspm-get-started-aws.asciidoc Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * Update docs/serverless/cloud-native-security/cspm-get-started.mdx Co-authored-by: Joe Peeples <joe.peeples@elastic.co> * minor update * Adds agentless options to CSPM docs * Expand steps within the relevant sections * Adds serverless updates * Apply suggestions from code review Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> * update serverless asciidoc files instead of mdx files * polishes serverless versions --------- Co-authored-by: Joe Peeples <joe.peeples@elastic.co> Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> Co-authored-by: Colleen McGinnis <colleen.mcginnis@elastic.co> (cherry picked from commit 4e0ee5f) # Conflicts: # docs/serverless/cloud-native-security/cspm-get-started-azure.asciidoc # docs/serverless/cloud-native-security/cspm-get-started-gcp.asciidoc # docs/serverless/cloud-native-security/cspm-get-started.asciidoc # docs/serverless/cloud-native-security/cspm.asciidoc # docs/serverless/index.asciidoc

Updates AWS CSPM guides to include agentless option

69742e6

benironside added ci:doc-build v8.16.0 labels Sep 26, 2024

benironside self-assigned this Sep 26, 2024

benironside requested a review from a team as a code owner September 26, 2024 21:44

This comment was marked as outdated.

Sign in to view

joepeeples reviewed Sep 27, 2024

View reviewed changes

benironside and others added 6 commits October 2, 2024 11:32

Creates placeholder for agentless integrations page

99c8b64

Update docs/cloud-native-security/cspm-get-started-aws.asciidoc

b9a2f29

Co-authored-by: Joe Peeples <joe.peeples@elastic.co>

Update docs/serverless/cloud-native-security/cspm-get-started.mdx

02551f8

Co-authored-by: Joe Peeples <joe.peeples@elastic.co>

Update docs/cloud-native-security/cspm-get-started-aws.asciidoc

99d6284

Co-authored-by: Joe Peeples <joe.peeples@elastic.co>

Update docs/serverless/cloud-native-security/cspm-get-started.mdx

a9dbee8

Co-authored-by: Joe Peeples <joe.peeples@elastic.co>

minor update

fbcda4b

joepeeples previously approved these changes Oct 9, 2024

View reviewed changes

Adds agentless options to CSPM docs

75a273f

benironside dismissed joepeeples’s stale review via 75a273f October 11, 2024 18:36

benironside requested review from romulets, Omolola-Akinleye and smriti0321 October 11, 2024 19:37

smriti0321 previously requested changes Oct 14, 2024

View reviewed changes

docs/cloud-native-security/cspm-get-started-aws.asciidoc Outdated Show resolved Hide resolved

docs/cloud-native-security/cspm-get-started-aws.asciidoc Outdated Show resolved Hide resolved

docs/cloud-native-security/cspm-get-started-aws.asciidoc Outdated Show resolved Hide resolved

benironside requested a review from a team October 14, 2024 13:37

Omolola-Akinleye reviewed Oct 15, 2024

View reviewed changes

Expand steps within the relevant sections

d45719b

benironside changed the title ~~[8.16] [serverless] Updates AWS CSPM guides to include agentless option~~ [8.16] Updates AWS CSPM guides to include agentless option Oct 22, 2024

benironside and others added 3 commits October 24, 2024 11:36

Adds serverless updates

8a76391

Merge branch 'main' into 5606-cspm-agentless-onboard-beta

952df1f

Merge branch 'main' into 5606-cspm-agentless-onboard-beta

6084b21

benironside mentioned this pull request Oct 31, 2024

[Request] Add agentless troubleshooting steps to Agentless doc #6044

Closed

2 tasks

benironside added the v8.17.0 label Oct 31, 2024

nastasha-solomon reviewed Nov 1, 2024

View reviewed changes

benironside and others added 2 commits November 1, 2024 16:09

Apply suggestions from code review

c97db47

Co-authored-by: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com>

Merge branch 'main' into 5606-cspm-agentless-onboard-beta

3b81925

This comment was marked as outdated.

Sign in to view

colleenmcginnis added 2 commits November 5, 2024 18:12

Merge branch 'main' into 5606-cspm-agentless-onboard-beta

5760f6d

update serverless asciidoc files instead of mdx files

24b1b7b

colleenmcginnis removed the ci:doc-build label Nov 6, 2024

benironside mentioned this pull request Nov 7, 2024

What's new in 8.16 #5953

Closed

24 tasks

benironside changed the title ~~[8.16] Updates AWS CSPM guides to include agentless option~~ [8.16] Updates CSPM guides to include agentless option Nov 7, 2024

benironside mentioned this pull request Nov 11, 2024

[BUG] Fix Cloud Native Security ref link #5890

Closed

polishes serverless versions

9b0f464

joepeeples approved these changes Nov 11, 2024

View reviewed changes

benironside merged commit 4e0ee5f into main Nov 11, 2024
3 checks passed

This was referenced Nov 11, 2024

[8.x] [8.16] Updates CSPM guides to include agentless option (backport #5863) #6109

Merged

[8.16] [8.16] Updates CSPM guides to include agentless option (backport #5863) #6110

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[8.16] Updates CSPM guides to include agentless option #5863

[8.16] Updates CSPM guides to include agentless option #5863

benironside commented Sep 26, 2024 •

edited

Loading

github-actions bot commented Sep 26, 2024

This comment was marked as outdated.

joepeeples left a comment

Omolola-Akinleye Oct 15, 2024

smriti0321 Oct 24, 2024

benironside Oct 24, 2024

benironside commented Oct 31, 2024

nastasha-solomon left a comment

This comment was marked as outdated.

colleenmcginnis commented Nov 6, 2024

[8.16] Updates CSPM guides to include agentless option #5863

[8.16] Updates CSPM guides to include agentless option #5863

Conversation

benironside commented Sep 26, 2024 • edited Loading

github-actions bot commented Sep 26, 2024

This comment was marked as outdated.

joepeeples left a comment

Choose a reason for hiding this comment

Omolola-Akinleye Oct 15, 2024

Choose a reason for hiding this comment

smriti0321 Oct 24, 2024

Choose a reason for hiding this comment

benironside Oct 24, 2024

Choose a reason for hiding this comment

benironside commented Oct 31, 2024

nastasha-solomon left a comment

Choose a reason for hiding this comment

This comment was marked as outdated.

colleenmcginnis commented Nov 6, 2024

benironside commented Sep 26, 2024 •

edited

Loading