(Updated via BpDeleteTranslateTags script) |
Wyler.metge (talk | contribs) (Updated via BpClonePage extension. Source page: draft:Saml2-single-sign-on-integration-guide/ConfigurationinBrightPattern) |
||
Line 1: | Line 1: | ||
= Configuration in Bright Pattern= | = Configuration in Bright Pattern= | ||
− | + | The following guide assumes you have [[Saml2-single-sign-on-integration-guide/CreateIdPatForgeRockInstance|configured a ForgeRock Identity Provider]] and [[Saml2-single-sign-on-integration-guide/ExportMetadata|Exported the relevant metatdata]]. | |
+ | The steps below describe how to configure the single sign-on integration in Bright Pattern’s Administrator application. | ||
== Bright Pattern Applications == | == Bright Pattern Applications == | ||
− | |||
− | |||
The Contact Center Administrator application (i.e., “https://<tenant>.brightpattern.com/admin”) is where contact center resources are configured and managed at the system administrator level. For more information, see the [[contact-center-administrator-guide/LoginProcedure|Contact Center Administrator Guide]]. | The Contact Center Administrator application (i.e., “https://<tenant>.brightpattern.com/admin”) is where contact center resources are configured and managed at the system administrator level. For more information, see the [[contact-center-administrator-guide/LoginProcedure|Contact Center Administrator Guide]]. | ||
The Agent Desktop application (i.e., “https://<tenant>.brightpattern.com/agentdesktop”) is where contact center agents and supervisors interact with customers and other users. For more information, see the [[agent-guide/StartingAgentDesktop|Agent Guide]]. | The Agent Desktop application (i.e., “https://<tenant>.brightpattern.com/agentdesktop”) is where contact center agents and supervisors interact with customers and other users. For more information, see the [[agent-guide/StartingAgentDesktop|Agent Guide]]. | ||
− | |||
== Procedure == | == Procedure == | ||
− | === Step 1: | + | === Step 1: Ask your Service Provider to enable the SSO integration for your Contact Center === |
− | + | Ensure your service provider has enabled SSO for your contact center before continuing. | |
− | |||
− | |||
− | |||
− | |||
− | |||
=== Step 2: Create SSO integration account in Contact Center Administrator === | === Step 2: Create SSO integration account in Contact Center Administrator === | ||
Line 26: | Line 19: | ||
# Select account type '''Single Sign-On'''.<br /><br /> | # Select account type '''Single Sign-On'''.<br /><br /> | ||
# Name the account (e.g., “ForgeRock”).<br /><br /> | # Name the account (e.g., “ForgeRock”).<br /><br /> | ||
− | # | + | # Select the checkbox for '''Enable Single Sign-On'''. <br /><br /> |
− | # Enter the '''Identity Provider Single Sign-On URL''': | + | # Optionally, select the checkbox '''Use SSO for administrator portal login'''. |
− | + | #*When selected, SSO will be used to authenticate users of ''both'' the Agent Desktop and the Administrator Portal. | |
− | + | #*When not selected, SSO will only be used to authenticate Agent Desktop users, while Administrator Portal users will login with their BPCC credentials.<br /><br /> | |
− | + | # Enter the '''Identity Provider Single Sign-On URL''', typically formatted as follows:<br /><br /><code>http://<FQDN>:8080/openam/saml2/jsp/idpSSOInit.jsp?metaAlias=/idp&spEntityID=http://<BPSPHostname>/agentdesktop/sso/redirect&binding=urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST</code><br /><br /> | |
− | + | # Enter the '''Identity Provider Single Sign-On Logout URL''' that initiates logout from your identity provider.<br /><br /> | |
− | |||
# Then, beside ''Identity Provider Certificate'', hover your cursor over “empty” and click '''EDIT'''.<br /><br /> | # Then, beside ''Identity Provider Certificate'', hover your cursor over “empty” and click '''EDIT'''.<br /><br /> | ||
# In the dialog that pops up, paste your certificate to the certificate option.<br /><br /> | # In the dialog that pops up, paste your certificate to the certificate option.<br /><br /> |
Latest revision as of 04:42, 7 March 2025
Configuration in Bright Pattern
The following guide assumes you have configured a ForgeRock Identity Provider and Exported the relevant metatdata.
The steps below describe how to configure the single sign-on integration in Bright Pattern’s Administrator application.
Bright Pattern Applications
The Contact Center Administrator application (i.e., “https://<tenant>.brightpattern.com/admin”) is where contact center resources are configured and managed at the system administrator level. For more information, see the Contact Center Administrator Guide.
The Agent Desktop application (i.e., “https://<tenant>.brightpattern.com/agentdesktop”) is where contact center agents and supervisors interact with customers and other users. For more information, see the Agent Guide.
Procedure
Step 1: Ask your Service Provider to enable the SSO integration for your Contact Center
Ensure your service provider has enabled SSO for your contact center before continuing.
Step 2: Create SSO integration account in Contact Center Administrator
For SSO to work, you must also enable it for your contact center in SSO integration account properties.
- In the Contact Center Administrator application, go to Call Center Configuration > Integration Account.
- Click the Add account button (+) to create a new integration account.
- Select account type Single Sign-On.
- Name the account (e.g., “ForgeRock”).
- Select the checkbox for Enable Single Sign-On.
- Optionally, select the checkbox Use SSO for administrator portal login.
- When selected, SSO will be used to authenticate users of both the Agent Desktop and the Administrator Portal.
- When not selected, SSO will only be used to authenticate Agent Desktop users, while Administrator Portal users will login with their BPCC credentials.
- Enter the Identity Provider Single Sign-On URL, typically formatted as follows:
http://<FQDN>:8080/openam/saml2/jsp/idpSSOInit.jsp?metaAlias=/idp&spEntityID=http://<BPSPHostname>/agentdesktop/sso/redirect&binding=urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST
- Enter the Identity Provider Single Sign-On Logout URL that initiates logout from your identity provider.
- Then, beside Identity Provider Certificate, hover your cursor over “empty” and click EDIT.
- In the dialog that pops up, paste your certificate to the certificate option.
- Click Apply to save your changes.
Step 3: Create a user
Before you can test that SSO works, you will need to create a dummy user.
- In the Contact Center Administrator application, go to Users & Teams > Users.
- Click the Add user button to create a new user.
- Set the username as “user1” and specify the desired password.
- Click Apply to save your changes.
Step 4: Test SSO in Agent Desktop
You can try logging in to Agent Desktop with the username and password you just created.
- Go to the Agent Desktop application (e.g., http://<bpsp_hostname>/agentdesktop).
- The login page should redirect you to the ForgeRock login page.
- Enter the credentials for “user1” that you just created.
- The system will then redirect you to Agent Desktop as the logged-in user.
< Previous | Next >