Difference between revisions of "PEC-Hybrid/Current/Admin/About"
From Genesys Documentation
(Published) |
(Published) |
||
| Line 31: | Line 31: | ||
* An '''Admin console''' that you may use to configure your Common Cloud integration. | * An '''Admin console''' that you may use to configure your Common Cloud integration. | ||
* A user with the '''PureCloud Admin''' role, which includes default admin permissions as well as Single Sign-On and any integration-specific permissions. | * A user with the '''PureCloud Admin''' role, which includes default admin permissions as well as Single Sign-On and any integration-specific permissions. | ||
| − | * A default '''AI Agent''' role that provides agent access to | + | * A default '''AI Agent''' role (if required by your integration) that provides agent access to AI services, such as Altocloud. |
As an administrator, you may access your PureCloud organization by logging in at https://login.mypurecloud.com (or a [https://developer.mypurecloud.com/api/rest/index.html region specific login] URL; The PureCloud welcome email directs you to the appropriate application URL for your region) with the credentials you set when you activate your PureCloud account from the welcome email you received. | As an administrator, you may access your PureCloud organization by logging in at https://login.mypurecloud.com (or a [https://developer.mypurecloud.com/api/rest/index.html region specific login] URL; The PureCloud welcome email directs you to the appropriate application URL for your region) with the credentials you set when you activate your PureCloud account from the welcome email you received. | ||
| Line 41: | Line 41: | ||
# Open '''Organization Settings'''. | # Open '''Organization Settings'''. | ||
# In the '''Organization Details''' tab, open '''Advanced'''. | # In the '''Organization Details''' tab, open '''Advanced'''. | ||
| − | # Copy the Company Name, Short Name, and Organization ID — you will need these values to complete your account configuration. For example:<br>[[File:Hybrid_Organization_Name_And_ID.png|500px]] | + | # Copy the Company Name, Short Name, and Organization ID — you will need these values to complete your account configuration in the '''PureEngage On Premises: Transaction object for hybrid integrations''' |
| + | |Type=Unstructured''' section. For example:<br>[[File:Hybrid_Organization_Name_And_ID.png|500px]] | ||
|Status=No | |Status=No | ||
}} | }} | ||
| Line 63: | Line 64: | ||
</li> | </li> | ||
<li>Or using the API, reference [https://developer.mypurecloud.com/api/rest/v2/oauth/ these endpoints].</li> | <li>Or using the API, reference [https://developer.mypurecloud.com/api/rest/v2/oauth/ these endpoints].</li> | ||
| + | <li>Copy the client ID and Secret for later use.</li> | ||
</ul> | </ul> | ||
For more information about Permissions for Altocloud, see the [https://help.mypurecloud.com/articles/altocloud-permissions-overview/ Altocloud permissions overview]. | For more information about Permissions for Altocloud, see the [https://help.mypurecloud.com/articles/altocloud-permissions-overview/ Altocloud permissions overview]. | ||
| Line 76: | Line 78: | ||
[[File:Hybrid_SAML2Bearer_Authorization.png|500px]] | [[File:Hybrid_SAML2Bearer_Authorization.png|500px]] | ||
</li> | </li> | ||
| + | <li>Copy the client ID and Secret for later use.</li> | ||
</ol> | </ol> | ||
</li> | </li> | ||
| Line 100: | Line 103: | ||
} | } | ||
</source> | </source> | ||
| + | <p>'''issuerURI''': the URI set when you created the SAML certificate in Step 2 (above).</p> | ||
| + | <p>'''ssoTargetURI''': the http redirect URL which should resolve to your PureCloud domain. Example: https://app.mypurecloud.com (domain varies according to your region).</p> | ||
'''Troubleshooting''': | '''Troubleshooting''': | ||
<ul> | <ul> | ||
| Line 107: | Line 112: | ||
</ul> | </ul> | ||
</li> | </li> | ||
| − | <li>By default, Altocloud permissions are included in the Admin and AI Agent roles. As auto-provisioned users are created with the '''employee''' role, which does not include Altocloud permissions. You must grant the [https://help.mypurecloud.com/articles/altocloud-permissions-overview/ Altocloud permissions] to the employee role. You may grant Altocloud permissions to additional roles as needed.</li> | + | <li>By default, Altocloud permissions are included in the '''Admin''' and '''AI Agent''' roles (which includes all necessary permissions for using Altocloud). As auto-provisioned users are created with the '''employee''' role, which does not include Altocloud permissions. You must grant the [https://help.mypurecloud.com/articles/altocloud-permissions-overview/ Altocloud permissions] to the employee role. You may grant Altocloud permissions to additional roles as needed. Copy these role names for the '''PureEngage On Premises: Transaction object for hybrid integrations''' steps below.</li> |
| − | <li>(Optional as needed) Create additional Admin accounts by [https://help.mypurecloud.com/articles/add-people-organization/ adding people to your organization] and [https://help.mypurecloud.com/articles/assign-roles-divisions-licenses-and-add-ons/ assigning them] to the Admin role.</li> | + | <li>(Optional as needed) Create additional '''Admin''' accounts by [https://help.mypurecloud.com/articles/add-people-organization/ adding people to your organization] and [https://help.mypurecloud.com/articles/assign-roles-divisions-licenses-and-add-ons/ assigning them] to the '''Admin''' role.</li> |
</ol> | </ol> | ||
|Status=No | |Status=No | ||
| Line 133: | Line 138: | ||
<li>'''organization_sname''': The PureCloud organization short name for this tenant.</li> | <li>'''organization_sname''': The PureCloud organization short name for this tenant.</li> | ||
<li>'''organization_id''': The PureCloud organization id for this tenant.</li> | <li>'''organization_id''': The PureCloud organization id for this tenant.</li> | ||
| − | <li>'''default_agent_role_name''': The default PureCloud agent role name for an AI | + | <li>'''default_agent_role_name''': The default PureCloud agent role name for an '''AI Agent'''. This will always be '''employee'''. </li> |
<li>'''default_admin_role_name''': The default PureCloud admin role name. This is '''admin'''.</li> | <li>'''default_admin_role_name''': The default PureCloud admin role name. This is '''admin'''.</li> | ||
<li>'''base_auth_url''': The base auth URL that can be used for any PureCloud service; for example: '''base_auth_url''' should be <nowiki>https://[region_host]/oauth/token</nowiki> (for example: <nowiki>"https://login.mypurecloud.com/oauth/token"</nowiki>). <nowiki>[region_host]</nowiki> is the authentication-based FQDN for the region; the regions are listed on [https://developer.mypurecloud.com/api/rest/ this page].</li> | <li>'''base_auth_url''': The base auth URL that can be used for any PureCloud service; for example: '''base_auth_url''' should be <nowiki>https://[region_host]/oauth/token</nowiki> (for example: <nowiki>"https://login.mypurecloud.com/oauth/token"</nowiki>). <nowiki>[region_host]</nowiki> is the authentication-based FQDN for the region; the regions are listed on [https://developer.mypurecloud.com/api/rest/ this page].</li> | ||
Revision as of 13:30, June 19, 2019
Contents
This article describes the essential provisioning steps to enable a hybrid integration between Genesys PureEngage On-Premises deployments and Genesys PureCloud services. This enables you to access many of the great Genesys PureCloud Services in your On-Premises deployments.