SharePoint Connection

Access Azure Portal

Go to Microsoft Entra ID (formerly Azure AD)

Create a New Application Registration

Navigate to Applications > App Registrations > New 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

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.

Configure Permissions

Playground needs a combination of application and delegated permissions. This is the list of all the permissions needed by Playground to properly work.

To grant the permissions, follow these steps:

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

6. Add delegated permissions: Select Microsoft Graph > Delegated permissions and selected:

• Sites.Read.All delegated,
• User.Read,
• offline_access,
• openid,
• profile,

Grant Admin Consent

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

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.

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

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