Open menu

Add an Azure account

Location

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

  1. Set up access to Azure
  2. Add an Azure Active Directory
  3. Remove Active Directories

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.

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

  1. Create an App registration
  2. Configure Certificates and secrets
  3. Add API Permissions
  4. Assign access to the App registration for Subscriptions

Create an App registration

  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 select +New client secret.
  3. Add a description.
  4. Choose any expiry period.
  5. Click Add.

    Note: 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.

  1. From App registrations, click on the app that you registered with Conformity during onboarding e.g. Conformity Azure Access.
  2. Select API permissions and click + Add a permission.

  3. Under Supported legacy APIs, select Azure Active Directory Graph.

    1. Set Delegated permissions to:
      1. User.Read
      2. User.Read.All
      3. Directory.Read.All
    2. Set Application permissions to:
      1. Directory.Read.All
    3. Click Add permissions.
  4. Click + Add a permission again.
  5. Under Commonly used Microsoft APIs, select Microsoft Graph.
    1. Set Delegated permissions to:
      1. User.Read
      2. User.Read.All
    2. Set Application permissions to:
      1. Directory.Read.All
      2. User.Read.All
    3. Click Add permissions.
  6. 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:

Assign access to the App registration for Subscriptions

Conformity’s Rule engine can only scan the subscriptions you’ve added to your Active Directory within Conformity. Depending on your preference, choose your registration type as an Automated setup or Manual setup.

Automated mode

  1. Navigate to App registrations.
  2. Select the Conformity App registration, eg Conformity Azure Access.
  3. Copy the “Application (client) ID” of the App registration.
  4. Run the Conformity onboarding script using the Application (client) ID.
    For instructions on how to run the script see, Conformity Azure onboarding script on Github.

Note: The script will apply the Reader and Custom role to all subscriptions in the Active Directory that the App registration resides within.

Manual mode

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 AddAdd 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.

  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:

    1. 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.

    2. 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.

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

Remove Active Directories

Click Delete… on existing Active Directory. Note: Active Directories can only be deleted once all their Subscriptions have been removed.