Azure Integration (Start Here)
A full Azure integration has two parts. Do them in order. Each part uses its own Azure AD app registration.
Two apps, two setups
It is easy to miss the second step. Transact and co-sell are separate connections with separate apps and different permissions. Set up the Cloud Account first, then co-sell.
The two parts
| # | Part | What it does | Guide |
|---|---|---|---|
| 1 | Cloud Account (transact) | List, sync, and transact offers; private offers; metering | Azure Marketplace Setup |
| 2 | Co-Sell (referrals) | Send and receive Microsoft co-sell opportunities | Azure Co-Sell Setup |
Part 2 is optional — set it up only if you use Microsoft co-sell. Part 1 is required for everything else.
What each app needs
Both apps connect with Workload Identity Federation by default — no client secret is created or stored. A client secret is a fallback when a tenant cannot use federation; a secret-based connection also needs a Web redirect URI (see each setup page). You can switch a secret connection to federated later in Automatum, which removes the stored secret.
| Cloud Account (transact) app | Co-Sell app | |
|---|---|---|
| API permissions | None | Four delegated (see below) |
| Admin consent | Not needed | Required (Global Administrator) |
| Redirect URI | None with federation; Web if you use a secret | Web platform, Automatum callback |
| Authorized by | Partner Center Manager role + offer Technical configuration | Partner Center Referrals Admin role + admin-consented permissions |
| Federated credential | Yes (or a client secret) | Yes (or a client secret) |
Co-sell app permissions
Add these under the co-sell app's API permissions, then grant admin consent. Full steps are in Azure Co-Sell Setup.
| API | App (client) ID | Permission | Type |
|---|---|---|---|
| Microsoft Graph | — | User.Read | Delegated |
| Microsoft Partner | 4990cffe-04e8-4e8b-808a-1175604b879f | user_impersonation | Delegated |
| Microsoft Partner Center | fa3d9a0c-3fb0-42cc-9193-47c7ecd2edbd | user_impersonation | Delegated |
Do this in order
- Confirm you meet the prerequisites for the Cloud Account.
- Complete Azure Marketplace Setup (Part 1).
- Complete Azure Co-Sell Setup (Part 2), if you use co-sell.
Automate the Entra setup
Prefer a script? Download setup-azure-apps.sh. It creates both Entra apps (single tenant, federated credential, co-sell API permissions + admin consent) with the Azure CLI, then prints the manual Partner Center steps. It needs az and jq, and you must sign in as a Global Administrator. The federated-credential and redirect-URI values it uses are the production defaults — confirm them against the Automatum card.
Need Help?
Contact hello@automatum.io or use the in-app chat for help with Azure integration.