Tenant Setup

Install app registration

The main Entra app for ProvEn 2.0 is a multi-tenanted app, and all resources are hosted in the Core tenant. This means that all that needs to be done is to install the app in the tenant where you want to use it.

To install the app, a global admin needs to consent to the permissions requested by the app. This must be done from inside the target tenant.

https://login.microsoftonline.com/common/adminconsent?client_id=52253a1a-406a-43b9-857c-5837ae6a80e3

Once added, confirm an Enterprise App registration named “ProvEn 2.0” is available in the tenant.

Tip

Details on the app registration can be found here.

Add table entry

A tenant will only accept a job if it is listed in the Tenants storage table. This be be completed via the API:

curl --request POST `
  --url https://app-proven2-api-prod-001.azurewebsites.net/v1/tenants `
  --header 'Authorization: Bearer eyJ0e...plbDP8w' `
  --header 'content-type: application/json' `
  --data '{"id":"b2b8a771-e4ce-4a15-a6fb-a19e8d195a78","name":"core365dev"}'

Caution

Be sure to double-check the data before sending the request.

Note

You must be authenticated as a Core user to send requests to the API. For more information, see here.

Confirm the tenant has been added by performing a GET request:

$tenantId = "b2b8a771-e4ce-4a15-a6fb-a19e8d195a78"
curl --request GET `
  --url 'https://app-proven2-api-test-001.azurewebsites.net/v1/tenants/$tenantId' `
  --header 'Authorization: Bearer eyJ0e...plbDP8w'

Set up ProvEnBase SharePoint site

Tip

This is a legacy ProvEn 1 feature. Future versions of ProvEn 2.0 will make this optional.

A site collection at /sites/ProvEnBase is required. This must contain three lists:

• Requests List
• Install List
• Template List

These lists can be created automatically using the PnP Provisioning Engine (Invoke-PnPSiteTemplate), and the included template.

The template can be found at CoreTechnology.Provisioning.ProvEn2.Engine/Assets/Templates/Lists.xml