Articles on: Onboarding

Setting up Microsoft Azure for Integration


Overview


This guide has been written to walk you through the steps required to set up your integration with Microsoft Azure.


Note: Please ensure that you have an active Azure subscription before following the steps detailed below


In this guide you will:


  • Set up an App Registration
  • Assign the correct, read-only permissions to the app
  • Generate a secret key for the app


Setting up the App Registration


  1. Go to the Microsoft Entra Portal and sign in


  1. Click on 'New registration' - you will see a page like the below:

The new app registration wizard


  1. Enter a title - we recommend keeping this simple and easy to identify, for example "OneClickComply Azure Integration"


  1. Ensure that "Accounts in this organizational directory only" is the option selected, then click 'Register'


  1. You will be sent to the app registration page for your new app. Click on "API permissions"


App registration overview

  1. Click on 'add a permission', and then Microsoft Graph, as seen in the screenshot below


API selection1. Select 'Application permissions'


  1. Add the following permissions


  • Directory.Read.All
  • Policy.Read.All
  • UserAuthenticationMethod.Read.All


  1. Click "Add permissions"


  1. Click "Grant admin consent for your organisation name"


  1. Go to Subscriptions - Microsoft Azure


  1. Select the subscription you wish to integrate with OneClickComply


  1. Click "Access control (IAM)" on the left hand menu
  2. Click "Add", then "Add role assignment"
  3. Click on the "Reader" role, then click "Next"



  1. Click on "Select members"
  2. In the menu which appears, type in the name of your app registration


  1. Click on your app registration, then click "Select" at the bottom of the menu


  1. Click "Review + assign", review the information on the page to ensure you have selected the correct role and application, then click "Review + assign" again to assign the role


  1. Go to App registrations - Microsoft Entra admin center and click on your app registration


  1. Click on "Certificates & secrets" in the left hand menu
  2. Click "New client secret"


  1. Enter a description for the secret so that it can be identified by admins (optional)


  1. Select an expiry time, then click "Add"


  1. Copy the contents of the "Value" field associated with your secret, and store this securely, e.g. in a secure note in your password manager of choice
  2. You are now ready to connect OneClickComply to your Azure subscription.


Updated on: 03/07/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!