SharePoint Connection

SharePoint Connection

This guide explains how to connect SharePoint to Playground Pro. This procedure should only be performed by your company’s General Azure Administrator.

Note

This procedure applies only to Playground Pro. If you are using Playground Enterprise, SharePoint connection is configured during installation.

Azure Application Registration

Access Azure Portal

Go to Microsoft Entra ID (formerly Azure AD)

Create a New Application Registration

Navigate to Applications > App Registrations > New Registration

New Application Registration

Register the New Application

Fill the following details and validate

  1. Name: playground-your_name
  2. Supported account types: Single tenant
  3. Redirect URI Platform: Single page application (SPA) URL: https://playground.elqano.com

Register the new application:

Get Azure Tenant ID and Microsoft App ID

After registration, note down the Azure Tenant ID and the Microsoft APP ID - you will need these later.

Please note that in the azure portal these values are named Directory (tenant) ID and Application (client) ID respectively.

Application ID Location

Configure Permissions

  1. Go to Manage > API permissions
  2. Click Add a permission
  3. Select Microsoft Graph > Application permissions
  4. Search for and select Sites.ReadAll
  5. Click Add

API Permissions

Grant Admin Consent

Click the Grant admin consent button to approve the permissions for your organization.

Grant Admin Consent

Warning

Do not skip this step, otherwise the Playground users will not be able to connect to SharePoint

Allow users to connect to playground

In some organizations, users may need to request app permissions approval from administrators when they cannot give consent themselves. These requests can be managed at Azure Portal - Enterprise applications - Admin consent requests.

Create Microsoft App Password

  1. Go to Certificates & secrets
  2. Click New client secret
  3. Note down the generated secret value: this is the Microsoft App Passwordt that you will need later and it won’t be shown again.

Client Secret Creation

Note

Once you close the page, the secret won’t be shown again

Playground Configuration

Access Playground

Log in to Playground

Create Data Source

  1. Navigate to Data Source
  2. Click the + button
  3. Choose a Data Source name
  4. Click Create

Configure SharePoint Connection

  1. Open the newly created Data Source
  2. Click Connect to SharePoint
  3. Fill out the form using the Azure Tenant ID and Microsoft App ID obtained here and the Microsodt App Password obtained here

SharePoint Connection Form

Validate Permissions

  1. Return to the Chat interface
  2. A pop-up will appear requesting permission validation
  3. Follow the prompts to complete the validation

Permission Validation Form

Support

For any assistance or support needs, contact the Elqano Team