Skip to main content
Azure

Azure Onboarding Process

Connect Azure to Wiv with the in-app keyless wizard. Wiv provisions federated workload identity, billing export to Blob, and per-subscription access — no client secret to store.

Written By Dotan Cohen

Last updated 4 days ago

Connect Azure to Wiv from Integrations → Azure → New Azure Integration. The wizard uses Microsoft sign-in and provisions a federated workload integration — Wiv does not store a long-lived client secret.

Note: Need a client-secret wiv_account instead? Use Azure Onboarding Process (script) or Azure Onboarding Process (Manual).

What Wiv sets up

  1. Discovers your tenant, billing accounts, subscriptions, and management groups.

  2. Creates or reuses a host subscription (existing or dedicated from billing scope).

  3. Registers an Entra app and configures federated workload trust (no stored client secret).

  4. Grants billing-account roles and per-subscription Reader, Monitoring Reader, and Cost Management Reader.

  5. Grants Reservations Reader at /providers/Microsoft.Capacity so Wiv can read reservation orders.

  6. Creates a daily FOCUS Parquet export to Blob with managed identity (allowSharedKeyAccess=false).

  7. Optionally assigns metrics scope at a management group.

  8. Verifies federated access and saves the integration.

Wiv does not create Synapse resources for new installations.

Trust and connectivity

After onboarding, Wiv authenticates with a short-lived token. Your Entra app trusts one Wiv AWS role, WivAzureFederationHub. No client secret is stored.

How Wiv gets an Azure token

When your admin clicks Connect to Azure, they sign in and approve consent. Wiv creates the app and the read-only roles with that admin's permissions, then deletes the admin's tokens.

What happens when your admin clicks Connect

Roles, network path, and how to revoke access are in Wiv Azure connectivity architecture.

Prerequisites

Billing account visibility

The wizard needs a billing account visible to the Microsoft login you use (EA, MCA, or CSP partner MCA). Customer tenants with no billing account cannot complete in-app onboarding.

Permissions in Wiv

You need permission to create integrations in Wiv.

Permissions in Microsoft Entra / Azure

Sign in as a user who holds every role below. Each role maps to a wizard phase.

Scope

Role you need

Used for

Microsoft Entra ID

Application Administrator or Cloud Application Administrator (or a tenant that lets users register apps)

Create the wiv_account app registration, service principal, and federated credential

Billing account

Billing account owner or Billing account contributor (MCA / CSP partner); Enterprise Administrator (EA)

Discover billing accounts and assign Billing account reader or Enrollment Reader to the app

Billing profile or enrollment account

Owner or Contributor on the MCA billing profile / invoice section, or Account Owner on the EA enrollment account

Create a dedicated host subscription. Skip if you reuse an existing subscription

Host subscription

Owner (or Contributor plus User Access Administrator)

Create rg-wiv, the storage account, the FOCUS export, and the export identity role

Every billed subscription

Owner or User Access Administrator, directly or inherited from a management group

Assign Reader, Monitoring Reader, and Cost Management Reader to the app

/providers/Microsoft.Capacity

User Access Administrator at tenant level. Global Administrator, subscription Owner, and management-group Owner are not enough

Assign Reservations Reader

Management group (optional)

Owner or User Access Administrator at that group

Assign Reader and Monitoring Reader for metrics

Entra ID and Azure RBAC are separate. If you are a Global Administrator, turn on Access management for Azure resources in Microsoft Entra ID → Properties, sign out and sign back in, then run the wizard (elevate access). Turn that setting off after onboarding.

If that grant fails, Grant billing access fails. Turn on Access management for Azure resources, sign out and sign back in, then retry. Reservation reads stay unavailable until Reservations Reader is assigned at /providers/Microsoft.Capacity.

EA only: Enterprise Administrators must enable Account owners can view charges under Cost Management + Billing → Policies.

Connect in Wiv

  1. Sign in to Wiv and go to Integrations.

  2. Click Azure, then New Azure Integration.

  3. Follow the four wizard steps: Connect, Configure, Provision, Complete.

Connect

On Grant Wiv.ai access to Azure, click Connect to Azure. Microsoft asks you to authorize Wiv to discover your tenant and billing scope, then provision resources.

Configure

On Choose your Azure scope, select the billing account, complete agreement-specific fields (MCA billing profile, EA enrollment account, or CSP customer scope), confirm the host subscription name, optionally select a metrics management group, and click Apply.

When Apply succeeds, the panel shows Configuration confirmed:

Provision

Setting up your integration runs provisioning phases (host subscription, app registration, billing roles, Reservations Reader at /providers/Microsoft.Capacity, smoke test, FOCUS export, optional metrics, federated trust, verification). Use Retry on a failed phase or Onboard Manually to fall back.

Complete

When setup succeeds you see Your Azure environment is connected. Click View Cloud Inventory to open the Azure integrations list.

MSP and customer-led onboarding can use Generate Integration Link from the Azure integrations page. The link flow uses the same provisioning engine as this wizard.

After onboarding

  • Confirm the new Azure integration appears under Integrations → Azure.

  • Allow 5–30 minutes for the first FOCUS export, or run Run now on WivFocusDailyExport in the Azure portal.

  • Do not delete the Entra app registration while the integration is active — workflows fail with AADSTS700016 if the app is removed.

Troubleshooting

Symptom

Likely cause

Action

Connect failed

Insufficient Microsoft permissions

Retry Connect or use script/manual path

No billing accounts in Configure

Wrong tenant or missing billing read access

Sign in to partner/EA/MCA tenant with billing admin rights

Grant billing access failed

Billing IAM not sufficient

Confirm billing account owner/contributor; wait for propagation

No cost data

First export pending

Run Run now on WivFocusDailyExport

AADSTS700016 in workflows

App deleted or wrong tenant

Re-onboard the integration