Skip to main content

Register an Azure app

Azure app creation​

To interact with Microsoft Office APIs, you need to register an Azure app in Azure Portal. Once an app is created, assign specific API permissions that you need. To do so, follow these steps:

  1. Login at https://portal.azure.com.
  2. Go to App registrations.

  1. Create an app by clicking New registration.

  1. Create authentication secrets:
        a. Click on Certificates & secrets.
        b. Click on Client secret tab.
        c. Store the Value and Secret ID in your Key Management System.

danger

It is important to keep these credentials safe using a key store. It is good security practice not to hard code the secret in your code. Do not share secrets as this will compromise the safety and security of your data. You can use Dataplane's secrets to store these credentials. Learn more here: https://learn.dataplane.app/managing-secrets

  1. Add secrets to Dataplane. These variables will be used to authenticate with the Microsoft Graph API:
    • Add the Secret ID - Environment variable: secret_dp_office_365_id
    • Add the Secret - Environment variable: secret_dp_office_365_secret
    • Tenant ID - Environment variable: secret_dp_office_365_tenant_id
    • Application ID - Environment variable: secret_dp_office_365_application_id

info

The environment variables shown in the images will be used to safely to retrieve the secrets inside the pipelines.

  1. Get the Tenant ID from your app
        a. Click on Overview
        b. Get the Application (client) ID
        c. Get the Directory (tenant) ID
        d. Add Directory (tenant) ID and Application (client) ID into Dataplane secrets

  1. Add secrets to worker groups

note

Be sure to add the secrets to the worker groups. This is important because it injects the secrets into specific worker groups for isolation. The image above is an example of a secret being added to the python\_dev worker group.