Skip to content

Commit 15bd1d2

Browse files
2 parents 75594e9 + 091454f commit 15bd1d2

File tree

4 files changed

+89
-79
lines changed

4 files changed

+89
-79
lines changed
3.44 KB
Loading
Lines changed: 68 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: 'Tutorial: Configure Zoom 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 Zoom.
3+
description: Learn how to automatically provision and de-provision user accounts from Azure AD to Zoom.
44
services: active-directory
55
documentationcenter: ''
66
author: zchia
@@ -14,70 +14,75 @@ ms.tgt_pltfrm: na
1414
ms.devlang: na
1515
ms.topic: article
1616
ms.date: 06/3/2019
17-
ms.author: "jeedes"
17+
ms.author: Zhchia
1818
---
1919

2020
# Tutorial: Configure Zoom for automatic user provisioning
2121

22-
The objective of this tutorial is to demonstrate the steps to be performed in Zoom and Azure Active Directory (Azure AD) to configure Azure AD to automatically provision and de-provision users and/or groups to Zoom.
22+
This tutorial describes the steps you need to perform in both Zoom and Azure Active Directory (Azure AD) to configure automatic user provisioning. When configured, Azure AD automatically provisions and de-provisions users and groups to [Zoom](https://zoom.us/pricing/) using the Azure AD 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).
2323

24-
> [!NOTE]
25-
> 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](../app-provisioning/user-provisioning.md).
26-
>
27-
> 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/).
24+
25+
## Capabilities supported
26+
> [!div class="checklist"]
27+
> * Create users in Zoom
28+
> * Remove users in Zoom when they do not require access anymore
29+
> * Keep user attributes synchronized between Azure AD and Zoom
30+
> * [Single sign-on](https://docs.microsoft.com/azure/active-directory/saas-apps/zoom-tutorial) to Zoom (recommended)
2831
2932
## Prerequisites
3033

3134
The scenario outlined in this tutorial assumes that you already have the following prerequisites:
3235

33-
* An Azure AD tenant
34-
* [A Zoom tenant](https://zoom.us/pricing)
35-
* A user account in Zoom with Admin permissions
36-
37-
## Add Zoom from the gallery
36+
* [An Azure AD tenant](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant).
37+
* A user account in Azure AD with [permission](https://docs.microsoft.com/azure/active-directory/users-groups-roles/directory-assign-admin-roles) to configure provisioning (e.g. Application Administrator, Cloud Application administrator, Application Owner, or Global Administrator).
38+
* [A Zoom tenant](https://zoom.us/pricing).
39+
* A user account in Zoom with Admin permissions.
3840

39-
Before configuring Zoom for automatic user provisioning with Azure AD, you need to add Zoom from the Azure AD application gallery to your list of managed SaaS applications.
41+
## Step 1. Plan your provisioning deployment
42+
1. Learn about [how the provisioning service works](https://docs.microsoft.com/azure/active-directory/manage-apps/user-provisioning).
43+
2. Determine who will be in [scope for provisioning](https://docs.microsoft.com/azure/active-directory/manage-apps/define-conditional-rules-for-provisioning-user-accounts).
44+
3. Determine what data to [map between Azure AD and Zoom](https://docs.microsoft.com/azure/active-directory/manage-apps/customize-application-attributes).
4045

41-
**To add Zoom from the Azure AD application gallery, perform the following steps:**
46+
## Step 2. Configure Zoom to support provisioning with Azure AD
4247

43-
1. In the **[Azure portal](https://portal.azure.com)**, in the left navigation panel, select **Azure Active Directory**.
48+
1. Sign in to your [Zoom Admin Console](https://zoom.us/signin). Navigate to **Advanced > Zoom for Developers** in the left navigation pane.
4449

45-
![The Azure Active Directory button](common/select-azuread.png)
50+
![Zoom Integrations](media/zoom-provisioning-tutorial/zoom01.png)
4651

47-
2. Go to **Enterprise applications**, and then select **All applications**.
52+
2. Navigate to **Manage** in the top-right corner of the page.
4853

49-
![The Enterprise applications blade](common/enterprise-applications.png)
54+
![Zoom Install](media/zoom-provisioning-tutorial/zoom02.png)
5055

51-
3. To add a new application, select the **New application** button at the top of the pane.
56+
3. Navigate to your created Azure AD app.
57+
58+
![Zoom App](media/zoom-provisioning-tutorial/zoom03.png)
5259

53-
![The New application button](common/add-new-app.png)
60+
4. Select **App Credentials** in the left navigation pane.
5461

55-
4. In the search box, enter **Zoom**, select **Zoom** in the results panel, and then click the **Add** button to add the application.
62+
![Zoom App](media/zoom-provisioning-tutorial/zoom04.png)
5663

57-
![Zoom in the results list](common/search-new-app.png)
64+
5. Copy and save the **JWT Token**. This value will be entered in the **Secret Token** field in the Provisioning tab of your Zoom application in the Azure portal. If you need a new non-expiring token, you will need to reconfigure the expiration time which will auto generate a new token.
5865

59-
## Assign users to Zoom
66+
![Zoom Install](media/zoom-provisioning-tutorial/zoom05.png)
6067

61-
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.
68+
## Step 3. Add Zoom from the Azure AD application gallery
6269

63-
Before configuring and enabling automatic user provisioning, you should decide which users and/or groups in Azure AD need access to Zoom. Once decided, you can assign these users and/or groups to Zoom by following the instructions here:
70+
Add Zoom from the Azure AD application gallery to start managing provisioning to Zoom. If you have previously setup Zoom for SSO you can use the same application. However it is recommended that you create a separate app when testing out the integration initially. Learn more about adding an application from the gallery [here](https://docs.microsoft.com/azure/active-directory/manage-apps/add-gallery-app).
6471

65-
* [Assign a user or group to an enterprise app](../manage-apps/assign-user-or-group-access-portal.md)
72+
## Step 4. Define who will be in scope for provisioning
6673

67-
### Important tips for assigning users to Zoom
74+
The Azure AD provisioning service allows you to scope who will be provisioned based on assignment to the application and or based on attributes of the user / group. If you choose to scope who will be provisioned to your app based on assignment, you can use the following [steps](../manage-apps/assign-user-or-group-access-portal.md) to assign users and groups to the application. If you choose to scope who will be provisioned based solely on attributes of the user or group, you can use a scoping filter as described [here](https://docs.microsoft.com/azure/active-directory/manage-apps/define-conditional-rules-for-provisioning-user-accounts).
6875

69-
* It is recommended that a single Azure AD user is assigned to Zoom to test the automatic user provisioning configuration. Additional users and/or groups may be assigned later.
76+
* When assigning users and groups to Zoom, you must select a role other than **Default Access**. Users with the Default Access role are excluded from provisioning and will be marked as not effectively entitled in the provisioning logs. If the only role available on the application is the default access role, you can [update the application manifest](https://docs.microsoft.com/azure/active-directory/develop/howto-add-app-roles-in-azure-ad-apps) to add additional roles.
7077

71-
* When assigning a user to Zoom, you must select any valid application-specific role (if available) in the assignment dialog. Users with the **Default Access** role are excluded from provisioning.
78+
* Start small. Test with a small set of users and groups before rolling out to everyone. When scope for provisioning is set to assigned users and groups, you can control this by assigning one or two users or groups to the app. When scope is set to all users and groups, you can specify an [attribute based scoping filter](https://docs.microsoft.com/azure/active-directory/manage-apps/define-conditional-rules-for-provisioning-user-accounts).
7279

73-
## Configure automatic user provisioning to Zoom
7480

75-
This section guides you through the steps to configure the Azure AD provisioning service to create, update, and disable users or groups in Zoom based on user and/or group assignments in Azure AD.
81+
## Step 5. Configure automatic user provisioning to Zoom
7682

77-
> [!TIP]
78-
> You may also choose to enable SAML-based single sign-on for Zoom, following the instructions provided in the [Zoom single sign-on tutorial](zoom-tutorial.md). Single sign-on can be configured independently of automatic user provisioning, though these two features compliment each other.
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 TestApp based on user and/or group assignments in Azure AD.
7984

80-
### Configure automatic user provisioning for Zoom in Azure AD
85+
### To configure automatic user provisioning for Zoom in Azure AD:
8186

8287
1. Sign in to the [Azure portal](https://portal.azure.com). Select **Enterprise Applications**, then select **All applications**.
8388

@@ -95,73 +100,60 @@ This section guides you through the steps to configure the Azure AD provisioning
95100

96101
![Provisioning tab](common/provisioning-automatic.png)
97102

98-
5. Under the **Admin Credentials** section, enter `https://api.zoom.us/scim` in **Tenant URL**. To retrieve the **Secret Token** of your Zoom account, follow the walkthrough as described in Step 6.
99-
100-
6. Sign in to your [Zoom Admin Console](https://zoom.us/signin). Navigate to **Advanced > Zoom for Developers** in the left navigation pane.
101-
102-
![Zoom Integrations](media/zoom-provisioning-tutorial/zoom01.png)
103-
104-
Navigate to **Manage** in the top-right corner of the page.
105-
106-
![Zoom Install](media/zoom-provisioning-tutorial/zoom02.png)
107-
108-
Navigate to your created Azure AD app.
109-
110-
![Zoom App](media/zoom-provisioning-tutorial/zoom03.png)
111-
112-
Select **App Credentials** in the left navigation pane.
113-
114-
![Zoom App](media/zoom-provisioning-tutorial/zoom04.png)
115-
116-
Retrieve the JWT Token value shown below and input this into the **Secret Token** field in Azure AD. If you need a new non-expiring token, you will need to reconfigure the expiration time which will auto generate a new token.
103+
5. Under the **Admin Credentials** section, enter `https://api.zoom.us/scim` in **Tenant URL**. Input the **JWT Token** value retrieved earlier in **Secret Token**. Click **Test Connection** to ensure Azure AD can connect to Zoom. If the connection fails, ensure your Zoom account has Admin permissions and try again.
117104

118-
![Zoom Install](media/zoom-provisioning-tutorial/zoom05.png)
119-
120-
7. Upon populating the fields shown in Step 5, click **Test Connection** to ensure Azure AD can connect to Zoom. If the connection fails, ensure your Zoom account has Admin permissions and try again.
105+
![Zoom provisioning](./media/zoom-provisioning-tutorial/provisioning.png)
121106

122-
![Token](common/provisioning-testconnection-tenanturltoken.png)
123-
124-
8. 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**.
107+
6. In the **Notification Email** field, enter the email address of a person or group who should receive the provisioning error notifications and select the **Send an email notification when a failure occurs** check box.
125108

126109
![Notification Email](common/provisioning-notification-email.png)
127110

128-
9. Click **Save**.
111+
7. Select **Save**.
129112

130-
10. Under the **Mappings** section, select **Synchronize Azure Active Directory Users to Zoom**.
113+
8. Under the **Mappings** section, select **Synchronize Azure Active Directory Users to Zoom**.
131114

132-
![Zoom User Mappings](media/zoom-provisioning-tutorial/zoom-user-mapping.png)
115+
9. Review the user attributes that are synchronized from Azure AD to Zoom in the **Attribute-Mapping** section. The attributes selected as **Matching** properties are used to match the user accounts in Zoom for update operations. If you choose to change the [matching target attribute](https://docs.microsoft.com/azure/active-directory/manage-apps/customize-application-attributes), you will need to ensure that the Zoom API supports filtering users based on that attribute. Select the **Save** button to commit any changes.
133116

134-
11. Review the user attributes that are synchronized from Azure AD to Zoom in the **Attribute Mapping** section. The attributes selected as **Matching** properties are used to match the user accounts in Zoom for update operations. Select the **Save** button to commit any changes.
135-
136-
![Zoom User Mappings](media/zoom-provisioning-tutorial/zoom-user-attributes.png)
117+
|Attribute|Type|
118+
|---|---|
119+
|userName|String|
120+
|active|Boolean|
121+
|name.givenName|String|
122+
|name.familyName|String|
123+
|emails[type eq "work"]|String|
124+
|urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department|String|
137125

138-
12. 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).
126+
10. 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).
127+
128+
11. To enable the Azure AD provisioning service for Zoom, change the **Provisioning Status** to **On** in the **Settings** section.
139129

140-
13. To enable the Azure AD provisioning service for Zoom, change the **Provisioning Status** to **On** in the **Settings** section.
141-
142130
![Provisioning Status Toggled On](common/provisioning-toggle-on.png)
143131

144-
14. Define the users and/or groups that you would like to provision to Zoom by choosing the desired values in **Scope** in the **Settings** section.
132+
12. Define the users and/or groups that you would like to provision to Zoom by choosing the desired values in **Scope** in the **Settings** section.
145133

146134
![Provisioning Scope](common/provisioning-scope.png)
147135

148-
15. When you are ready to provision, click **Save**.
136+
13. When you are ready to provision, click **Save**.
149137

150138
![Saving Provisioning Configuration](common/provisioning-configuration-save.png)
151139

152-
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. You can use the **Synchronization Details** section to monitor progress and follow links to provisioning activity report, which describes all actions performed by the Azure AD provisioning service on Zoom.
140+
This operation starts the initial synchronization cycle of all users and groups defined in **Scope** in the **Settings** section. The initial cycle takes longer to perform than subsequent cycles, which occur approximately every 40 minutes as long as the Azure AD provisioning service is running.
153141

154-
For more information on how to read the Azure AD provisioning logs, see [Reporting on automatic user account provisioning](../app-provisioning/check-status-user-account-provisioning.md).
142+
## Step 6. Monitor your deployment
143+
Once you've configured provisioning, use the following resources to monitor your deployment:
155144

156-
## Connector limitations
145+
1. Use the [provisioning logs](https://docs.microsoft.com/azure/active-directory/reports-monitoring/concept-provisioning-logs) to determine which users have been provisioned successfully or unsuccessfully
146+
2. Check the [progress bar](https://docs.microsoft.com/azure/active-directory/manage-apps/application-provisioning-when-will-provisioning-finish-specific-user) to see the status of the provisioning cycle and how close it is to completion
147+
3. If the provisioning configuration seems to be in an unhealthy state, the application will go into quarantine. Learn more about quarantine states [here](https://docs.microsoft.com/azure/active-directory/manage-apps/application-provisioning-quarantine-status).
157148

158-
* Zoom does not support provisioning for groups.
149+
## Connector limitations
150+
* Zoom only allows a maximum of 9,999 basic users today.
159151

160152
## Additional resources
161153

162-
* [Managing user account provisioning for Enterprise Apps](../app-provisioning/configure-automatic-user-provisioning-portal.md)
154+
* [Managing user account provisioning for Enterprise Apps](../manage-apps/configure-automatic-user-provisioning-portal.md)
163155
* [What is application access and single sign-on with Azure Active Directory?](../manage-apps/what-is-single-sign-on.md)
164156

165157
## Next steps
166158

167-
* [Learn how to review logs and get reports on provisioning activity](../app-provisioning/check-status-user-account-provisioning.md)
159+
* [Learn how to review logs and get reports on provisioning activity](../manage-apps/check-status-user-account-provisioning.md)

articles/app-service/configure-language-java.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,24 @@ Do not deploy your .war using FTP. The FTP tool is designed to upload startup sc
3333

3434
Performance reports, traffic visualizations, and health checkups are available for each app through the Azure portal. For more information, see [Azure App Service diagnostics overview](overview-diagnostics.md).
3535

36+
### Use Flight Recorder
37+
38+
All Java runtimes on App Service using the Azul JVMs come with the Zulu Flight Recorder. You can use this to record JVM, system, and Java level events to monitor the behavior and troubleshoot problems in your Java applications.
39+
40+
To take a timed recording you will need the PID (Process ID) of the Java application. To find the PID, open a browser to your web app's SCM site at https://<your-site-name>.scm.azurewebsites.net/ProcessExplorer/. This page shows the running processes in your web app. Find the process named "java" in the table and copy the corresponding PID (Process ID).
41+
42+
Next, open the **Debug Console** in the top toolbar of the SCM site and run the following command. Replace `<pid>` with the process ID you copied earlier. This command will start a 30 second profiler recording of your Java application and generate a file named `timed_recording_example.jfr` in the `D:\home` directory.
43+
44+
```
45+
jcmd <pid> JFR.start name=TimedRecording settings=profile duration=30s filename="D:\home\timed_recording_example.JFR"
46+
```
47+
48+
For more information, please see the [Jcmd Command Reference](https://docs.oracle.com/javacomponents/jmc-5-5/jfr-runtime-guide/comline.htm#JFRRT190).
49+
50+
#### Analyze `.jfr` files
51+
52+
Use [FTPS](deploy-ftp.md) to download your JFR file to your local machine. To analyze the JFR file, download and install [Zulu Mission Control](https://www.azul.com/products/zulu-mission-control/). For instructions on Zulu Mission Control, see the [Azul documentation](https://docs.azul.com/zmc/) and the [installation instructions](https://docs.microsoft.com/java/azure/jdk/java-jdk-flight-recorder-and-mission-control).
53+
3654
### Stream diagnostic logs
3755

3856
[!INCLUDE [Access diagnostic logs](../../includes/app-service-web-logs-access-no-h.md)]

0 commit comments

Comments
 (0)