Skip to content

Commit 945cea1

Browse files
megvanhuygenmegvanhuygen
authored
Merge pull request #92754 from v-viinde/commupdate
Product Backlog Item 836930: SaaS App Tutorial: Comm100 Live Chat Update
2 parents d7ef405 + 105fb1b commit 945cea1

File tree

1 file changed

+80
-142
lines changed

1 file changed

+80
-142
lines changed

‎articles/active-directory/saas-apps/comm100livechat-tutorial.md

Lines changed: 80 additions & 142 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: 'Tutorial: Azure Active Directory integration with Comm100 Live Chat | Microsoft Docs'
2+
title: 'Tutorial: Azure Active Directory single sign-on (SSO) integration with Comm100 Live Chat | Microsoft Docs'
33
description: Learn how to configure single sign-on between Azure Active Directory and Comm100 Live Chat.
44
services: active-directory
55
documentationCenter: na
@@ -14,145 +14,132 @@ ms.workload: identity
1414
ms.tgt_pltfrm: na
1515
ms.devlang: na
1616
ms.topic: tutorial
17-
ms.date: 01/22/2019
17+
ms.date: 10/22/2019
1818
ms.author: jeedes
1919

2020
ms.collection: M365-identity-device-management
2121
---
22-
# Tutorial: Azure Active Directory integration with Comm100 Live Chat
2322

24-
In this tutorial, you learn how to integrate Comm100 Live Chat with Azure Active Directory (Azure AD).
25-
Integrating Comm100 Live Chat with Azure AD provides you with the following benefits:
23+
# Tutorial: Azure Active Directory single sign-on (SSO) integration with Comm100 Live Chat
2624

27-
* You can control in Azure AD who has access to Comm100 Live Chat.
28-
* You can enable your users to be automatically signed-in to Comm100 Live Chat (Single Sign-On) with their Azure AD accounts.
29-
* You can manage your accounts in one central location - the Azure portal.
25+
In this tutorial, you'll learn how to integrate Comm100 Live Chat with Azure Active Directory (Azure AD). When you integrate Comm100 Live Chat with Azure AD, you can:
3026

31-
If you want to know more details about SaaS app integration with Azure AD, see [What is application access and single sign-on with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis).
32-
If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
27+
* Control in Azure AD who has access to Comm100 Live Chat.
28+
* Enable your users to be automatically signed-in to Comm100 Live Chat with their Azure AD accounts.
29+
* Manage your accounts in one central location - the Azure portal.
30+
31+
To learn more about SaaS app integration with Azure AD, see [What is application access and single sign-on with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis).
3332

3433
## Prerequisites
3534

36-
To configure Azure AD integration with Comm100 Live Chat, you need the following items:
35+
To get started, you need the following items:
3736

38-
* An Azure AD subscription. If you don't have an Azure AD environment, you can get one-month trial [here](https://azure.microsoft.com/pricing/free-trial/)
39-
* Comm100 Live Chat single sign-on enabled subscription
37+
* An Azure AD subscription. If you don't have a subscription, you can get a [free account](https://azure.microsoft.com/free/).
38+
* Comm100 Live Chat single sign-on (SSO) enabled subscription.
4039

4140
## Scenario description
4241

43-
In this tutorial, you configure and test Azure AD single sign-on in a test environment.
42+
In this tutorial, you configure and test Azure AD SSO in a test environment.
4443

4544
* Comm100 Live Chat supports **SP** initiated SSO
4645

46+
> [!NOTE]
47+
> Identifier of this application is a fixed string value so only one instance can be configured in one tenant.
48+
4749
## Adding Comm100 Live Chat from the gallery
4850

4951
To configure the integration of Comm100 Live Chat into Azure AD, you need to add Comm100 Live Chat from the gallery to your list of managed SaaS apps.
5052

51-
**To add Comm100 Live Chat from the gallery, perform the following steps:**
52-
53-
1. In the **[Azure portal](https://portal.azure.com)**, on the left navigation panel, click **Azure Active Directory** icon.
54-
55-
![The Azure Active Directory button](common/select-azuread.png)
56-
57-
2. Navigate to **Enterprise Applications** and then select the **All Applications** option.
58-
59-
![The Enterprise applications blade](common/enterprise-applications.png)
60-
61-
3. To add new application, click **New application** button on the top of dialog.
62-
63-
![The New application button](common/add-new-app.png)
64-
65-
4. In the search box, type **Comm100 Live Chat**, select **Comm100 Live Chat** from result panel then click **Add** button to add the application.
66-
67-
![Comm100 Live Chat in the results list](common/search-new-app.png)
68-
69-
## Configure and test Azure AD single sign-on
70-
71-
In this section, you configure and test Azure AD single sign-on with Comm100 Live Chat based on a test user called **Britta Simon**.
72-
For single sign-on to work, a link relationship between an Azure AD user and the related user in Comm100 Live Chat needs to be established.
53+
1. Sign in to the [Azure portal](https://portal.azure.com) using either a work or school account, or a personal Microsoft account.
54+
1. On the left navigation pane, select the **Azure Active Directory** service.
55+
1. Navigate to **Enterprise Applications** and then select **All Applications**.
56+
1. To add new application, select **New application**.
57+
1. In the **Add from the gallery** section, type **Comm100 Live Chat** in the search box.
58+
1. Select **Comm100 Live Chat** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
7359

74-
To configure and test Azure AD single sign-on with Comm100 Live Chat, you need to complete the following building blocks:
7560

76-
1. **[Configure Azure AD Single Sign-On](#configure-azure-ad-single-sign-on)** - to enable your users to use this feature.
77-
2. **[Configure Comm100 Live Chat Single Sign-On](#configure-comm100-live-chat-single-sign-on)** - to configure the Single Sign-On settings on application side.
78-
3. **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with Britta Simon.
79-
4. **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable Britta Simon to use Azure AD single sign-on.
80-
5. **[Create Comm100 Live Chat test user](#create-comm100-live-chat-test-user)** - to have a counterpart of Britta Simon in Comm100 Live Chat that is linked to the Azure AD representation of user.
81-
6. **[Test single sign-on](#test-single-sign-on)** - to verify whether the configuration works.
61+
## Configure and test Azure AD single sign-on for Comm100 Live Chat
8262

83-
### Configure Azure AD single sign-on
63+
Configure and test Azure AD SSO with Comm100 Live Chat using a test user called **B.Simon**. For SSO to work, you need to establish a link relationship between an Azure AD user and the related user in Comm100 Live Chat.
8464

85-
In this section, you enable Azure AD single sign-on in the Azure portal.
65+
To configure and test Azure AD SSO with Comm100 Live Chat, complete the following building blocks:
8666

87-
To configure Azure AD single sign-on with Comm100 Live Chat, perform the following steps:
67+
1. **[Configure Azure AD SSO](#configure-azure-ad-sso)** - to enable your users to use this feature.
68+
1. **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with B.Simon.
69+
1. **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable B.Simon to use Azure AD single sign-on.
70+
1. **[Configure Comm100 Live Chat SSO](#configure-comm100-live-chat-sso)** - to configure the single sign-on settings on application side.
71+
1. **[Create Comm100 Live Chat test user](#create-comm100-live-chat-test-user)** - to have a counterpart of B.Simon in Comm100 Live Chat that is linked to the Azure AD representation of user.
72+
1. **[Test SSO](#test-sso)** - to verify whether the configuration works.
8873

89-
1. In the [Azure portal](https://portal.azure.com/), on the **Comm100 Live Chat** application integration page, select **Single sign-on**.
74+
## Configure Azure AD SSO
9075

91-
![Configure single sign-on link](common/select-sso.png)
76+
Follow these steps to enable Azure AD SSO in the Azure portal.
9277

93-
2. On the **Select a Single sign-on method** dialog, select **SAML/WS-Fed** mode to enable single sign-on.
78+
1. In the [Azure portal](https://portal.azure.com/), on the **Comm100 Live Chat** application integration page, find the **Manage** section and select **single sign-on**.
79+
1. On the **Select a single sign-on method** page, select **SAML**.
80+
1. On the **Set up single sign-on with SAML** page, click the edit/pen icon for **Basic SAML Configuration** to edit the settings.
9481

95-
![Single sign-on select mode](common/select-saml-option.png)
82+
![Edit Basic SAML Configuration](common/edit-urls.png)
9683

97-
3. On the **Set up Single Sign-On with SAML** page, click **Edit** icon to open **Basic SAML Configuration** dialog.
98-
99-
![Edit Basic SAML Configuration](common/edit-urls.png)
100-
101-
4. On the **Basic SAML Configuration** section, perform the following steps:
102-
103-
![Comm100 Live Chat Domain and URLs single sign-on information](common/sp-signonurl.png)
84+
1. On the **Basic SAML Configuration** section, enter the values for the following fields:
10485

10586
In the **Sign-on URL** text box, type a URL using the following pattern:
10687
`https://<SUBDOMAIN>.comm100.com/AdminManage/LoginSSO.aspx?siteId=<SITEID>`
10788

10889
> [!NOTE]
10990
> The Sign-on URL value is not real. You will update the Sign-on URL value with the actual Sign-on URL, which is explained later in the tutorial.
11091

111-
5. Comm100 Live Chat application expects the SAML assertions in a specific format. Configure the following claims for this application. You can manage the values of these attributes from the **User Attributes** section on application integration page. On the **Set up Single Sign-On with SAML** page, click **Edit** button to open **User Attributes** dialog.
92+
1. Comm100 Live Chat application expects the SAML assertions in a specific format, which requires you to add custom attribute mappings to your SAML token attributes configuration. The following screenshot shows the list of default attributes.
11293

11394
![image](common/edit-attribute.png)
11495

115-
6. In the **User Claims** section on the **User Attributes** dialog, edit the claims by using **Edit icon** or add the claims by using **Add new claim** to configure SAML token attribute as shown in the image above and perform the following steps:
96+
1. In addition to above, Comm100 Live Chat application expects few more attributes to be passed back in SAML response which are shown below. These attributes are also pre populated but you can review them as per your requirement.
11697

11798
| Name | Source Attribute|
11899
| ---------------| --------------- |
119100
| email | user.mail |
120101

121-
a. Click **Add new claim** to open the **Manage user claims** dialog.
102+
1. On the **Set up single sign-on with SAML** page, in the **SAML Signing Certificate** section, find **Certificate (Base64)** and select **Download** to download the certificate and save it on your computer.
122103

123-
![image](common/new-save-attribute.png)
124-
125-
![image](common/new-attribute-details.png)
126-
127-
b. In the **Name** textbox, type the attribute name shown for that row.
104+
![The Certificate download link](common/certificatebase64.png)
128105

129-
c. Leave the **Namespace** blank.
106+
1. On the **Set up Comm100 Live Chat** section, copy the appropriate URL(s) based on your requirement.
130107

131-
d. Select Source as **Attribute**.
108+
![Copy configuration URLs](common/copy-configuration-urls.png)
132109

133-
e. From the **Source attribute** list, type the attribute value shown for that row.
110+
### Create an Azure AD test user
134111

135-
f. Click **Ok**
112+
In this section, you'll create a test user in the Azure portal called B.Simon.
136113

137-
g. Click **Save**.
114+
1. From the left pane in the Azure portal, select **Azure Active Directory**, select **Users**, and then select **All users**.
115+
1. Select **New user** at the top of the screen.
116+
1. In the **User** properties, follow these steps:
117+
1. In the **Name** field, enter `B.Simon`.
118+
1. In the **User name** field, enter the [email protected]. For example, `[email protected]`.
119+
1. Select the **Show password** check box, and then write down the value that's displayed in the **Password** box.
120+
1. Click **Create**.
138121

139-
4. On the **Set up Single Sign-On with SAML** page, in the **SAML Signing Certificate** section, click **Download** to download the **Certificate (Base64)** from the given options as per your requirement and save it on your computer.
122+
### Assign the Azure AD test user
140123

141-
![The Certificate download link](common/certificatebase64.png)
124+
In this section, you'll enable B.Simon to use Azure single sign-on by granting access to Comm100 Live Chat.
142125

143-
6. On the **Set up Comm100 Live Chat** section, copy the appropriate URL(s) as per your requirement.
126+
1. In the Azure portal, select **Enterprise Applications**, and then select **All applications**.
127+
1. In the applications list, select **Comm100 Live Chat**.
128+
1. In the app's overview page, find the **Manage** section and select **Users and groups**.
144129

145-
![Copy configuration URLs](common/copy-configuration-urls.png)
130+
![The "Users and groups" link](common/users-groups-blade.png)
146131

147-
a. Login URL
132+
1. Select **Add user**, then select **Users and groups** in the **Add Assignment** dialog.
148133

149-
b. Azure Ad Identifier
134+
![The Add User link](common/add-assign-user.png)
150135

151-
c. Logout URL
136+
1. In the **Users and groups** dialog, select **B.Simon** from the Users list, then click the **Select** button at the bottom of the screen.
137+
1. If you're expecting any role value in the SAML assertion, in the **Select Role** dialog, select the appropriate role for the user from the list and then click the **Select** button at the bottom of the screen.
138+
1. In the **Add Assignment** dialog, click the **Assign** button.
152139

153-
### Configure Comm100 Live Chat Single Sign-On
140+
## Configure Comm100 Live Chat SSO
154141

155-
1. In a different web browser window, login to Comm100 Live Chat as a Security Administrator.
142+
1. In a different web browser window, sign in to Comm100 Live Chat as a Security Administrator.
156143

157144
1. On the top right side of the page, click **My Account**.
158145

@@ -166,74 +153,23 @@ To configure Azure AD single sign-on with Comm100 Live Chat, perform the followi
166153

167154
![Comm100 Live Chat security](./media/comm100livechat-tutorial/tutorial_comm100livechat_singlesignon.png)
168155

169-
a. Copy the first highlighted link and paste it in **Sign-on URL** textbox in **Comm100 Live Chat Domain and URLs** section on Azure portal.
156+
a. Copy the first highlighted link and paste it in **Sign-on URL** textbox in **Basic SAML Configuration** section on Azure portal.
170157

171158
b. In the **SAML SSO URL** textbox, paste the value of **Login URL**, which you have copied from the Azure portal.
172159

173160
c. In the **Remote Logout URL** textbox, paste the value of **Logout URL**, which you have copied from the Azure portal.
174161

175162
d. Click **Choose a File** to upload the base-64 encoded certificate that you have downloaded from the Azure portal, into the **Certificate**.
176163

177-
e. Click **Save Changes**
178-
179-
### Create an Azure AD test user
180-
181-
The objective of this section is to create a test user in the Azure portal called Britta Simon.
182-
183-
1. In the Azure portal, in the left pane, select **Azure Active Directory**, select **Users**, and then select **All users**.
184-
185-
![The "Users and groups" and "All users" links](common/users.png)
186-
187-
2. Select **New user** at the top of the screen.
188-
189-
![New user Button](common/new-user.png)
190-
191-
3. In the User properties, perform the following steps.
192-
193-
![The User dialog box](common/user-properties.png)
194-
195-
a. In the **Name** field enter **BrittaSimon**.
196-
197-
b. In the **User name** field type **brittasimon\@yourcompanydomain.extension**
198-
For example, [email protected]
199-
200-
c. Select **Show password** check box, and then write down the value that's displayed in the Password box.
201-
202-
d. Click **Create**.
203-
204-
### Assign the Azure AD test user
205-
206-
In this section, you enable Britta Simon to use Azure single sign-on by granting access to Comm100 Live Chat.
207-
208-
1. In the Azure portal, select **Enterprise Applications**, select **All applications**, then select **Comm100 Live Chat**.
209-
210-
![Enterprise applications blade](common/enterprise-applications.png)
211-
212-
2. In the applications list, select **Comm100 Live Chat**.
213-
214-
![The Comm100 Live Chat link in the Applications list](common/all-applications.png)
215-
216-
3. In the menu on the left, select **Users and groups**.
217-
218-
![The "Users and groups" link](common/users-groups-blade.png)
219-
220-
4. Click the **Add user** button, then select **Users and groups** in the **Add Assignment** dialog.
221-
222-
![The Add Assignment pane](common/add-assign-user.png)
223-
224-
5. In the **Users and groups** dialog select **Britta Simon** in the Users list, then click the **Select** button at the bottom of the screen.
225-
226-
6. If you are expecting any role value in the SAML assertion then in the **Select Role** dialog select the appropriate role for the user from the list, then click the **Select** button at the bottom of the screen.
227-
228-
7. In the **Add Assignment** dialog click the **Assign** button.
164+
e. Click **Save Changes**.
229165

230166
### Create Comm100 Live Chat test user
231167

232-
To enable Azure AD users to log in to Comm100 Live Chat, they must be provisioned into Comm100 Live Chat. In Comm100 Live Chat, provisioning is a manual task.
168+
To enable Azure AD users to sign in to Comm100 Live Chat, they must be provisioned into Comm100 Live Chat. In Comm100 Live Chat, provisioning is a manual task.
233169

234170
**To provision a user account, perform the following steps:**
235171

236-
1. Log in to Comm100 Live Chat as a Security Administrator.
172+
1. Sign in to Comm100 Live Chat as a Security Administrator.
237173

238174
2. On the top right side of the page, click **My Account**.
239175

@@ -247,29 +183,31 @@ To enable Azure AD users to log in to Comm100 Live Chat, they must be provisione
247183

248184
![Comm100 Live Chat new agent](./media/comm100livechat-tutorial/tutorial_comm100livechat_newagent.png)
249185

250-
a. a. In **Email** text box, enter the email of user like **Brittasimon\@contoso.com**.
186+
a. a. In **Email** text box, enter the email of user like **B.simon\@contoso.com**.
251187

252-
b. In **First Name** text box, enter the first name of user like **Britta**.
188+
b. In **First Name** text box, enter the first name of user like **B**.
253189

254190
c. In **Last Name** text box, enter the last name of user like **simon**.
255191

256-
d. In the **Display Name** textbox, enter the display name of user like **Britta simon**
192+
d. In the **Display Name** textbox, enter the display name of user like **B.simon**
257193

258194
e. In the **Password** textbox, type your password.
259195

260196
f. Click **Save**.
261197

262-
### Test single sign-on
198+
## Test SSO
263199

264200
In this section, you test your Azure AD single sign-on configuration using the Access Panel.
265201

266202
When you click the Comm100 Live Chat tile in the Access Panel, you should be automatically signed in to the Comm100 Live Chat for which you set up SSO. For more information about the Access Panel, see [Introduction to the Access Panel](https://docs.microsoft.com/azure/active-directory/active-directory-saas-access-panel-introduction).
267203

268-
## Additional Resources
204+
## Additional resources
205+
206+
- [ List of Tutorials on How to Integrate SaaS Apps with Azure Active Directory ](https://docs.microsoft.com/azure/active-directory/active-directory-saas-tutorial-list)
269207

270-
- [List of Tutorials on How to Integrate SaaS Apps with Azure Active Directory](https://docs.microsoft.com/azure/active-directory/active-directory-saas-tutorial-list)
208+
- [What is application access and single sign-on with Azure Active Directory? ](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis)
271209

272-
- [What is application access and single sign-on with Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis)
210+
- [What is conditional access in Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/conditional-access/overview)
273211

274-
- [What is Conditional Access in Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/conditional-access/overview)
212+
- [Try Comm100 Live Chat with Azure AD](https://aad.portal.azure.com/)
275213

0 commit comments

Comments
 (0)