Configure Secrets for the Exchange Online Microservice

After you have published the Exchange Online microservice to Azure, you need to create a Key Vault in Azure (if needed), adding secrets to the Key Vault and configuring the App Service Application settings with those secrets.

Configure secrets

1. In Azure, create a Key Vault if you do not already have one or want to create a new one.

2. Navigate to the Key Vault blade for the appropriate Key Vault.

3. On the navbar for the Key Vault, under Settings, click Access Policies.

4. Click + Add Access Policy.
   
   

   Open

   

    

5. Click the Key Permissions drop-down and select the Get, Decrypt, Unwrap Key, and Verify operations.
   
   

   Open

   

    

6. Click the Secret permissions drop-down and select the Get operations.
   
   

    

7. Under Select principal, click None Selected.
   
   

    

8. Search for and select the Managed Identity for the Exchange Online App Service. Please note that the Managed Identity you select is the System Assigned Managed Identity you assigned in Step 12 of Configure Exchange Online App Service Authentication.
   
   

    

9. Click Select to select the principal.

10. On the Add access policy blade, click Add.
    
    

     

11. On the navbar for the Key Vault, under Settings, click Secrets.

12. On the Secrets page, click Generate/Import.
    
    

     

13. On the Create a secret blade, do the following to create the first secret:

    1. Name — Enter EIDExchangeAdminUser.

    2. Value —Secret values should follow username:password format, such as eiduser@<YourAzureTenant>:TestPass123.

    3. Click Create.
       
       

        

14. Back on the Secrets blade, click Generate/Import again.

15. On the Create a secret blade, do the following to create the second secret:

    1. Name — Enter EIDExchangeUserPassword.

    2. Value — Secret values should follow username:password format, such as eiduser@<YourAzureTenant>:TestPass123.

    3. Click Create.

16. Back on the Secrets blade, click the record for the first secret.
    
    

     

17. Click the Current Version to go to the Properties blade for the secret.
    
    

     

18. On the Properties blade, copy the Secret Identifier. You will use this value later.
    
    

     

19. Return to the Secrets blade and repeat steps 16, 17 and 18 for the second secret.

20. Navigate to the Exchange Online App Service you created earlier.

21. On the navbar for the App Service, under Settings, click Configuration.

22. Under Application settings, click New application setting.
    
    

     

23. In the Add/Edit application setting pane, do the following:

    1. Name — Enter the name you gave the to the first secret.

    2. Value — Enter @Microsoft.KeyVault(SecretUri={The_Secret_Identifier_For_The_First_Secret}), replacing {The_Secret_Identifier_For_The_First_Secret} with the actual Secret Identifier for the secret.

    3. Click OK.
       
       

        

24. Back in the Application settings tab of the Configuration blade, click New Application setting.

25. In the Add/Edit application setting pane, do the following:

    1. Name — Enter the name you gave the to the second secret.

    2. Value — Enter @Microsoft.KeyVault(SecretUri={The_Secret_Identifier_For_The_Second_Secret}), replacing {The_Secret_Identifier_For_The_Second_Secret} with the actual Secret Identifier for the secret.

    3. Click OK.

26. Click Save on the Configuration blade.
    
    

     

27. Click Continue to confirm that you want to save changes.