Skip to main content

Connect Azure account

Note

This page applies only if DoiT is NOT your cloud reseller. See Connect cloud account for more information.

DoiT Cloud Navigator: All tiers DoiT Cloud Solve: Enhanced and above

Requirements

In order to connect your Azure account to DoiT Cloud Navigator, you need to have an active Azure subscription.

Required permissions

To connect your Azure account with DoiT, you need the billingProfilesAdmin role in your DoiT account.

You also need the following permissions in your Azure account:

"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"
Tip

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

Connect your Azure account

To connect your Azure account to the DoiT Cloud Navigator:

  1. Sign in to the DoiT console.

  2. Select Microsoft Azure as the cloud provider to connect, or select Get started in the Connect your Azure account pane on the Welcome page.

Alternatively, you can connect your Azure account in the Assets page under Billing. From the left-hand menu, select Microsoft Azure and then select Connect your account.

Deploy a custom template in Azure

By using a template, you automate deployments and take advantage of infrastructure as code. The template is a JSON file that defines the infrastructure and configuration for your project, which you store in a source repository and version it so anyone on your team can run the code and deploy similar environments.

Info

To learn more about Azure Resource Manager (ARM) templates, check out Microsoft's documentation.

To feed the DoiT console with Azure billing data, you need to deploy a template we provide for you in our step-by-step wizard to your Azure account:

  1. Sign in to the Azure Portal and search for "Deploy custom template".

  2. Select Build your own template in the editor, and replace the blank template with the JSON template from the step-by-step wizard from the DoiT console.

    Deploy a custom template

  3. In the Subscription field, select the Azure subscription you want to use for the deployment.

  4. In the Region field, for compliance reasons, you may want to select the region where most of your resources are located.

  5. Select Save, and then Review + create.

  6. Once your template has been validated, select Create.

Note

Allow up to 15 minutes for the template to deploy before exporting your Azure billing data.

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

Export your Azure billing data to the DoiT console

Once you've deployed the template successfully, you need to create an export of your Azure billing data to the DoiT console:

  1. In Azure Portal, go to Cost Management + Billing, and then select Exports.

    Tip

    Make sure to select the correct billing account.

  2. Select Create, and:

    • In the Type of data field, select Cost and usage details (actual).
    • In the Export name field, enter a name for the report such as "DoiTBillingDataExport".
    • In the Dataset version field, select 2021-10-01.
    • In the Frequency field, select Daily export of month-to-date costs.
  3. Select Add.

  4. Select Next, and:

    • In the Storage type field, select Azure blob storage.
    • In the Destination and storage field, select Use existing.
    • In the Subscription dropdown, select your subscription.
    • In the Storage account dropdown, select your DoiT customer ID.
    Info

    If your storage account isn't available, allow up to 15 minutes after you deployed the template in the previous step, for your data to be fully available.

    • In the Container field, enter exportcontainer.
    • In the Directory field, enter exportfiles.
    • Keep the Overwrite data checkbox selected.
  5. Select Next.

  6. Select Create.

After your export report is saved, you need to run it to send the billing data to the DoiT console:

  1. Select the export you just created, and select Run now.

Test your Azure connection with the DoiT console

After you've successfully ran an export report of your billing data in Azure, test your Azure connection with DoiT:

  1. Go back to the guided setup in the DoiT console, and move to the Test connection step.

  2. In the Subscription ID field, enter the Azure subscription ID of the account you used to deploy the custom template.

  3. Select Test connection.

  4. Once the test is successful, select Done.

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 and we notify you when the data is available for Cloud Analytics and other DoiT features.