Skip to content

Register ArcGIS Insights with Microsoft Azure

Vicki Cove edited this page Aug 22, 2023 · 4 revisions

Before you can create a connection to Microsoft SharePoint or Microsoft OneDrive, your Microsoft 365 administrator must register Insights with Microsoft Azure. Once Insights is registered in Azure you can create connections to both SharePoint and OneDrive.

Insights 2023.2

In Insights 2023.2, the Microsoft Authentication Library used to create SharePoint and OneDrive connections was upgraded. The upgraded authentication library requires Insights to be registered using authorization code flow authentication. The Microsoft 365 administrator must register Insights using the new authentication method before SharePoint or OneDrive connections can be created in Insights 2023.2, including for organizations that have used SharePoint or OneDrive connections with previous Insights versions.

Complete the following steps to register or re-register Insights 2023.2 with Microsoft Azure:

  1. Open Azure (https://portal.azure.com/#home).

  2. Under Azure services, click App registrations. If you do not see App registrations, use the search bar to find the service.

  3. Click New registration.

  4. Enter a display name for your app and click Register.

  5. On the App registrations page, click the display name for the app you just registered.

  6. On the overview tab, copy the Application (client) ID value.

    You will need the ID later when you create the connection to SharePoint and OneDrive from Insights.

  7. Click the Authentication tab.

  8. On the Single-page application dialog box, under Redirect URIs, click Add URI.

  9. Enter the URI for your Insights organization:

  10. Click the API permissions tab.

  11. Click Add a permission. In the Request API permissions window, select SharePoint.

  12. Under What type of permissions does your application require?, select Delegated permissions.

  13. Under AllSites, select AllSites.Read. Under MyFiles, select MyFiles.Read.

    Note: Only SharePoint sites for which you have been granted access by the SharePoint administrator will be available in Insights.

  14. Close the Request API permissions window.

  15. Click Grant admin consent for the user. Click Yes to verify you want to grant permissions to the account.

  16. Click your user name to display your sign in information.

    Your account information is displayed in the format username@organizationname.com.

  17. Copy the organization name for your reference when you create the connection in Insights.

For more information on API permissions, see Manage app registration and API permission for Microsoft Graph notifications.

Insights 2023.1 and lower

Complete the following steps to register Insights 2023.1 and lower with Microsoft Azure:

  1. Open Azure (https://portal.azure.com/#home).

  2. Under Azure services, click App registrations. If you do not see App registrations, use the search bar to find the service.

  3. Click New registration.

  4. Enter a display name for your app and click Register.

  5. On the App registrations page, click the display name for the app you just registered.

  6. On the overview tab, copy the Application (client) ID value.

    You will need the ID later when you create the connection to SharePoint and OneDrive from Insights.

  7. Click the Authentication tab.

  8. On the Web dialog box, under Redirect URIs, click Add URI.

  9. Enter the URI for your Insights organization:

    • For Insights in ArcGIS Online, enter https://insights.arcgis.com/msal-callback.html.

    • For Insights in ArcGIS Enterprise, enter your organization's URL, followed by /msal-callback.html, for example, https://webadaptorhost.domain.com/portal/apps/insights/msal-callback.html.

  10. Under Implicit grant, ensure that Access tokens and ID tokens are selected.

Insights is now registered with your SharePoint and OneDrive app. Along with the Application (client) ID value, you will also need your organization name to create a connection.

  1. Click the API permissions tab.

  2. Click Add a permission. In the Request API permissions window, select SharePoint.

  3. Under What type of permissions does your application require?, select Delegated permissions.

  4. Under AllSites, select AllSites.Read. Under MyFiles, select MyFiles.Read.

Note:
Only SharePoint sites for which you have been granted access by the SharePoint administrator will be available in Insights.

  1. Close the Request API permissions window.

  2. Click Grant admin consent for the user. Click Yes to verify you want to grant permissions to the account.

  3. Click your user name to display your sign in information.

Your account information is displayed in the format username@organizationname.com.

  1. Copy the organization name for your reference when you create the connection in Insights.

For more information on API permissions, see Manage app registration and API permission for Microsoft Graph notifications.