AWS Security ChangesHomeSearch

AWS amazonq documentation change

Service: amazonq · 2025-05-22 · Documentation low

File: amazonq/latest/qbusiness-ug/slack-credentials.md

Summary

Updated image captions to provide more detailed instructions for Slack app configuration steps, including highlighting specific UI elements like 'Build' option and OAuth token management

Security assessment

Changes focus on improving user guidance for Slack integration setup but do not address security vulnerabilities or introduce new security documentation. While OAuth token handling is security-sensitive, the updates only clarify existing steps rather than addressing specific security flaws.

Diff

diff --git a/amazonq/latest/qbusiness-ug/slack-credentials.md b/amazonq/latest/qbusiness-ug/slack-credentials.md
index 79c4adb4d..c8b076809 100644
--- a//amazonq/latest/qbusiness-ug/slack-credentials.md
+++ b//amazonq/latest/qbusiness-ug/slack-credentials.md
@@ -21 +21 @@ To configure Slack for Amazon Q, you must be an admin user in the Slack account.
-![Slack workspace menu showing Tools & settings expanded with Manage apps option highlighted.](/images/amazonq/latest/qbusiness-ug/images/slack-1.png)
+![Screenshot of the Slack workspace menu showing how to access the App Directory to create a new app for integration.](/images/amazonq/latest/qbusiness-ug/images/slack-1.png)
@@ -25 +25 @@ To configure Slack for Amazon Q, you must be an admin user in the Slack account.
-![Slack App Directory interface showing Installed Apps section with no apps found.](/images/amazonq/latest/qbusiness-ug/images/slack-2.png)
+![Screenshot of the Slack App Directory menu with the "Build" option highlighted, which is used to create a new app for integration.](/images/amazonq/latest/qbusiness-ug/images/slack-2.png)
@@ -29 +29 @@ To configure Slack for Amazon Q, you must be an admin user in the Slack account.
-![Slack API "Your Apps" page with options to create an app or generate tokens.](/images/amazonq/latest/qbusiness-ug/images/slack-3.png)
+![Screenshot of the Slack "Your Apps" page showing the "Create an App" button that users need to click to begin creating a new Slack app.](/images/amazonq/latest/qbusiness-ug/images/slack-3.png)
@@ -33 +33 @@ To configure Slack for Amazon Q, you must be an admin user in the Slack account.
-![Create an app dialog with "From scratch" option highlighted to configure app settings.](/images/amazonq/latest/qbusiness-ug/images/slack-4.png)
+![Screenshot of the Slack "Create an app" page showing the "From scratch" option that allows users to create a new app from the beginning.](/images/amazonq/latest/qbusiness-ug/images/slack-4.png)
@@ -37 +37 @@ To configure Slack for Amazon Q, you must be an admin user in the Slack account.
-![Dialog box for naming an app and selecting a workspace, with fields and a Create App button.](/images/amazonq/latest/qbusiness-ug/images/slack-11.png)
+![Screenshot of the "Name app & choose workspace" dialog box where users enter an app name and select a workspace for deployment.](/images/amazonq/latest/qbusiness-ug/images/slack-11.png)
@@ -41 +41 @@ To configure Slack for Amazon Q, you must be an admin user in the Slack account.
-![Slack API settings page with Basic Information selected and OAuth & Permissions highlighted.](/images/amazonq/latest/qbusiness-ug/images/slack-5.png)
+![Screenshot of the Slack app's "Basic Information" page with the "OAuth & Permissions" option highlighted in the Settings menu.](/images/amazonq/latest/qbusiness-ug/images/slack-5.png)
@@ -51 +51 @@ If you use the bot token as part of your Slack credentials, you cannot index dir
-![Bot Token Scopes interface showing no OAuth Scopes added and an "Add an OAuth Scope" button.](/images/amazonq/latest/qbusiness-ug/images/slack-6.png)
+![Screenshot of the Slack "OAuth & Permissions" page showing the Bot Token Scopes section where users can add permission scopes for the bot.](/images/amazonq/latest/qbusiness-ug/images/slack-6.png)
@@ -91 +91 @@ If you use the bot token as part of your Slack credentials, you cannot index dir
-![User Token Scopes interface showing no OAuth Scopes added and an "Add an OAuth Scope" button.](/images/amazonq/latest/qbusiness-ug/images/slack-7.png)
+![Screenshot of the Slack "OAuth & Permissions" page showing the User Token Scopes section where users can add permission scopes for user-level access.](/images/amazonq/latest/qbusiness-ug/images/slack-7.png)
@@ -123 +123 @@ If you use the bot token as part of your Slack credentials, you cannot index dir
-![OAuth Tokens section with an "Install to Workspace" button for app authentication.](/images/amazonq/latest/qbusiness-ug/images/slack-8.png)
+![Screenshot of the Slack "OAuth & Permissions" page showing the "Install to Workspace" button that users need to click to install the app to their workspace.](/images/amazonq/latest/qbusiness-ug/images/slack-8.png)
@@ -127 +127 @@ If you use the bot token as part of your Slack credentials, you cannot index dir
-![Dialog box requesting permission to access Slack workspace, showing access details and Allow button.](/images/amazonq/latest/qbusiness-ug/images/slack-9.png)
+![Screenshot of the Slack permission request dialog box asking for authorization to access the workspace, with an "Allow" button for users to grant permissions.](/images/amazonq/latest/qbusiness-ug/images/slack-9.png)
@@ -133 +133 @@ On successful completion, the console will display a **OAuth Tokens** screen.
-![OAuth token interface showing User and Bot User token fields with Copy buttons and access levels.](/images/amazonq/latest/qbusiness-ug/images/slack-10.png)
+![Screenshot of the Slack "OAuth Tokens" screen displaying the generated OAuth tokens that need to be copied for connecting to Amazon Q Business.](/images/amazonq/latest/qbusiness-ug/images/slack-10.png)
@@ -141 +141 @@ From the Slack workspace menu, select **Tools and settings** and then select **M
-![Browser address bar showing a Slack app integration URL with a workspace ID highlighted.](/images/amazonq/latest/qbusiness-ug/images/slack-12.png)
+![Screenshot showing the URL of the Slack workspace management page with the team ID highlighted, which is needed for connecting to Amazon Q Business.](/images/amazonq/latest/qbusiness-ug/images/slack-12.png)