You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/active-directory/saas-apps/smartsheet-provisioning-tutorial.md
+42-40Lines changed: 42 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,15 +2,18 @@
2
2
title: 'Tutorial: Configure Smartsheet for automatic user provisioning with Azure Active Directory | Microsoft Docs'
3
3
description: Learn how to configure Azure Active Directory to automatically provision and de-provision user accounts to Smartsheet.
4
4
services: active-directory
5
+
documentationcenter: ''
5
6
author: twimmers
6
-
writer: twimmers
7
-
manager: CelesteDG
7
+
writer: Thwimmer
8
+
manager: beatrizd
9
+
ms.assetid: 9d391bd3-b0d3-4c7d-af8a-70bc0a538706
8
10
ms.service: active-directory
9
11
ms.subservice: saas-app-tutorial
10
12
ms.workload: identity
13
+
ms.devlang: na
11
14
ms.topic: tutorial
12
15
ms.date: 06/07/2019
13
-
ms.author: jeedes
16
+
ms.author: Thwimmer
14
17
---
15
18
16
19
# Tutorial: Configure Smartsheet for automatic user provisioning
@@ -36,45 +39,44 @@ The scenario outlined in this tutorial assumes that you already have the followi
36
39
* A user account in Azure AD with [permission](../roles/permissions-reference.md) to configure provisioning (e.g. Application Administrator, Cloud Application administrator, Application Owner, or Global Administrator).
56
60
57
-
3. Add and validate the email domains for the users that you plan to provision from Azure AD to Smartsheet. Choose **Not Enabled** to ensure that all provisioning actions only originate from Azure AD, and to also ensure that your Smartsheet user list is in sync with Azure AD assignments.
61
+
1. Navigate to **Menu > Settings > Domains & User Auto-Provisioning**.
58
62
59
-
63
+
60
64
61
-
4. Once validation is complete, you will have to activate the domain.
65
+
1. To add a new domain click on **Add Domain** and follow instructions.Once the domain is added make sure it gets verified as well.
5. Generate the **Secret Token** required to configure automatic user provisioning with Azure AD by navigating to **Apps and Integrations**.
67
+
1. Generate the **Secret Token** required to configure automatic user provisioning with Azure AD by navigating to **Apps and Integrations**.
66
68
67
69
68
70
69
-
6. Choose **API Access**. Click **Generate new access token**.
71
+
1. Choose **API Access**. Click **Generate new access token**.
70
72
71
73
72
74
73
-
7. Define the name of the API Access Token. Click **OK**.
75
+
1. Define the name of the API Access Token. Click **OK**.
74
76
75
77
76
78
77
-
8. Copy the API Access Token and save it as this will be the only time you can view it. This is required in the **Secret Token** field in Azure AD.
79
+
1. Copy the API Access Token and save it as this will be the only time you can view it. This is required in the **Secret Token** field in Azure AD.
108
110
109
-
2. In the applications list, select **Smartsheet**.
111
+
1. In the applications list, select **Smartsheet**.
110
112
111
-
113
+
112
114
113
-
3. Select the **Provisioning** tab.
115
+
1. Select the **Provisioning** tab.
114
116
115
117
116
118
117
-
4. Set the **Provisioning Mode** to **Automatic**.
119
+
1. Set the **Provisioning Mode** to **Automatic**.
118
120
119
121
120
122
121
-
5. Under the **Admin Credentials** section, input the **SCIM 2.0 base URL** of `https://scim.smartsheet.com/v2` and **Access Token** value retrieved earlier from Smartsheet in **Secret Token** respectively. Click **Test Connection** to ensure Azure AD can connect to Smartsheet. If the connection fails, ensure your Smartsheet account has SysAdmin permissions and try again.
123
+
1. Under the **Admin Credentials** section, input the **SCIM 2.0 base URL** of `https://scim.smartsheet.com/v2` and **Access Token** value retrieved earlier from Smartsheet in **Secret Token** respectively. Click **Test Connection** to ensure Azure AD can connect to Smartsheet. If the connection fails, ensure your Smartsheet account has SysAdmin permissions and try again.
124
126
125
-
6. In the **Notification Email** field, enter the email address of a person or group who should receive the provisioning error notifications and check the checkbox - **Send an email notification when a failure occurs**.
127
+
1. In the **Notification Email** field, enter the email address of a person or group who should receive the provisioning error notifications and check the checkbox - **Send an email notification when a failure occurs**.
128
130
129
-
7. Click **Save**.
131
+
1. Click **Save**.
130
132
131
-
8. Under the **Mappings** section, select **Synchronize Azure Active Directory Users to Smartsheet**.
133
+
1. Under the **Mappings** section, select **Synchronize Azure Active Directory Users to Smartsheet**.
132
134
133
-
9. Review the user attributes that are synchronized from Azure AD to Smartsheet in the **Attribute Mapping** section. The attributes selected as **Matching** properties are used to match the user accounts in Smartsheet for update operations. Select the **Save** button to commit any changes.
135
+
1. Review the user attributes that are synchronized from Azure AD to Smartsheet in the **Attribute Mapping** section. The attributes selected as **Matching** properties are used to match the user accounts in Smartsheet for update operations. Select the **Save** button to commit any changes.
134
136
135
137
|Attribute|Type|Supported for filtering|
136
138
|---|---|---|
@@ -151,28 +153,28 @@ This section guides you through the steps to configure the Azure AD provisioning
10. To configure scoping filters, refer to the following instructions provided in the [Scoping filter tutorial](../app-provisioning/define-conditional-rules-for-provisioning-user-accounts.md).
156
+
1. To configure scoping filters, refer to the following instructions provided in the [Scoping filter tutorial](../app-provisioning/define-conditional-rules-for-provisioning-user-accounts.md).
155
157
156
-
11. To enable the Azure AD provisioning service for Smartsheet, change the **Provisioning Status** to **On** in the **Settings** section.
158
+
1. To enable the Azure AD provisioning service for Smartsheet, change the **Provisioning Status** to **On** in the **Settings** section.
157
159
158
-
160
+
159
161
160
-
12. Define the users and/or groups that you would like to provision to Smartsheet by choosing the desired values in **Scope** in the **Settings** section.
162
+
1. Define the users and/or groups that you would like to provision to Smartsheet by choosing the desired values in **Scope** in the **Settings** section.
167
169
168
170
This operation starts the initial synchronization of all users and/or groups defined in **Scope** in the **Settings** section. The initial sync takes longer to perform than subsequent syncs, which occur approximately every 40 minutes as long as the Azure AD provisioning service is running.
169
171
170
172
## Step 6. Monitor your deployment
171
173
Once you've configured provisioning, use the following resources to monitor your deployment:
172
174
173
-
1. Use the [provisioning logs](../reports-monitoring/concept-provisioning-logs.md) to determine which users have been provisioned successfully or unsuccessfully
174
-
2. Check the [progress bar](../app-provisioning/application-provisioning-when-will-provisioning-finish-specific-user.md) to see the status of the provisioning cycle and how close it is to completion
175
-
3. If the provisioning configuration seems to be in an unhealthy state, the application will go into quarantine. Learn more about quarantine states [here](../app-provisioning/application-provisioning-quarantine-status.md).
175
+
* Use the [provisioning logs](../reports-monitoring/concept-provisioning-logs.md) to determine which users have been provisioned successfully or unsuccessfully
176
+
* Check the [progress bar](../app-provisioning/application-provisioning-when-will-provisioning-finish-specific-user.md) to see the status of the provisioning cycle and how close it is to completion
177
+
* If the provisioning configuration seems to be in an unhealthy state, the application will go into quarantine. Learn more about quarantine states [here](../app-provisioning/application-provisioning-quarantine-status.md).
0 commit comments