Skip to main content

Connect Azure account

Before you begin

  • This page applies only if DoiT is NOT your cloud reseller.

  • To connect your Azure account to DoiT, you need an active Azure subscription.

  • You'll be charged 2% of the monthly spend on the connected accounts.

See Connect cloud account for more information.

Required permissions

  • Your DoiT account needs the Billing Profile Admin permission.

  • your Azure account needs the following permissions:

    • Microsoft.Authorization/roleAssignments/write
    • Microsoft.Authorization/roleAssignments/delete
    • Microsoft.Resources/subscriptions/resourceGroups/write
    • Microsoft.Storage/storageAccounts/write
    • Microsoft.CostManagement/exports/write
    • Microsoft.Storage/storageAccounts/blobServices/containers/write
    • Microsoft.ManagedServices/registrationAssignments/write

    If you don't want to create a custom role in your Azure account with the permissions above, you need at least the preset Owner role to perform actions at subscription level.

Connect your Azure account

Launch the wizard

To connect your Azure account:

  1. Sign in to the DoiT console.

  2. Launch the connection wizard:

    • If you just start working with DoiT, select Microsoft Azure as the cloud provider on the welcome pag to open the wizard.

    • If you have already connected one or more cloud accounts with DoiT, you can choose either approach from below:

      • Navigate to the Home page, scroll down to the Connect your cloud section, and then choose Connect your Azure account.

      • Navigate to the Assets page, select Microsoft Azure from the left-hand menu, and then select Connect new account.

The wizard contains four steps:

Connect Azure account

Step 1: Requirements

The first step explains the Required permissions to connect your Azure account.

After you read through the requirements, select Next to continue.

Step 2: Deploy a custom template

DoiT supports using Azure Resource Manager templates (ARM templates) to implement infrastructure as code for your Azure solutions. The template is a JSON file that defines the infrastructure and configuration for your project. You can store the template in a source repository and version it to allow others to deploy similar environments.

In this step, you deploy a custom template provide by DoiT to your Azure account to feed the DoiT console with Azure billing data:

  1. Sign in to the Azure Portal and navigate to the Custom Deployment page.

  2. Select Build your own template in the editor, replace the blank template with the JSON code provided in the DoiT console, and select Save when you're done.

  3. Confirm the following information on the next page.

    • Project details — Subscription: Select the Azure subscription where you want to deploy the template.
    • Instance details — Region: For compliance reasons, you may want to select the region where most of your resources are located.
  4. Select Save, and then select Review + create.

  5. Once your template has been validated, select Create to finalize the template deployment.

In case the deployment fails in the Azure Portal, select Redeploy in your deployment overview page to launch it again.

Note

Allow up to 15 minutes for the template to deploy before continuing with the next step in the DoiT console.

Step 3: Create a billing export

In this step, you export your Azure billing data to the DoiT console:

  1. In Azure Portal, search for Cost Management + Billing, and then select Exports.

    Tip

    Make sure you've selected the correct billing account. See also Billing accounts and scopes in the Azure portal.

  2. Select Create, and then select Create your own export on the Basics tab.

    1. Fill out the required fields:

      • Type of data: Choose Cost and usage details (actual).
      • Export name: Enter a name for the export, for example, BillingDataExport.
      • Dataset version: Choose 2021-10-01.
      • Frequency: Choose Daily export of month-to-date costs.
    2. Select Add, enter DoiT in the Export prefix field, and then select Next.

  3. On the Destination tab, fill out the required fields:

    • Storage type: Choose Azure blob storage.
    • Destination and storage: Select Use existing.
    • Subscription: Choose your subscription.
    • Storage account: Choose your DoiT customer ID, which is the account specified in the deployed template. If your storage account isn't available yet, wait 15 minutes after you deployed the template in the previous step.
    • Container: Enter exportcontainer.
    • Directory: Enter exportfiles.
    • Format: Choose CSV.
    • Compression Type: Choose None.
    • Keep the Overwrite data checkbox selected.
  4. Select Next.

  5. On the Review + create tab, select Create.

  6. Back to the Exports page, select the export you just created, and then select Run now to deploy the export and send billing data to the DoiT console.

  7. Once the export is active, find your Azure subscription in the Azure portal and copy the Subscription ID.

Step 4: Test your Azure connection

The last step is to test your Azure connection with DoiT:

  1. Navigate back to the DoiT console, select Next to move to the Test connection step.

  2. In the Subscription ID field, paste the Azure subscription ID you copied from the Azure portal in the previous step.

  3. Select Test connection.

  4. Select Done if the test is successful.

Interactive demo

Try out our interactive demo for a hands-on walk-through experience.

If the demo doesn't display properly, try expanding your browser window or opening the demo in a new tab.

What's next

After you successfully connected your Azure account, we start importing your billing data. The process can take up to two hours. We notify you when the data is available for Cloud Analytics and other DoiT features.