Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The SharePoint Online microservice requires a key vault with a certificate for certificate-based authentication between the microservice and the service principal registered for it. Additionally, the key vault needs to configured with an access policy that grants key, secret and certificate permissions to assigned applications. These permissions will be granted to the SharePoint Online app service hosting the microservice.

Create the key vault and certificate

  1. In Azure, create a key vault.

  2. Navigate to the Certificate page for the key vault and generate a self-signed certificate for it.

  3. Download the certificate in CER format. You will add this to the service principal you created for the SharePoint Online microservice.

Add access policy to the key vault

  1. Add Navigate to the Access policies blade for the key vault and add an access policy to the key vault it with the below Key, Secret and Certificate permissions.

    • Key Permissions

      • Get

      • Decrypt

      • Unwrap Key

      • Verify

    • Secret Permissions

      • Get

      • List

      • Set

      • Delete

      • Purge

    • Certificate Permissions

      • Get

  2. Select the SharePoint Online app service you created earlier as the service principal.

Add a secret to the key vault

  1. Navigate to the Secrets blade for the access policy and select Generate/Import.

  2. Set the Name to SPOAppServiceAuthSecret and the Value to the value of the secret you created for the microservice service principal.

Upload the certificate to the service principal

  1. Navigate to the Certificates & Secrets blade for the service principal you registered for the SharePoint Online microservice.

  2. Upload the certificate you downloaded from the key vault.

Insert excerpt
IL:External Stylesheet
IL:External Stylesheet
nopaneltrue

Div
stylefloat: left; position: fixed;padding: 5px;

IN THIS ARTICLE

Table of Contents
maxLevel4
minLevel2
stylenone