Skip to content

Commit 105fb1b

Browse files
v-viindev-viinde
committed
Product Backlog Item 836930: SaaS App Tutorial: Comm100 Live Chat Update
1 parent b045695 commit 105fb1b

File tree

1 file changed

+81
-142
lines changed

1 file changed

+81
-142
lines changed

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

Lines changed: 81 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
@@ -9,149 +9,137 @@ ms.reviewer: barbkess
99

1010
ms.assetid: 0340d7f3-ab54-49ef-b77c-62a0efd5d49c
1111
ms.service: active-directory
12+
ms.subservice: saas-app-tutorial
1213
ms.workload: identity
1314
ms.tgt_pltfrm: na
1415
ms.devlang: na
1516
ms.topic: tutorial
16-
ms.date: 01/22/2019
17+
ms.date: 10/22/2019
1718
ms.author: jeedes
1819

1920
ms.collection: M365-identity-device-management
2021
---
21-
# Tutorial: Azure Active Directory integration with Comm100 Live Chat
2222

23-
In this tutorial, you learn how to integrate Comm100 Live Chat with Azure Active Directory (Azure AD).
24-
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
2524

26-
* You can control in Azure AD who has access to Comm100 Live Chat.
27-
* You can enable your users to be automatically signed-in to Comm100 Live Chat (Single Sign-On) with their Azure AD accounts.
28-
* 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:
2926

30-
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).
31-
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).
3232

3333
## Prerequisites
3434

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

37-
* 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/)
38-
* 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.
3939

4040
## Scenario description
4141

42-
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.
4343

4444
* Comm100 Live Chat supports **SP** initiated SSO
4545

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

4851
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.
4952

50-
**To add Comm100 Live Chat from the gallery, perform the following steps:**
51-
52-
1. In the **[Azure portal](https://portal.azure.com)**, on the left navigation panel, click **Azure Active Directory** icon.
53-
54-
![The Azure Active Directory button](common/select-azuread.png)
55-
56-
2. Navigate to **Enterprise Applications** and then select the **All Applications** option.
57-
58-
![The Enterprise applications blade](common/enterprise-applications.png)
59-
60-
3. To add new application, click **New application** button on the top of dialog.
61-
62-
![The New application button](common/add-new-app.png)
63-
64-
4. In the search box, type **Comm100 Live Chat**, select **Comm100 Live Chat** from result panel then click **Add** button to add the application.
65-
66-
![Comm100 Live Chat in the results list](common/search-new-app.png)
67-
68-
## Configure and test Azure AD single sign-on
69-
70-
In this section, you configure and test Azure AD single sign-on with Comm100 Live Chat based on a test user called **Britta Simon**.
71-
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.
7259

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

75-
1. **[Configure Azure AD Single Sign-On](#configure-azure-ad-single-sign-on)** - to enable your users to use this feature.
76-
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.
77-
3. **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with Britta Simon.
78-
4. **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable Britta Simon to use Azure AD single sign-on.
79-
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.
80-
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
8162

82-
### 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.
8364

84-
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:
8566

86-
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.
8773

88-
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
8975

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

92-
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.
9381

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

96-
3. On the **Set up Single Sign-On with SAML** page, click **Edit** icon to open **Basic SAML Configuration** dialog.
97-
98-
![Edit Basic SAML Configuration](common/edit-urls.png)
99-
100-
4. On the **Basic SAML Configuration** section, perform the following steps:
101-
102-
![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:
10385

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

10789
> [!NOTE]
10890
> 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.
10991

110-
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.
11193

11294
![image](common/edit-attribute.png)
11395

114-
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.
11597

11698
| Name | Source Attribute|
11799
| ---------------| --------------- |
118100
| email | user.mail |
119101

120-
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.
121103

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

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

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

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

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

136-
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**.
137121

138-
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
139123

140-
![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.
141125

142-
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**.
143129

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

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

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

150-
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.
151139

152-
### Configure Comm100 Live Chat Single Sign-On
140+
## Configure Comm100 Live Chat SSO
153141

154-
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.
155143

156144
1. On the top right side of the page, click **My Account**.
157145

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

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

168-
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.
169157

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

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

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

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

229166
### Create Comm100 Live Chat test user
230167

231-
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.
232169

233170
**To provision a user account, perform the following steps:**
234171

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

237174
2. On the top right side of the page, click **My Account**.
238175

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

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

249-
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**.
250187

251-
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**.
252189

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

255-
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**
256193

257194
e. In the **Password** textbox, type your password.
258195

259196
f. Click **Save**.
260197

261-
### Test single sign-on
198+
## Test SSO
262199

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

265202
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).
266203

267-
## 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)
268207

269-
- [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)
270209

271-
- [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)
272211

273-
- [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/)
274213

0 commit comments

Comments
 (0)