Skip to content

Commit 5e1f5a7

Browse files
Merge pull request #249764 from bhavana-129/gainsight-saml-updatte
Update gainsight-tutorial.md
2 parents 3b95901 + fbf05d7 commit 5e1f5a7

File tree

1 file changed

+37
-35
lines changed

1 file changed

+37
-35
lines changed

articles/active-directory/saas-apps/gainsight-tutorial.md

Lines changed: 37 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,9 @@ To integrate Azure Active Directory with Gainsight, you need:
3737

3838
Before you begin the process of configuring single sign-on, you need to add the Gainsight application from the Azure AD gallery. You need a test user account to assign to the application and test the single sign-on configuration.
3939

40-
### Add Gainsight from the Azure AD gallery
40+
### Add Gainsight SAML from the Azure AD gallery
4141

42-
Add Gainsight from the Azure AD application gallery to configure single sign-on with Gainsight. For more information on how to add application from the gallery, see the [Quickstart: Add application from the gallery](../manage-apps/add-application-portal.md).
42+
Add Gainsight SAML from the Azure AD application gallery to configure single sign-on with Gainsight. For more information on how to add application from the gallery, see the [Quickstart: Add application from the gallery](../manage-apps/add-application-portal.md).
4343

4444
### Create and assign Azure AD test user
4545

@@ -53,37 +53,7 @@ Complete the following steps to enable Azure AD single sign-on in the Azure port
5353

5454
1. In the Azure portal, on the **Gainsight** application integration page, find the **Manage** section and select **single sign-on**.
5555
1. On the **Select a single sign-on method** page, select **SAML**.
56-
1. On the **Set up single sign-on with SAML** page, select the pencil icon for **Basic SAML Configuration** to edit the settings.
57-
58-
![Screenshot shows how to edit Basic SAML Configuration.](common/edit-urls.png "Basic Configuration")
59-
60-
1. On the **Basic SAML Configuration** section, perform the following steps:
61-
62-
a. In the **Identifier** textbox, type a value using one of the following patterns:
63-
64-
| **Identifier** |
65-
| ------------- |
66-
| `urn:auth0:gainsight:<ID>` |
67-
| `urn:auth0:gainsight-eu:<ID>` |
68-
69-
b. In the **Reply URL** textbox, type a URL using one of the following patterns:
70-
71-
| **Reply URL** |
72-
| ------------- |
73-
| `https://secured.gainsightcloud.com/login/callback connection=<ID>` |
74-
| `https://secured.eu.gainsightcloud.com/login/callback?connection=<ID>` |
75-
76-
1. Perform the following step, if you wish to configure the application in **SP** initiated mode:
77-
78-
In the **Sign on URL** textbox, type a URL using one of the following patterns:
79-
80-
| **Sign on URL** |
81-
|------------|
82-
| `https://secured.gainsightcloud.com/samlp/<ID>` |
83-
| `https://secured.eu.gainsightcloud.com/samlp/<ID>` |
84-
85-
> [!NOTE]
86-
> These values are not real. Update these values with the actual Identifier, Reply URL and Sign on URL. Contact [Gainsight support team](mailto:[email protected]) to get these values. You can also refer to the patterns shown in the **Basic SAML Configuration** section in the Azure portal.
56+
1. Provide any dummy url like (`https://gainsight.com`) in the **Identifier (Entity ID)** and **Reply URL (Assertion Consumer Service URL)** in **Basic SAML Configuration** in the Azure portal.
8757

8858
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.
8959

@@ -93,6 +63,8 @@ Complete the following steps to enable Azure AD single sign-on in the Azure port
9363

9464
![Screenshot shows to copy configuration appropriate URL.](common/copy-configuration-urls.png "Metadata")
9565

66+
1. Now on the Gainsight Side, Navigate to **User Management** and click on **Authentication** tab, create a new **SAML** Authentication.
67+
9668
## Setup SAML 2.0 Authentication in Gainsight
9769

9870
> [!NOTE]
@@ -108,7 +80,7 @@ Complete the following steps to enable Azure AD single sign-on in the Azure port
10880

10981
1. In the **User Management** page, navigate to **Authentication** tab and click **Add Authentication** > **SAML**.
11082

111-
[ ![Screenshot shows the Gainsight User Management Authentication Page.](media/gainsight-tutorial/authentication.png "Authentication Page") ](media/gainsight-tutorial/authentication.png#lightbox)
83+
![Screenshot shows the Gainsight User Management Authentication Page.](media/gainsight-tutorial/authentication.png "Authentication Page")
11284

11385
1. In the **SAML Mechanism** page, perform the following steps:
11486

@@ -120,17 +92,47 @@ Complete the following steps to enable Azure AD single sign-on in the Azure port
12092
1. In the **Sign Out URL** textbox, paste the **Logout URL** value, which you have copied from the Azure portal.
12193
1. Open the downloaded **Certificate (Base64)** from the Azure portal and upload it into the **Certificate** by clicking **Browse** option.
12294
1. Click **Save**.
95+
1. Reopen the new **SAML** Authentication and click on edit on the newly created connection, and download the **metadata**. Open the **metadata** file in your favorite Editor, and copy **entityID** and **Assertion Consumer Service Location URL**.
12396

12497
> [!Note]
12598
> For more information on SAML creation, please refer [GAINSIGHT SAML](https://support.gainsight.com/Gainsight_NXT/01Onboarding_and_Implementation/Onboarding_for_Gainsight_NXT/Login_and_Permissions/03Gainsight_Authentication).
12699
100+
1. Now back to Azure portal, On the **Set up single sign-on with SAML** page, select the pencil icon for **Basic SAML Configuration** to edit the settings.
101+
102+
![Screenshot shows how to edit Basic SAML Configuration.](common/edit-urls.png "Basic Configuration")
103+
104+
1. On the **Basic SAML Configuration** section, using the values obtained in the Step 4, perform the following steps:
105+
106+
a. In the **Identifier (Entity ID)** textbox, type a value using one of the following patterns:
107+
108+
| **Identifier** |
109+
| ------------- |
110+
| `urn:auth0:gainsight:<ID>` |
111+
| `urn:auth0:gainsight-eu:<ID>` |
112+
113+
b. In the **Reply URL (Assertion Consumer Service URL)** textbox, type a URL using one of the following patterns:
114+
115+
| **Reply URL** |
116+
| ------------- |
117+
| `https://secured.gainsightcloud.com/login/callback connection=<ID>` |
118+
| `https://secured.eu.gainsightcloud.com/login/callback?connection=<ID>` |
119+
120+
1. Perform the following step, if you wish to configure the application in **SP** initiated mode:
121+
122+
In the **Sign on URL** textbox, type a URL using one of the following patterns:
123+
124+
| **Sign on URL** |
125+
|------------|
126+
| `https://secured.gainsightcloud.com/samlp/<ID>` |
127+
| `https://secured.eu.gainsightcloud.com/samlp/<ID>` |
128+
127129
## Create Gainsight test user
128130

129131
1. In a different web browser window, sign in to your Gainsight website as an administrator.
130132

131133
1. In the **User Management** page, navigate to **Users** > **Add User**.
132134

133-
[ ![Screenshot shows how to add users in Gainsight.](media/gainsight-tutorial/user.png "Add Users") ](media/gainsight-tutorial/user.png#lightbox)
135+
![Screenshot shows how to add users in Gainsight.](media/gainsight-tutorial/user.png "Add Users")
134136

135137
1. Fill required fields and click **Save**. Users must be created and activated before you use single sign-on.
136138

0 commit comments

Comments
 (0)