AWS Security ChangesHomeSearch

AWS connect: Rewrite Profile Explorer agent workspace setup to use workspace layouts

Service: connect · 2026-11-06 · Documentation low

File: connect/latest/adminguide/add-profileexplorer-to-agentworkspace.md · Type: iam

Summary

Replaces the old procedure (adding Profile Explorer as a third-party integration with access URL, approved origins, and security profile permissions) with a new procedure for selecting a Profile Explorer layout per workspace via UI Management > Workspaces, and adds a 'Before you begin' section requiring the Profile explorer - View security profile permission.

Security assessment

The change is a documentation restructure, not a fix for a specific vulnerability. It does retain/relocate least-privilege guidance by instructing admins to grant agents only the 'Profile explorer - View' security profile permission, which is security-relevant permission guidance, but no CVE, incident, or vulnerability is referenced. The removed integration steps (https requirement, approved origins allowlist) are dropped because the integration approach is no longer used, not because of a security fix.

Evidence

  * Give agents the **Profile explorer - View** permission in their security profile. For more information, see [Enable users to view Profile Explorer](./enabling-profile-explorer.html#enable-users-view-profile-explorer).

Diff

diff --git a/connect/latest/adminguide/add-profileexplorer-to-agentworkspace.md b/connect/latest/adminguide/add-profileexplorer-to-agentworkspace.md
index db2bf6a..246dfef 100644
--- a//connect/latest/adminguide/add-profileexplorer-to-agentworkspace.md
+++ b//connect/latest/adminguide/add-profileexplorer-to-agentworkspace.md
@@ -7 +7 @@
-Create the Profile explorer layout you want to share with agentsAdd Profile explorer to Connect Customer as an integrationAssign agents permission to the new security profileTell agents to pin the new applicationSupported functionality
+Before you beginChoose a Profile Explorer layout for a workspace
@@ -9 +9 @@ Create the Profile explorer layout you want to share with agentsAdd Profile expl
-# Add Profile explorer to the agent workspace
+# Show Profile Explorer in the agent workspace
@@ -11 +11 @@ Create the Profile explorer layout you want to share with agentsAdd Profile expl
-By default users who have the appropriate [security profile permissions](./enabling-profile-explorer.html) can view Profile explorer on the Connect Customer admin website. You might also want your agents to have access to Profile explorer in the agent workspace. This topic explains how to do that.
+By default, the Customer Profiles app in the agent workspace uses a fixed layout. You can replace it with a Profile Explorer layout, so agents see the customer data that are relevant to their work. For example, a travel company might show loyalty status and upcoming trips, while a telecommunications provider might show churn risk and service addresses.
@@ -13 +13 @@ By default users who have the appropriate [security profile permissions](./enabl
-The following image shows an example of Profile explorer in the agent workspace. 
+You choose the layout for each workspace. Agents see the layout after you assign the workspace to them.
@@ -15 +15 @@ The following image shows an example of Profile explorer in the agent workspace.
-![The agent workspace, the Profile explorer tab.](/images/connect/latest/adminguide/images/profile-explorer-agent-workspace.png)
+## Before you begin
@@ -17 +17 @@ The following image shows an example of Profile explorer in the agent workspace.
-## Create the Profile explorer layout you want to share with agents
+  * Create and save the Profile Explorer layout you want agents to see. For more information, see [Create a layout](./create-a-layout.html).
@@ -19 +19 @@ The following image shows an example of Profile explorer in the agent workspace.
-Here's a high-level overview:
+  * Give agents the **Profile explorer - View** permission in their security profile. For more information, see [Enable users to view Profile Explorer](./enabling-profile-explorer.html#enable-users-view-profile-explorer).
@@ -21 +20,0 @@ Here's a high-level overview:
-  1. Make sure you have the [security profile permissions](./enabling-profile-explorer.html) to create a Profile explorer layout.
@@ -23 +21,0 @@ Here's a high-level overview:
-  2. Follow the instructions in [Get started with Connect Customer Customer Profiles Profile Explorer](./getting-started-profile-explorer.html) to create and save the layout you want to share with agents.
@@ -25,0 +24 @@ Here's a high-level overview:
+## Choose a Profile Explorer layout for a workspace
@@ -26,0 +26 @@ Here's a high-level overview:
+  1. Open the Connect Customer admin workspace.
@@ -28 +28 @@ Here's a high-level overview:
-## Add Profile explorer to Connect Customer as an integration
+  2. Go to **UI Management** > **Workspaces** , and choose the workspace.
@@ -30 +30 @@ Here's a high-level overview:
-  1. On the Connect Customer console, in the left navigation, choose **Integrations** , as shown in the following image. 
+  3. In the **Pages** section, add or edit the **Agent Workspace** page. For more information, see [Create a workspace and set the layout](./assign-agent-workspace-layout.html#assign-agent-workspace-layout-create).
@@ -32 +32 @@ Here's a high-level overview:
-![The Connect Customer console, the Integrations menu item.](/images/connect/latest/adminguide/images/integrations.png)
+  4. In the **Customize apps on Agent Workspace** section, for **Customer Profiles** , choose **Enhanced view (Profile Explorer)**.
@@ -34 +34 @@ Here's a high-level overview:
-  2. On the **Integrations** page, choose **Add integration**.
+  5. For **Profile Explorer layout** , choose the layout.
@@ -36 +36 @@ Here's a high-level overview:
-  3. On the **Add integration** page, complete following fields in the **Integration information** section:
+  6. Choose **Save**.
@@ -38,87 +37,0 @@ Here's a high-level overview:
-    1. **Display name** : A friendly name for the application. **This name is displayed to your agents on the tab in the agent workspace**. It is also displayed on security profiles. You can come back and change this name.
-
-    2. **Integration identifier** : The official name that is unique for your integration. If you have only one integration per access URL, we recommend that you use the origin of the access URL. You cannot change this name.
-
-    3. **Description (optional)** : You might optionally provide any description for this application. This description is not displayed to agents.
-
-    4. **Integration type** : Choose **Standard application**. 
-
-    5. **Contact Scope** : Choose **Per contact**. This is a required setting for incoming call support.
-
-    6. **Initialization timeout** : The maximum time, in milliseconds, allowed to establish a connection with the workspace. 
-
-The following image shows the configuration of these fields. Initialization timeout is set to 5 seconds. 
-
-![The Integration information section, configured for the Profile explorer in the agent workspace.](/images/connect/latest/adminguide/images/add-integration.png)
-
-  4. In the **Access** section, complete the following fields:
-
-    1. **Access URL** : This is the URL where your application is hosted. The URL must be secure, starting with https, unless it's a local host.
-
-###### Important
-
-The URL must contain `?_appLayoutMode=embedded`. For example:
-
-`https://{CONNECT_INSTANCE}/customer-profiles/profile-explorer?_appLayoutMode=embedded`
-
-If you don't include `?_appLayoutMode=embedded`, the left navigation from the Connect Customer admin website appears in the agent workspace.
-
-For more details about what is allowed for this field, see [Add a third-party application](./3p-apps.html#onboard-3p-apps-how-to-integrate). 
-
-    2. **Approved origins (optional)** : Allowlist URLs that should be permitted, if different than the access URL. The URL must be secure, starting with https, unless it's a local host.
-
-  5. Completing the next two sections—**Permissions** and **Iframe configuration** —is optional and not required to add the Profile explorer to the agent workspace. For information about these sections, see [Add a third-party application](./3p-apps.html#onboard-3p-apps-how-to-integrate).
-
-  6. **Instance association** : Choose the instance your agents are using.
-
-You can give any instance(s) within this account-region access to this integration.
-
-  7. Choose **Add integration**.
-
-
-
-
-## Assign agents permission to the new security profile
-
-In this step you need to assign agents permissions to access the new integration AND view permission to the Profile explorer.
-
-  1. In the Connect Customer admin website, navigate to the **Agent** security profile. 
-
-  2. On the **Edit security profile** page, assign the following permissions: 
-
-     * **Customer Profiles** \- **Profile explorer** \- **View**
-
-     * **Agent Applications** \- **name of your integration** \- **Access**
-
-The following image shows an example of permissions added for a new integration named **Profile explorer**.
-
-![Security profile permissions for the new integration.](/images/connect/latest/adminguide/images/profile-explorer-securityperms.png)
-
-
-
-
-## Tell agents to pin the new application
-
-Using your normal communication method, tell agents to pin the new application to the agent workspace. This allows them to access Profile explorer across workspace instances.
-
-  * In the agent workspace, choose the more icon, then choose **Pin tab** , as shown in the following image.
-
-![The agent workspace, the Pin tab option.](/images/connect/latest/adminguide/images/pin-tab.png)
-
-
-
-
-## Supported functionality
-
-After you complete the above steps, Profile explorer supports lookups on incoming contacts. The following are supported:
-
-  * Phone and chat: Full support
-
-  * Custom contact attributes: Full support for user-defined attributes that Profile explorer reads. You can set user-defined attributes within a flow to support any customer use case. For example:
-    
-        { 
-    "profileSearchKey": "_phone", 
-    "profileSearchValue": "<Phone number>" }
-    
-
-For more information, see [Automatically populate customer profiles](./auto-pop-customer-profile.html).
@@ -127,0 +41 @@ For more information, see [Automatically populate customer profiles](./auto-pop-
+To return to the fixed layout, follow the same steps and choose **Legacy view** in step 4.