Skip to content

Commit 6db2464

Browse files
authored
Merge pull request #78548 from v-nagta/udruva
Product Backlog Item 734672: SaaS App Tutorial: Druva update
2 parents c742470 + e18df0a commit 6db2464

File tree

1 file changed

+84
-148
lines changed

1 file changed

+84
-148
lines changed

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

Lines changed: 84 additions & 148 deletions
Original file line numberDiff line numberDiff line change
@@ -13,120 +13,86 @@ ms.workload: identity
1313
ms.tgt_pltfrm: na
1414
ms.devlang: na
1515
ms.topic: tutorial
16-
ms.date: 02/04/2019
16+
ms.date: 06/03/2019
1717
ms.author: jeedes
1818

1919
ms.collection: M365-identity-device-management
2020
---
21-
# Tutorial: Azure Active Directory integration with Druva
2221

23-
In this tutorial, you learn how to integrate Druva with Azure Active Directory (Azure AD).
24-
Integrating Druva with Azure AD provides you with the following benefits:
22+
# Tutorial: Integrate Druva with Azure Active Directory
2523

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

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.
26+
* Control in Azure AD who has access to Druva.
27+
* Enable your users to be automatically signed-in to Druva with their Azure AD accounts.
28+
* Manage your accounts in one central location - the Azure portal.
29+
30+
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).
3231

3332
## Prerequisites
3433

35-
To configure Azure AD integration with Druva, you need the following items:
34+
To get started, you need the following items:
3635

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-
* Druva single sign-on enabled subscription
36+
* An Azure AD subscription. If you don't have a subscription, you can get one-month free trial [here](https://azure.microsoft.com/pricing/free-trial/).
37+
* Druva single sign-on (SSO) enabled subscription.
3938

4039
## Scenario description
4140

42-
In this tutorial, you configure and test Azure AD single sign-on in a test environment.
43-
44-
* Druva supports **SP** and **IDP** initiated SSO
41+
In this tutorial, you configure and test Azure AD SSO in a test environment. Druva supports **SP** and **IDP** initiated SSO
4542

4643
## Adding Druva from the gallery
4744

4845
To configure the integration of Druva into Azure AD, you need to add Druva from the gallery to your list of managed SaaS apps.
4946

50-
**To add Druva 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 **Druva**, select **Druva** from result panel then click **Add** button to add the application.
65-
66-
![Druva in the results list](common/search-new-app.png)
47+
1. Sign in to the [Azure portal](https://portal.azure.com) using either a work or school account, or a personal Microsoft account.
48+
1. On the left navigation pane, select the **Azure Active Directory** service.
49+
1. Navigate to **Enterprise Applications** and then select **All Applications**.
50+
1. To add new application, select **New application**.
51+
1. In the **Add from the gallery** section, type **Druva** in the search box.
52+
1. Select **Druva** from results panel and then add the app. Wait a few seconds while the app is added to your tenant.
6753

6854
## Configure and test Azure AD single sign-on
6955

70-
In this section, you configure and test Azure AD single sign-on with Druva 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 Druva needs to be established.
56+
Configure and test Azure AD SSO with Druva using a test user called **Britta Simon**. For SSO to work, you need to establish a link relationship between an Azure AD user and the related user in Druva.
7257

73-
To configure and test Azure AD single sign-on with Druva, you need to complete the following building blocks:
58+
To configure and test Azure AD SSO with Druva, complete the following building blocks:
7459

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 Druva Single Sign-On](#configure-druva-single-sign-on)** - to configure the Single Sign-On settings on application side.
60+
1. **[Configure Azure AD SSO](#configure-azure-ad-sso)** - to enable your users to use this feature.
61+
2. **[Configure Druva SSO](#configure-druva-sso)** - to configure the Single Sign-On settings on application side.
7762
3. **[Create an Azure AD test user](#create-an-azure-ad-test-user)** - to test Azure AD single sign-on with Britta Simon.
7863
4. **[Assign the Azure AD test user](#assign-the-azure-ad-test-user)** - to enable Britta Simon to use Azure AD single sign-on.
7964
5. **[Create Druva test user](#create-druva-test-user)** - to have a counterpart of Britta Simon in Druva 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.
81-
82-
### Configure Azure AD single sign-on
83-
84-
In this section, you enable Azure AD single sign-on in the Azure portal.
85-
86-
To configure Azure AD single sign-on with Druva, perform the following steps:
65+
6. **[Test SSO](#test-sso)** - to verify whether the configuration works.
8766

88-
1. In the [Azure portal](https://portal.azure.com/), on the **Druva** application integration page, select **Single sign-on**.
67+
### Configure Azure AD SSO
8968

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

92-
2. On the **Select a Single sign-on method** dialog, select **SAML/WS-Fed** mode to enable single sign-on.
71+
1. In the [Azure portal](https://portal.azure.com/), on the **Druva** application integration page, find the **Manage** section and select **Single sign-on**.
72+
1. On the **Select a Single sign-on method** page, select **SAML**.
73+
1. On the **Set up Single Sign-On with SAML** page, click the edit/pen icon for **Basic SAML Configuration** to edit the settings.
9374

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

96-
3. On the **Set up Single Sign-On with SAML** page, click **Edit** icon to open **Basic SAML Configuration** dialog.
77+
1. On the **Basic SAML Configuration** section, If you wish to configure the application in **IDP** initiated mode, the user does not have to perform any step as the app is already pre-integrated with Azure.
9778

98-
![Edit Basic SAML Configuration](common/edit-urls.png)
99-
100-
4. On the **Basic SAML Configuration** section, If you wish to configure the application in **IDP** initiated mode, perform the following step:
101-
102-
![Druva Domain and URLs single sign-on information](common/idp-identifier.png)
103-
104-
In the **Identifier** text box, type a string value:
105-
`druva-cloud`
106-
107-
5. Click **Set additional URLs** and perform the following step if you wish to configure the application in **SP** initiated mode:
108-
109-
![image](common/both-preintegrated-signon.png)
79+
1. Click **Set additional URLs** and perform the following step if you wish to configure the application in **SP** initiated mode:
11080

11181
In the **Sign-on URL** text box, type a URL:
112-
`https://cloud.druva.com/home`
82+
`https://login.druva.com/login`
11383

114-
6. Druva 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.
84+
1. Druva 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.
11585

11686
![image](common/edit-attribute.png)
11787

118-
7. 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:
88+
1. 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:
11989

12090
| Name | Source Attribute|
12191
| ------------------- | -------------------- |
12292
| insync\_auth\_token |Enter the token generated value |
12393

12494
a. Click **Add new claim** to open the **Manage user claims** dialog.
12595

126-
![image](common/new-save-attribute.png)
127-
128-
![image](common/new-attribute-details.png)
129-
13096
b. In the **Name** textbox, type the attribute name shown for that row.
13197

13298
c. Leave the **Namespace** blank.
@@ -139,137 +105,108 @@ To configure Azure AD single sign-on with Druva, perform the following steps:
139105

140106
g. Click **Save**.
141107

142-
8. 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.
108+
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.
143109

144-
![The Certificate download link](common/certificatebase64.png)
110+
![The Certificate download link](common/certificatebase64.png)
145111

146-
9. On the **Set up Druva** section, copy the appropriate URL(s) as per your requirement.
112+
1. On the **Set up Druva** section, copy the appropriate URL(s) based on your requirement.
147113

148-
![Copy configuration URLs](common/copy-configuration-urls.png)
114+
![Copy configuration URLs](common/copy-configuration-urls.png)
149115

150-
a. Login URL
116+
### Configure Druva SSO
151117

152-
b. Azure Ad Identifier
118+
1. In a different web browser window, sign in to your Druva company site as an administrator.
153119

154-
c. Logout URL
155-
156-
### Configure Druva Single Sign-On
157-
158-
1. In a different web browser window, log in to your Druva company site as an administrator.
159-
160-
2. Go to **Manage \> Settings**.
120+
1. Go to **Manage \> Settings**.
161121

162122
![Settings](./media/druva-tutorial/ic795091.png "Settings")
163123

164-
3. On the Single Sign-On Settings dialog, perform the following steps:
124+
1. On the Single Sign-On Settings dialog, perform the following steps:
165125

166126
![Single Sign-On Settings](./media/druva-tutorial/ic795092.png "Single Sign-On Settings")
167-
127+
168128
a. In **ID Provider Login URL** textbox, paste the value of **Login URL**, which you have copied from Azure portal.
169-
129+
170130
b. In **ID Provider Logout URL** textbox, paste the value of **Logout URL**, which you have copied from Azure portal
171-
131+
172132
c. Open your base-64 encoded certificate in notepad, copy the content of it into your clipboard, and then paste it to the **ID Provider Certificate** textbox
173-
133+
174134
d. To open the **Settings** page, click **Save**.
175135

176-
4. On the **Settings** page, click **Generate SSO Token**.
136+
1. On the **Settings** page, click **Generate SSO Token**.
177137

178138
![Settings](./media/druva-tutorial/ic795093.png "Settings")
179139

180-
5. On the **Single Sign-on Authentication Token** dialog, perform the following steps:
140+
1. On the **Single Sign-on Authentication Token** dialog, perform the following steps:
181141

182142
![SSO Token](./media/druva-tutorial/ic795094.png "SSO Token")
183-
184-
a. Click **Copy**, Paste copied value in the **Value** textbox in the **Add Attribute** section in the Azure portal.
185-
186-
b. Click **Close**.
187-
188-
### Create an Azure AD test user
189-
190-
The objective of this section is to create a test user in the Azure portal called Britta Simon.
191-
192-
1. In the Azure portal, in the left pane, select **Azure Active Directory**, select **Users**, and then select **All users**.
193-
194-
![The "Users and groups" and "All users" links](common/users.png)
195143

196-
2. Select **New user** at the top of the screen.
197-
198-
![New user Button](common/new-user.png)
199-
200-
3. In the User properties, perform the following steps.
144+
a. Click **Copy**, Paste copied value in the **Value** textbox in the **Add Attribute** section in the Azure portal.
201145

202-
![The User dialog box](common/user-properties.png)
146+
b. Click **Close**.
203147

204-
a. In the **Name** field enter **BrittaSimon**.
205-
206-
b. In the **User name** field type **brittasimon\@yourcompanydomain.extension**
207-
For example, [email protected]
148+
### Create an Azure AD test user
208149

209-
c. Select **Show password** check box, and then write down the value that's displayed in the Password box.
150+
In this section, you'll create a test user in the Azure portal called Britta Simon.
210151

211-
d. Click **Create**.
152+
1. From the left pane in the Azure portal, select **Azure Active Directory**, select **Users**, and then select **All users**.
153+
1. Select **New user** at the top of the screen.
154+
1. In the **User** properties, follow these steps:
155+
1. In the **Name** field, enter `Britta Simon`.
156+
1. In the **User name** field, enter the [email protected]. For example, `[email protected]`.
157+
1. Select the **Show password** check box, and then write down the value that's displayed in the **Password** box.
158+
1. Click **Create**.
212159

213160
### Assign the Azure AD test user
214161

215-
In this section, you enable Britta Simon to use Azure single sign-on by granting access to Druva.
216-
217-
1. In the Azure portal, select **Enterprise Applications**, select **All applications**, then select **Druva**.
218-
219-
![Enterprise applications blade](common/enterprise-applications.png)
162+
In this section, you'll enable Britta Simon to use Azure single sign-on by granting access to Druva.
220163

221-
2. In the applications list, select **Druva**.
164+
1. In the Azure portal, select **Enterprise Applications**, and then select **All applications**.
165+
1. In the applications list, select **Druva**.
166+
1. In the app's overview page, find the **Manage** section and select **Users and groups**.
222167

223-
![The Druva link in the Applications list](common/all-applications.png)
168+
![The "Users and groups" link](common/users-groups-blade.png)
224169

225-
3. In the menu on the left, select **Users and groups**.
170+
1. Select **Add user**, then select **Users and groups** in the **Add Assignment** dialog.
226171

227-
![The "Users and groups" link](common/users-groups-blade.png)
172+
![The Add User link](common/add-assign-user.png)
228173

229-
4. Click the **Add user** button, then select **Users and groups** in the **Add Assignment** dialog.
230-
231-
![The Add Assignment pane](common/add-assign-user.png)
232-
233-
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.
234-
235-
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.
236-
237-
7. In the **Add Assignment** dialog click the **Assign** button.
174+
1. In the **Users and groups** dialog, select **Britta Simon** from the Users list, then click the **Select** button at the bottom of the screen.
175+
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.
176+
1. In the **Add Assignment** dialog, click the **Assign** button.
238177

239178
### Create Druva test user
240179

241-
In order to enable Azure AD users to log in to Druva, they must be provisioned into Druva. In the case of Druva, provisioning is a manual task.
180+
In order to enable Azure AD users to sign in to Druva, they must be provisioned into Druva. In the case of Druva, provisioning is a manual task.
242181

243182
**To configure user provisioning, perform the following steps:**
244183

245-
1. Log in to your **Druva** company site as administrator.
184+
1. Sign in to your **Druva** company site as administrator.
185+
186+
1. Go to **Manage \> Users**.
246187

247-
2. Go to **Manage \> Users**.
248-
249188
![Manage Users](./media/druva-tutorial/ic795097.png "Manage Users")
250189

251-
3. Click **Create New**.
252-
190+
1. Click **Create New**.
191+
253192
![Manage Users](./media/druva-tutorial/ic795098.png "Manage Users")
254193

255-
4. On the Create New User dialog, perform the following steps:
256-
194+
1. On the Create New User dialog, perform the following steps:
195+
257196
![Create NewUser](./media/druva-tutorial/ic795099.png "Create NewUser")
258-
197+
259198
a. In the **Email address** textbox, enter the email of user like **brittasimon\@contoso.com**.
260-
199+
261200
b. In the **Name** textbox, enter the name of user like **BrittaSimon**.
262-
263-
c. Click **Create User**.
264201

265-
>[!NOTE]
266-
>You can use any other Druva user account creation tools or APIs provided by Druva to provision Azure AD user accounts.
202+
c. Click **Create User**.
267203

268-
### Test single sign-on
204+
> [!NOTE]
205+
> You can use any other Druva user account creation tools or APIs provided by Druva to provision Azure AD user accounts.
269206
270-
In this section, you test your Azure AD single sign-on configuration using the Access Panel.
207+
### Test SSO
271208

272-
When you click the Druva tile in the Access Panel, you should be automatically signed in to the Druva 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).
209+
When you select the Druva tile in the Access Panel, you should be automatically signed in to the Druva 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).
273210

274211
## Additional Resources
275212

@@ -278,4 +215,3 @@ When you click the Druva tile in the Access Panel, you should be automatically s
278215
- [What is application access and single sign-on with Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/active-directory-appssoaccess-whatis)
279216

280217
- [What is conditional access in Azure Active Directory?](https://docs.microsoft.com/azure/active-directory/conditional-access/overview)
281-

0 commit comments

Comments
 (0)