docs: add Slack integration guide - #12438
Conversation
|
Important Review skippedDraft detected. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Organization UI Review profile: ASSERTIVE Plan: Pro Plus Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
2adece4 to
07c69ea
Compare
- Cover the install flow via Add to Slack, choosing the default channel, sending a test message, and what disconnecting revokes - State the four bot scopes Prowler requests, that `chat:write.public` reads broader than it behaves, and that a private channel appears only once `@Prowler` is invited to it in Slack - Point the Slack card's Learn more link at the new page - Distinguish the integration from the Prowler CLI's `--slack` output
07c69ea to
04ae3ca
Compare
|
✅ All required changelog fragments are present. |
|
✅ No Conflicts No conflict markers, and the branch merges cleanly into its base. |
🔒 Container Security ScanImage: ✅ No Vulnerabilities DetectedThe container image passed all security checks. No known CVEs were found.📋 Resources:
|
🔎 Container Security Scan (Grype)Image: ✅ Nothing BlockingNo findings at critical or high severity. 📋 Resources:
|
Context
PR 4 of 4, the top of the Slack integration stack. Based on #12437 — review the layers below first; this PR's diff is the documentation page plus one link.
The page documents choosing a channel, sending a test message and disconnecting, so there was nothing to screenshot until the three layers below existed. It merges last for the same reason.
Description
docs/user-guide/tutorials/prowler-app-slack-integration.mdx, mirroring the Jira tutorial in structure and voice, registered indocs/docs.jsonbeside the other integration tutorials.chat:write.publicreads broader on the consent screen than it behaves — Prowler only ever posts to the channel recorded on the integration — so the page says that plainly rather than leaving a reader to wonder. It also explains that a private channel appears only after@Prowleris invited to it in Slack, by that channel's own members: that invite is the permission grant, and no scope bypasses it.--slackoutput, so the two are not conflated. The CLI feature is not documented here.Steps to review
docs/images/prowler-app/slack/.href; the suite should be unchanged at 21 passing tests.Checklist
Community Checklist
<component>/changelog.d/— included because the "Learn more" link is a user-visible UI change; a docs-only change would have taken theno-changeloglabel instead.UI
ui/changelog.d/API
Not applicable — no API change in this PR, by design.
License
By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.