|
| 1 | +--- |
| 2 | +title: 'Tutorial: Configure MindTickle for automatic user provisioning with Azure Active Directory | Microsoft Docs' |
| 3 | +description: Learn how to configure Azure Active Directory to automatically provision and de-provision user accounts to MindTickle. |
| 4 | +services: active-directory |
| 5 | +documentationcenter: '' |
| 6 | +author: zchia |
| 7 | +writer: zchia |
| 8 | +manager: beatrizd |
| 9 | + |
| 10 | +ms.assetid: fb48deae-4653-448a-ba2f-90258edab3a7 |
| 11 | +ms.service: active-directory |
| 12 | +ms.subservice: saas-app-tutorial |
| 13 | +ms.workload: identity |
| 14 | +ms.tgt_pltfrm: na |
| 15 | +ms.devlang: na |
| 16 | +ms.topic: article |
| 17 | +ms.date: 07/23/2019 |
| 18 | +ms.author: Zhchia |
| 19 | +--- |
| 20 | + |
| 21 | +# Tutorial: Configure MindTickle for automatic user provisioning |
| 22 | + |
| 23 | +The objective of this tutorial is to demonstrate the steps to be performed in MindTickle and Azure Active Directory (Azure AD) to configure Azure AD to automatically provision and de-provision users and/or groups to MindTickle. |
| 24 | + |
| 25 | +> [!NOTE] |
| 26 | +> This tutorial describes a connector built on top of the Azure AD User Provisioning Service. For important details on what this service does, how it works, and frequently asked questions, see [Automate user provisioning and deprovisioning to SaaS applications with Azure Active Directory](../manage-apps/user-provisioning.md). |
| 27 | +> |
| 28 | +> This connector is currently in Public Preview. For more information on the general Microsoft Azure terms of use for Preview features, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/). |
| 29 | +
|
| 30 | +## Prerequisites |
| 31 | + |
| 32 | +The scenario outlined in this tutorial assumes that you already have the following prerequisites: |
| 33 | + |
| 34 | +* An Azure AD tenant |
| 35 | +* [A MindTickle tenant](https://www.mindtickle.com/) |
| 36 | +* A user account in MindTickle with Admin permissions. |
| 37 | + |
| 38 | +## Assigning users to MindTickle |
| 39 | + |
| 40 | +Azure Active Directory uses a concept called *assignments* to determine which users should receive access to selected apps. In the context of automatic user provisioning, only the users and/or groups that have been assigned to an application in Azure AD are synchronized. |
| 41 | + |
| 42 | +Before configuring and enabling automatic user provisioning, you should decide which users and/or groups in Azure AD need access to MindTickle. Once decided, you can assign these users and/or groups to MindTickle by following the instructions here: |
| 43 | +* [Assign a user or group to an enterprise app](../manage-apps/assign-user-or-group-access-portal.md) |
| 44 | + |
| 45 | +## Important tips for assigning users to MindTickle |
| 46 | + |
| 47 | +* It is recommended that a single Azure AD user is assigned to MindTickle to test the automatic user provisioning configuration. Additional users and/or groups may be assigned later. |
| 48 | + |
| 49 | +* When assigning a user to MindTickle, you must select any valid application-specific role (if available) in the assignment dialog. Users with the **Default Access** role are excluded from provisioning. |
| 50 | + |
| 51 | +## Setup MindTickle for provisioning |
| 52 | + |
| 53 | +Before configuring MindTickle for automatic user provisioning with Azure AD, you will need to enable SCIM provisioning on MindTickle. |
| 54 | + |
| 55 | + |
| 56 | +1. Reach out to the [MindTickle's support team](mailto:help@mindtickle.com) to obtain the JWT token needed to configure SCIM provisioning. |
| 57 | + |
| 58 | + |
| 59 | +## Add MindTickle from the gallery |
| 60 | + |
| 61 | +To configure MindTickle for automatic user provisioning with Azure AD, you need to add MindTickle from the Azure AD application gallery to your list of managed SaaS applications. |
| 62 | + |
| 63 | +**To add MindTickle from the Azure AD application gallery, perform the following steps:** |
| 64 | + |
| 65 | +1. In the **[Azure portal](https://portal.azure.com)**, in the left navigation panel, select **Azure Active Directory**. |
| 66 | + |
| 67 | +  |
| 68 | + |
| 69 | +2. Go to **Enterprise applications**, and then select **All applications**. |
| 70 | + |
| 71 | +  |
| 72 | + |
| 73 | +3. To add a new application, select the **New application** button at the top of the pane. |
| 74 | + |
| 75 | +  |
| 76 | + |
| 77 | +4. In the search box, enter **MindTickle**, select **MindTickle** in the results panel, and then click the **Add** button to add the application. |
| 78 | + |
| 79 | +  |
| 80 | + |
| 81 | +## Configuring automatic user provisioning to MindTickle |
| 82 | + |
| 83 | +This section guides you through the steps to configure the Azure AD provisioning service to create, update, and disable users and/or groups in MindTickle based on user and/or group assignments in Azure AD. |
| 84 | + |
| 85 | +> [!TIP] |
| 86 | +> You may also choose to enable SAML-based single sign-on for MindTickle , following the instructions provided in the [MindTickle Single sign-on tutorial](mindtickle-tutorial.md). Single sign-on can be configured independently of automatic user provisioning, though these two features compliment each other |
| 87 | +
|
| 88 | +### To configure automatic user provisioning for MindTickle in Azure AD: |
| 89 | + |
| 90 | +1. Sign in to the [Azure portal](https://portal.azure.com). Select **Enterprise Applications**, then select **All applications**. |
| 91 | + |
| 92 | +  |
| 93 | + |
| 94 | +2. In the applications list, select **MindTickle**. |
| 95 | + |
| 96 | +  |
| 97 | + |
| 98 | +3. Select the **Provisioning** tab. |
| 99 | + |
| 100 | +  |
| 101 | + |
| 102 | +4. Set the **Provisioning Mode** to **Automatic**. |
| 103 | + |
| 104 | +  |
| 105 | + |
| 106 | +5. Under the **Admin Credentials** section, input `https://admin.mindtickle.com/scim` in **Tenant URL**. Input the **JWT token** value retrieved earlier In Secret Token textbox, enter the **JWT token** value which was given by MindTickle support team. Click **Test Connection** to ensure Azure AD can connect to myPolicies. If the connection fails, ensure your MindTickle account has Admin permissions and try again. |
| 107 | + |
| 108 | +  |
| 109 | + |
| 110 | +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**. |
| 111 | + |
| 112 | +  |
| 113 | + |
| 114 | +7. Click **Save**. |
| 115 | + |
| 116 | +8. Under the **Mappings** section, select **Synchronize Azure Active Directory Users to MindTickle**. |
| 117 | + |
| 118 | +  |
| 119 | + |
| 120 | +9. Review the user attributes that are synchronized from Azure AD to MindTickle in the **Attribute Mapping** section. The attributes selected as **Matching** properties are used to match the user accounts in MindTickle for update operations. Select the **Save** button to commit any changes. |
| 121 | + |
| 122 | +  |
| 123 | + |
| 124 | +12. To configure scoping filters, refer to the following instructions provided in the [Scoping filter tutorial](../manage-apps/define-conditional-rules-for-provisioning-user-accounts.md). |
| 125 | + |
| 126 | +13. To enable the Azure AD provisioning service for MindTickle, change the **Provisioning Status** to **On** in the **Settings** section. |
| 127 | + |
| 128 | +  |
| 129 | + |
| 130 | +14. Define the users and/or groups that you would like to provision to MindTickle by choosing the desired values in **Scope** in the **Settings** section. |
| 131 | + |
| 132 | +  |
| 133 | + |
| 134 | +15. When you are ready to provision, click **Save**. |
| 135 | + |
| 136 | +  |
| 137 | + |
| 138 | +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. For more information on how long it will take for users and/or groups to provision, see [How long will it take to provision users](../manage-apps/application-provisioning-when-will-provisioning-finish-specific-user.md#how-long-will-it-take-to-provision-users). |
| 139 | + |
| 140 | +You can use the **Current Status** section to monitor progress and follow links to your provisioning activity report, which describes all actions performed by the Azure AD provisioning service on MindTickle. For more information, see [Check the status of user provisioning](../manage-apps/application-provisioning-when-will-provisioning-finish-specific-user.md). To read the Azure AD provisioning logs, see [Reporting on automatic user account provisioning](../manage-apps/check-status-user-account-provisioning.md). |
| 141 | + |
| 142 | +## Additional resources |
| 143 | + |
| 144 | +* [Managing user account provisioning for Enterprise Apps](../manage-apps/configure-automatic-user-provisioning-portal.md) |
| 145 | +* [What is application access and single sign-on with Azure Active Directory?](../manage-apps/what-is-single-sign-on.md) |
0 commit comments