Entra ID App Registration

Register Proventeq365 in Microsoft Entra ID, assign the Cloud Application Administrator role, and grant the Microsoft Graph and SharePoint API permissions for your deployment mode.

What this does: Registers Proventeq365 as an application in your Microsoft Entra ID tenant and grants it the permissions it needs to access Microsoft 365 services.

Note: You can either follow the steps below or use the Entra App Creation Script in the Appendix. The specific API permissions depend on your chosen deployment mode (Read-only or Read-write). Proventeq will confirm the exact permissions list before you complete this step.

Create the App Registration

Steps — Azure Portal

  1. Sign in to the Azure Portal (https://portal.azure.com) and go to Microsoft Entra ID.
  2. Select App registrations > + New registration.
  3. Enter a meaningful name (e.g. Proventeq365), leave the default account type, and click Register.
  4. Note the Application (client) ID and Directory (tenant) ID — you will need to share these with Proventeq.

Steps — Azure CLI (alternative)

bash
az ad app create \
  --display-name "<APP_NAME>" \
  --sign-in-audience AzureADMyOrg

Assign the Cloud Application Administrator Role

Steps — Azure Portal

  1. In Microsoft Entra ID, go to Roles and administrators.
  2. Search for and select Cloud Application Administrator.
  3. Click + Add assignment.
  4. On the Members tab, click Select member(s) and add the deployment user account created in Create a Deployment Identity.
  5. On the Settings tab, set the assignment type to Active, then confirm.

Azure CLI (alternative)

bash
az ad app owner add \
  --id <APP_OBJECT_ID> \
  --owner-object-id <USER_OBJECT_ID>

Grant API Permissions

  1. In the app registration, go to Manage > API permissions.
  2. Add the required Microsoft Graph and service permissions for your chosen deployment mode:
    • Read-only mode: Apply the permissions shown in the Read-only permissions screenshot provided by Proventeq.
    • Read-write mode: Apply the permissions shown in the Read-write permissions screenshot provided by Proventeq (this includes additional permissions compared to Read-only).
  3. Once all permissions are added, click Grant Admin Consent for [your organization] and confirm.

Read-only mode permissions

Microsoft Graph (7 permissions)

API / PermissionTypeDescriptionAdmin Consent
Chat.Read.AllApplicationRead all chat messagesYes
Group.Read.AllApplicationRead all groupsYes
Mail.ReadApplicationRead mail in all mailboxesYes
Mail.ReadBasic.AllApplicationRead basic mail in all mailboxesYes
Sites.Read.AllApplicationRead items in all site collectionsYes
Team.ReadBasic.AllDelegatedRead the names and descriptions of teamsNo
User.Read.AllApplicationRead all users' full profilesYes

SharePoint (2 permissions)

API / PermissionTypeDescriptionAdmin Consent
Sites.Read.AllApplicationRead items in all site collectionsYes
User.Read.AllApplicationRead user profilesYes

Read-write mode permissions

Microsoft Graph (23 permissions)

API / PermissionTypeDescriptionAdmin Consent
Chat.CreateApplicationCreate chatsYes
Chat.Read.AllApplicationRead all chat messagesYes
Directory.ReadWrite.AllApplicationRead and write directory dataYes
Group.Read.AllApplicationRead all groupsYes
Group.ReadWrite.AllApplicationRead and write all groupsYes
InformationProtectionPolicy.Read.AllApplicationRead all published labels and label policiesYes
Mail.ReadApplicationRead mail in all mailboxesYes
Mail.ReadBasic.AllApplicationRead basic mail in all mailboxesYes
offline_accessDelegatedMaintain access to data you have given it access toNo
openidDelegatedSign users inNo
profileDelegatedView users' basic profileNo
RecordsManagement.Read.AllApplicationRead Records Management configuration, labelsYes
RecordsManagement.ReadWrite.AllApplicationRead and write Records Management configurationYes
SensitivityLabels.Read.AllApplicationGet labels tenant scopeYes
Sites.Archive.AllApplicationArchive/reactivate Site Collections without a signatureYes
Sites.Manage.AllApplicationCreate, edit, and delete items and lists in all sitesYes
Sites.Read.AllApplicationRead items in all site collectionsYes
Sites.ReadWrite.AllApplicationRead and write items in all site collectionsYes
Team.ReadBasic.AllApplicationGet a list of all teamsYes
User.ReadDelegatedSign in and read user profileNo
User.Read.AllApplicationRead all users' full profilesYes
User.ReadBasic.AllApplicationRead all users' basic profilesYes
User.ReadWrite.AllApplicationRead and write all users' full profilesYes

SharePoint (2 permissions)

API / PermissionTypeDescriptionAdmin Consent
Sites.FullControl.AllApplicationHave full control of all site collectionsYes
User.ReadWrite.AllApplicationRead and write user profilesYes