Stay organized with collections
Save and categorize content based on your preferences.
Domain-based access control ensures security while also allowing you to define
and control which domains can display the Contact Center AI Platform (CCAI Platform) agent adapter.
Specify a domain
The format for specifying a domain can be any valid domain name, and can include
a wildcard (*) to match an arbitrary number of subdomains. The wildcard must be
placed at the beginning of the domain, and it will match any subdomains.
Additionally, you have the option to specify a protocol and a port using the
syntax <protocol>://<domain>:<port>.
The port can be a wildcard, but the protocol cannot be a wildcard. If a protocol
is specified, it will match only that protocol and all other protocols won't
be able to display the adapter.
For example:
https://some.example.domain.com won't match http://some.example.domain.com
or mail://some.example.domain.com.
Add domains in developer settings
In the CCAI Platform portal, go to Developer Settings >
Agent Adapter-Domain Based Access Control.
Enter each domain on a new line. Format is *.domain. If no domains are
specified, access is granted to all domains.
For example, *.mycompany.com.
CRM specific domains
Use the following domain naming conventions when entering your CRM domain. If
you don't include all of these domains for a specific CRM, the Agent Adapter
will immediately break.
If the agent adapter is not visible to agents after making administrator
configuration changes, the agent must right click over the agent adapter and
then select the Reload Frame operation.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eDomain-based access control lets you specify which domains can display the CCAI Platform agent adapter, enhancing security by limiting access.\u003c/p\u003e\n"],["\u003cp\u003eDomains can be defined using wildcards at the beginning to include subdomains, or specific protocols and ports using the format \u003ccode\u003e<protocol>://<domain>:<port>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSpecific domains must be added for CRM integrations to function correctly, such as \u003ccode\u003e*.visualforce.com\u003c/code\u003e, \u003ccode\u003e*.force.com\u003c/code\u003e, and \u003ccode\u003e*.salesforce.com\u003c/code\u003e for Salesforce.\u003c/p\u003e\n"],["\u003cp\u003eChanges to the list of allowed domains may take up to a minute to take effect, and if the agent adapter isn't visible, agents can right-click and select "Reload Frame".\u003c/p\u003e\n"]]],[],null,["# Domain-based access control ensures security while also allowing you to define\nand control which domains can display the Contact Center AI Platform (CCAI Platform) agent adapter.\n\nSpecify a domain\n----------------\n\nThe format for specifying a domain can be any valid domain name, and can include\na wildcard (\\*) to match an arbitrary number of subdomains. The wildcard must be\nplaced at the beginning of the domain, and it will match any subdomains.\nAdditionally, you have the option to specify a protocol and a port using the\nsyntax `\u003cprotocol\u003e://\u003cdomain\u003e:\u003cport\u003e`.\n\nThe port can be a wildcard, but the protocol cannot be a wildcard. If a protocol\nis specified, it will match only that protocol and all other protocols won't\nbe able to display the adapter.\n\nFor example:\n\n`https://some.example.domain.com` won't match `http://some.example.domain.com`\nor `mail://some.example.domain.com`.\n\nAdd domains in developer settings\n---------------------------------\n\n| **Note:** Once added it can take up to a minute for changes to the list of domains to take effect.\n\n1. In the CCAI Platform portal, go to **Developer Settings \\\u003e\n Agent Adapter-Domain Based Access Control**.\n\n2. Enter each domain on a new line. Format is `*.domain`. If no domains are\n specified, access is granted to all domains.\n\n For example, `*.mycompany.com`.\n\nCRM specific domains\n--------------------\n\nUse the following domain naming conventions when entering your CRM domain. If\nyou don't include all of these domains for a specific CRM, the Agent Adapter\nwill immediately break.\n\n- **Salesforce:** `*.visualforce.com` `*.force.com` `*.salesforce.com`\n\n- **Zendesk:** `*.zdusercontent.com` `*.zendesk.com`\n\n- **Microsoft Dynamics:** `*.crm.dynamics.com`\n\n- **Kustomer:** `*.kustomerapp.com`\n\n- **HubSpot:** `*.hubspot`\n\nReload frame on the agent adapter\n---------------------------------\n\nIf the agent adapter is not visible to agents after making administrator\nconfiguration changes, the agent must **right click** over the agent adapter and\nthen select the **Reload Frame** operation."]]
