AWS Security ChangesHomeSearch

AWS connect: Add Profile explorer to agent workspace with permissions

Service: connect · 2026-11-05 · Documentation medium

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

Summary

Rewrites the topic from a simple layout-selection procedure into a full workflow: create the Profile explorer layout, add it as a Connect Customer integration (display name, integration type, contact scope, initialization timeout, https access URL with ?_appLayoutMode=embedded, optional approved origins allowlist, instance association), assign agents security profile permissions (Customer Profiles - Profile explorer - View and Agent Applications - Access), and instruct agents to pin the tab. Also documents supported lookup functionality for phone/chat and custom contact attributes.

Security assessment

The change documents least-privilege access control for a new agent-workspace integration: agents must be granted explicit 'Profile explorer - View' and 'Agent Applications - Access' permissions in their security profile, and the integration requires an https access URL plus an optional approved-origins allowlist. This is security best-practice/hardening guidance (permissions, secure URL, origin allowlisting) rather than a fix for a specific vulnerability, so it is not security_issue_related.

Evidence

     * **Agent Applications** \- **name of your integration** \- **Access**

Diff

diff --git a/connect/latest/adminguide/add-profileexplorer-to-agentworkspace.md b/connect/latest/adminguide/add-profileexplorer-to-agentworkspace.md
index 246dfef..db2bf6a 100644
--- a//connect/latest/adminguide/add-profileexplorer-to-agentworkspace.md
+++ b//connect/latest/adminguide/add-profileexplorer-to-agentworkspace.md
@@ -7 +7 @@
-Before you beginChoose a Profile Explorer layout for a workspace
+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
@@ -9 +9 @@ Before you beginChoose a Profile Explorer layout for a workspace
-# Show Profile Explorer in the agent workspace
+# Add Profile explorer to the agent workspace
@@ -11 +11 @@ Before you beginChoose a Profile Explorer layout for a workspace
-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.
+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.
@@ -13 +13 @@ By default, the Customer Profiles app in the agent workspace uses a fixed layout
-You choose the layout for each workspace. Agents see the layout after you assign the workspace to them.
+The following image shows an example of Profile explorer in the agent workspace. 
@@ -15 +15 @@ You choose the layout for each workspace. Agents see the layout after you assign
-## Before you begin
+![The agent workspace, the Profile explorer tab.](/images/connect/latest/adminguide/images/profile-explorer-agent-workspace.png)
@@ -17 +17 @@ You choose the layout for each workspace. Agents see the layout after you assign
-  * Create and save the Profile Explorer layout you want agents to see. For more information, see [Create a layout](./create-a-layout.html).
+## Create the Profile explorer layout you want to share with agents
@@ -19 +19 @@ You choose the layout for each workspace. Agents see the layout after you assign
-  * 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).
+Here's a high-level overview:
@@ -20,0 +21 @@ You choose the layout for each workspace. Agents see the layout after you assign
+  1. Make sure you have the [security profile permissions](./enabling-profile-explorer.html) to create a Profile explorer layout.
@@ -21,0 +23 @@ You choose the layout for each workspace. Agents see the layout after you assign
+  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.
@@ -24 +25,0 @@ You choose the layout for each workspace. Agents see the layout after you assign
-## Choose a Profile Explorer layout for a workspace
@@ -26 +26,0 @@ You choose the layout for each workspace. Agents see the layout after you assign
-  1. Open the Connect Customer admin workspace.
@@ -28 +28 @@ You choose the layout for each workspace. Agents see the layout after you assign
-  2. Go to **UI Management** > **Workspaces** , and choose the workspace.
+## Add Profile explorer to Connect Customer as an integration
@@ -30 +30 @@ You choose the layout for each workspace. Agents see the layout after you assign
-  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).
+  1. On the Connect Customer console, in the left navigation, choose **Integrations** , as shown in the following image. 
@@ -32 +32 @@ You choose the layout for each workspace. Agents see the layout after you assign
-  4. In the **Customize apps on Agent Workspace** section, for **Customer Profiles** , choose **Enhanced view (Profile Explorer)**.
+![The Connect Customer console, the Integrations menu item.](/images/connect/latest/adminguide/images/integrations.png)
@@ -34 +34 @@ You choose the layout for each workspace. Agents see the layout after you assign
-  5. For **Profile Explorer layout** , choose the layout.
+  2. On the **Integrations** page, choose **Add integration**.
@@ -36 +36 @@ You choose the layout for each workspace. Agents see the layout after you assign
-  6. Choose **Save**.
+  3. On the **Add integration** page, complete following fields in the **Integration information** section:
@@ -37,0 +38,87 @@ You choose the layout for each workspace. Agents see the layout after you assign
+    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).
@@ -41 +127,0 @@ You choose the layout for each workspace. Agents see the layout after you assign
-To return to the fixed layout, follow the same steps and choose **Legacy view** in step 4.