AWS amazonq documentation change

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

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

Summary

Updated image captions to provide more specific guidance for Salesforce credential setup steps

Security assessment

The changes improve documentation clarity for configuring Salesforce OAuth settings, API credentials, and security tokens - all security-sensitive elements. While not addressing a specific vulnerability, they enhance security documentation by providing clearer guidance for proper authentication setup.

Diff

diff --git a/amazonq/latest/qbusiness-ug/salesforce-credentials.md b/amazonq/latest/qbusiness-ug/salesforce-credentials.md
index 41957b975..d65a0e9b0 100644
--- a//amazonq/latest/qbusiness-ug/salesforce-credentials.md
+++ b//amazonq/latest/qbusiness-ug/salesforce-credentials.md
@@ -21 +21 @@ You will need these pieces of information later to connect to Amazon Q.
-![Salesforce setup home page with options for Einstein Bots, Mobile Publisher, and collaborative docs.](/images/amazonq/latest/qbusiness-ug/images/salesforce-1.png)
+![Screenshot showing the Salesforce login page where users enter their credentials to access their Salesforce instance.](/images/amazonq/latest/qbusiness-ug/images/salesforce-1.png)
@@ -25 +25 @@ You will need these pieces of information later to connect to Amazon Q.
-![Salesforce Setup home page with options for Einstein Bots, Mobile Publisher, and collaborative docs.](/images/amazonq/latest/qbusiness-ug/images/salesforce-3.png)
+![Screenshot of the Salesforce profile menu showing the Setup icon and Setup option that users need to select to access the setup page.](/images/amazonq/latest/qbusiness-ug/images/salesforce-3.png)
@@ -31 +31 @@ Then, from the **Lightning Experience App Manager** page, select **New Connected
-![Lightning Experience App Manager interface showing options to create a new app.](/images/amazonq/latest/qbusiness-ug/images/salesforce-2.png)
+![Screenshot of the Salesforce Lightning Experience App Manager page showing the "New Connected App" button that users need to click to create a new connected app.](/images/amazonq/latest/qbusiness-ug/images/salesforce-2.png)
@@ -43 +43 @@ Then, from the **Lightning Experience App Manager** page, select **New Connected
-![Form for basic information with fields for app name, API name, and contact email highlighted.](/images/amazonq/latest/qbusiness-ug/images/salesforce-4.png)
+![Screenshot of the Salesforce "New Connected App" page showing the Basic Information section where users enter the app name, API name, and contact email.](/images/amazonq/latest/qbusiness-ug/images/salesforce-4.png)
@@ -61 +61 @@ Also, copy and save this URL in a text editor of your choice. You will enter thi
-![OAuth settings interface with options for callback URL, scopes, and security features.](/images/amazonq/latest/qbusiness-ug/images/salesforce-5.png)
+![Screenshot of the Salesforce "New Connected App" page showing the API \(Enable OAuth Settings\) section where users configure OAuth settings including callback URL and selected OAuth scopes.](/images/amazonq/latest/qbusiness-ug/images/salesforce-5.png)
@@ -69 +69 @@ Select other options as per your use case.
-![Manage Connected Apps interface with options to edit, delete, and manage app details.](/images/amazonq/latest/qbusiness-ug/images/salesforce-6.png)
+![Screenshot of the Salesforce confirmation message indicating that the connected app has been created successfully and will be available after a short delay.](/images/amazonq/latest/qbusiness-ug/images/salesforce-6.png)
@@ -81 +81 @@ Select other options as per your use case.
-![Consumer Details section with Consumer Key and Secret fields, and Staged Consumer Details options.](/images/amazonq/latest/qbusiness-ug/images/salesforce-7.png)
+![Screenshot of the Salesforce Connected App details page showing the Consumer Details section with the Consumer Key \(client ID\) and Consumer Secret that need to be copied for API authentication.](/images/amazonq/latest/qbusiness-ug/images/salesforce-7.png)
@@ -85 +85 @@ Select other options as per your use case.
-![Salesforce Setup home page with options for Einstein Bots, Mobile Publisher, and collaborative docs.](/images/amazonq/latest/qbusiness-ug/images/salesforce-8.png)
+![Screenshot of the Salesforce user menu showing the "Settings" option that users need to select to access personal settings for generating a security token.](/images/amazonq/latest/qbusiness-ug/images/salesforce-8.png)
@@ -89 +89 @@ Select other options as per your use case.
-![Salesforce interface showing steps to reset security token in personal settings menu.](/images/amazonq/latest/qbusiness-ug/images/salesforce-9.png)
+![Screenshot of the Salesforce personal settings page showing the "My Personal Information" menu with the "Reset My Security Token" option highlighted for generating a new security token.](/images/amazonq/latest/qbusiness-ug/images/salesforce-9.png)
@@ -95 +95 @@ Select other options as per your use case.
-![OAuth and OpenID Connect settings page with options to allow username-password and user-agent flows.](/images/amazonq/latest/qbusiness-ug/images/salesforce-11.png)
+![Screenshot of the Salesforce OAuth and OpenID Connect Settings page showing the OAuth settings configuration options for enabling the Username-Password flow for the connected app.](/images/amazonq/latest/qbusiness-ug/images/salesforce-11.png)