Connect Microsoft Azure to StackSpend

Prerequisites

• An Azure subscription with billing enabled
• Access to Azure Portal with subscription owner or contributor permissions
• Azure Active Directory admin access (for app registration)

Register an App in Azure Active Directory

Create a service principal (app registration) that StackSpend will use to authenticate and access cost data.

1. 1Go to Azure Portal
2. 2Navigate to Azure Active Directory → App registrations
3. 3Click New registration
4. 4Name: StackSpend Cost Reader
5. 5Supported account types: Accounts in this organizational directory only
6. 6Click Register
7. 7Copy the Application (client) ID and Directory (tenant) ID - you'll need these later

Create a Client Secret

1. 1In the app registration, go to Certificates & secrets
2. 2Click New client secret
3. 3Description: StackSpend Cost Access
4. 4Expires: Choose an appropriate expiration (e.g., 24 months)
5. 5Click Add
6. 6Important: Copy the Value immediately. You won't be able to see it again after leaving this page.

Grant Cost Management Reader Role

Assign the service principal the Cost Management Reader role at the subscription or management group level.

1. 1Go to Subscriptions (or Management groups if you want to track multiple subscriptions)
2. 2Select your subscription (or management group)
3. 3Click Access control (IAM)
4. 4Click Add → Add role assignment
5. 5Role: Cost Management Reader
6. 6Assign access to: User, group, or service principal
7. 7Search for and select your app: StackSpend Cost Reader
8. 8Click Review + assign → Review + assign

Get Your Subscription ID

1. 1Go to Subscriptions in Azure Portal
2. 2Select your subscription
3. 3Copy the Subscription ID (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

Connect in StackSpend

1. 1Go to Settings → Providers in your StackSpend dashboard
2. 2Click Add Provider → Select Azure
3. 3Enter your credentials:
   • Tenant ID: Directory (tenant) ID from Step 1
   • Client ID: Application (client) ID from Step 1
   • Client Secret: Client secret value from Step 2
   • Subscription ID: Subscription ID from Step 4
4. 4Click Test Connection to verify
5. 5Once the test succeeds, click Connect