Table of contents

Add an Azure Account

Location

Main Dashboard >Select Add an account

Let's get started!

By adding your Azure Active Directories and Subscriptions to Trend Micro Cloud One™ – Conformity, your organization will be able to create holistic multi-cloud views of your security and governance posture.

User Access

User Role Can Access
Administrator
Power User
Custom - Full Access
Read Only
Custom - Read Only
  1. Set up access to Azure
  2. Add an Azure Active Directory
  3. Remove Active Directories
  4. Add an Azure China Subscription - Currently in Preview

Set up access to Azure

Access to Azure is provided via an Azure App registration, which provides Conformity's Rule engine the necessary read-only permissions to run the rule checks against subscription resources you want to add to your Conformity organization. Depending on your preference, choose your setup type as an Automated or Manual.

Automated mode

Run the Conformity onboarding script. For instructions on how to run the script see, Conformity Azure onboarding script on Github.

Manual mode

Prerequisite Set up Azure CLI or Cloud Shell

Important - As of 10 September 2021, the option to add Azure Active Directory Graph API permissions via the Azure Console is no longer supported. We are working with Microsoft to work through the unexpected changes.

In the meantime, you will need to add the Azure Active Directory Graph API permissions to the App Registration via the Azure CLI or Azure Cloud Shell (recommended) as an interim solution.

Resources:

Create an App registration

To set up this App registration, you will need to open your Azure console and complete the following steps.

  1. Select Active Directory.
  2. Select App registrations.
  3. Click New registration (app ID).


  4. Give the App registration a name e.g. Conformity Azure Access.
  5. Supported account types: 'Accounts in this organization only' (single tenant).
  6. Redirect URL: not required.

  7. Click Register.

Configure Certificates and secrets

  1. Select Certificates & secrets.
  2. Select Client secrets and click +New client secret.
  3. Add a description.
  4. Choose any expiry period.
  5. Click Add.

Save your new secret according to your organisation's security protocol. The secret will be needed later when adding your subscriptions to Conformity.



When you configure Certificates and secrets, you also created your application key.

If you no longer have access to this key, you can create it again following the same steps above.

Add API Permissions

You will need to configure API permissions for ActiveDirectory checks to enable Conformity Bot to access ActiveDirectory resources for running ActiveDirectory rules.

Due to the console option to add Azure Active Directory Graph API permissions being disabled, please be ready to use the CLI or Azure Cloud Shell in addition to the console.

  1. From App registrations, click on the app that you registered with Conformity during onboarding e.g. Conformity Azure Access and note the Application (client) ID.

  2. Access the Azure CLI or Azure Cloud Shell, navigate to the chosen directory and save the below contents as 'manifest.json'. This file includes the permissions required to for the App Registration:

     [{
    
        "resourceAppId": "00000003-0000-0000-c000-000000000000",
    
        "resourceAccess": [
    
           {
    
              "id": "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
    
              "type": "Scope"
    
           },
    
           {
    
              "id": "a154be20-db9c-4678-8ab7-66f6cc099a59",
    
              "type": "Scope"
    
           },
    
           {
    
              "id": "7ab1d382-f21e-4acd-a863-ba3e13f7da61",
    
              "type": "Role"
    
           },
    
           {
    
              "id": "df021288-bdef-4463-88db-98f22de89214",
    
              "type": "Role"
    
           }
    
        ]
    
     },
    
     {
    
        "resourceAppId": "00000002-0000-0000-c000-000000000000",
    
        "resourceAccess": [{
    
              "id": "5778995a-e1bf-45b8-affa-663a9f3f4d04",
    
              "type": "Scope"
    
           },
    
           {
    
              "id": "c582532d-9d9e-43bd-a97c-2667a28ce295",
    
              "type": "Scope"
    
           },
    
           {
    
              "id": "311a71cc-e848-46a1-bdf8-97ff7156d8e6",
    
              "type": "Scope"
    
           },
    
           {
    
              "id": "5778995a-e1bf-45b8-affa-663a9f3f4d04",
    
              "type": "Role"
    
           }
    
        ]
    
     }]
    
  3. Run the following command, inserting the correct Application ID:

az ad app update --id 000-YOUR-APP-ID-0000 --required-resource-accesses @manifest.json

If using PowerShell, run the following command from the directory where you've save the manifest.json file:

az ad app update --id 000-YOUR-APP-ID-0000 --required-resource-accesses ./manifest.json

  1. Azure will take a few minutes to update the permissions to be visible in the Console. You can check the permissions have been added using the following command: az ad app permission list --id 000-YOUR-APP-ID-0000. This will return the values saved from the 'manifest.json' file.

  2. After waiting a few minutes, navigate back to the App Registration in the Azure Console and select API Permissions in the left-hand menu. You should see the following:

  3. On the API Permissions page, click Grant admin consent for [AD name] to grant admin consent for all the permissions.


Once complete, your configured API permissions should look like this:

Create a custom role

  1. Navigate to Subscriptions.
  2. Select Access Control (IAM).
  3. Click Add > Add Custom Role.


  4. Select the JSON tab and click on the Edit button.


  5. Remove the content of the template and then Copy and Paste the following JSON into the template.
      {
         "properties": {
               "roleName": "Custom Role - Cloud One Conformity",
               "description": "Subscription level custom role for Cloud One Conformity access.",
               "assignableScopes": [],
               "permissions": [
                  {
                     "actions": [
                           "Microsoft.AppConfiguration/configurationStores/ListKeyValue/action",
                           "Microsoft.Network/networkWatchers/queryFlowLogStatus/action",
                           "Microsoft.Web/sites/config/list/Action",
                           "Microsoft.Storage/storageAccounts/queueServices/queues/read"
                     ],
                     "notActions": [],
                     "dataActions": [],
                     "notDataActions": []
                  }
               ]
         }
      }

6. Click Save.

7. Select the Assignable Scopes tab > Add assignable Scope.



8. Select your subscription(s) and click Add.

9. Click Review + Create, and then click Create.

It may take several minutes for the role to be available for use in the system.

Create Role Assignments

Reader role

  1. From the Access Control (IAM) page click Add → Add Role Assignment.
  2. Under the Role drop-down select Reader.
  3. Ensure that Assign Access to is set to User, group or service principal.
  4. From the Select dropdown search for your Conformity App registration, eg Conformity Azure Access.
  5. Click Save.
  6. Repeat for any additional subscriptions.

Custom role

  1. From the Access Control (IAM) page click Add → Add Role Assignment
  2. Under the Role drop-down search for the Role you added in step 1 eg Custom Role - Cloud One Conformity.
  3. Ensure that Assign Access to is set to User, group or service principal.
  4. From the Select dropdown search for your Conformity App registration, eg Conformity Azure Access.
  5. Click Save.
  6. Repeat for any additional subscriptions.

Add an Azure Active Directory

To add an Active Directory (and Subscriptions), you will first need to Create an App registration for each Active Directory you want to add to your Conformity organization.

Once your Azure App registration is set up, you are ready to add your Active Directory.

  1. Sign in to Conformity.
  2. From Conformity's Main Dashboard, click on Add an account.
  3. Click on Azure Subscription, then click Next.
  4. Populate Active Directory Name and Active Directory Tenant ID, then click Next
    • Active Directory Name: will be the reference name of your Active Directory in Conformity. This name will display in the Conformity accounts menu and does not need to match any names used in your Azure console.
    • Active Directory Tenant ID: identifies your Active Directory for Conformity.

To get Active Directory Tenant ID from Azure:

  1. Select **Azure Active Directory**.
  2. Select **Properties**.
  3. **Copy to clipboard** the **Tenant ID**.

  <br /> ![](img/misc/ad-tenant-id-z4ayip.png){.zoom} <br />

5. To allow Conformity access to your Azure Subscriptions, you will use the Azure App registration created in the previously setup. This will allow the Conformity rule engine to run Rule checks against Subscriptions within your Azure Active Directory. You will need to supply both the:

  • App registration Application ID

To get App registration ID from Azure:

  1. Select **Azure Active Directory**.
  2. Select **App registrations**.
  3. Select the application i.e. **_Conformity Azure Access_** _or whatever you named this application._
  4. Copy the **App registration Application ID**.
  • Application registration Key that was generated for your Azure App registration.
  • Your application registration key is created when you Configure certificates and secrets during the setup of your Azure App registration.
  • If you do not have this key, you can create it again following the same steps in Configured certificates and secrets.

6. After clicking Next, you will have the option to select subscriptions you want to add to your Conformity organization.

You will only see subscriptions that you have provided Conformity access to in your Azure App registration setup.
If you can't see your subscription you will need to enable access settings for this Subscription in Azure following the instructions:Assign access to the App registration for a Subscription

7. Click Next, and wait a moment as Conformity Bot checks your subscription resources for rule failures.

8. Success! Once the Conformity Bot has finished running, you will be returned to the Main Dashboard where you will see your added Azure Active Directory.

the accounts navigation will be organized to group together Cloud Providers of the same type.



Remove Active Directories

Click Delete... on existing Active Directory.

Active Directories can only be deleted once all their Subscriptions have been removed.

Add an Azure China Subscription (Currently in Preview)

Request Azure China for your organization

To add an Azure China subscription to your Conformity account, you will need to email alloftrendproduct-conformity@trendmicro.com with the following details:

  • Name of your Organization’s Account in Conformity
  • Whether you access Conformity via the Cloud One Platform or Conformity Standalone (i.e., www.cloudconformity.com)
  • A list of your organizations’ key contacts

Add China Cloud

  1. Login to the Conformity organisation for which the ‘azure-china’ feature has been enabled.
  2. Click Add an account.
  3. Select Azure Subscription.
  4. Select Add new Active Directory for this new Subscription and click Next.
  5. To enter the correct Azure China AD information, ensure that you select the China Cloud option under Azure Cloud Environment.
  6. Follow the steps to Set up Access to Azure.