Azure Marketplace Setup

Connect your Azure Marketplace publisher account to Automatum for seamless integration.

Prerequisites

Before connecting your Azure account, ensure you have:

• An active Microsoft Partner Center account
• Azure Marketplace publisher status
• Your Publisher ID
• Application (client) ID and secret from Azure AD
• Automatum organization created

Integration Overview

Automatum integrates with Azure Marketplace through the Microsoft Partner Center APIs. This integration enables:

• Private offer creation and management
• Product listing synchronization
• Customer entitlement tracking
• Usage reporting for SaaS offers

Step 1: Register Azure AD Application

1. Sign in to the Azure Portal
2. Navigate to Azure Active Directory > App registrations
3. Click New registration
4. Provide:
   • Name: Automatum Integration
   • Supported account types: Accounts in this organizational directory only
5. Click Register

Step 2: Configure API Permissions

Add these API permissions to your application:

Microsoft Graph (Delegated)

• User.Read - Sign in and read user profile

Partner Center (Application)

• Directory.Read.All - Read directory data
• Application.ReadWrite.OwnedBy - Read and write owned applications

TIP

You may need to contact Microsoft Partner Center support to enable API access for your account.

Step 3: Create Client Secret

1. In your app registration, go to Certificates & secrets
2. Click New client secret
3. Provide a description: "Automatum Integration Secret"
4. Set expiration (recommended: 24 months)
5. Click Add
6. Copy the secret value immediately (it won't be shown again)

Step 4: Get Your Publisher Details

Find your Publisher ID:

1. Sign in to Partner Center
2. Navigate to Account settings > Organization profile
3. Copy your Publisher ID

Step 5: Configure in Automatum

1. Navigate to Settings > Integrations
2. Click Connect Azure Account
3. Enter the following information:
   • Tenant ID: Your Azure AD tenant ID
   • Application (Client) ID: From app registration
   • Client Secret: The value you copied earlier
   • Publisher ID: From Partner Center
4. Click Test Connection
5. If successful, click Save

Step 6: Authorize Access

After saving your configuration:

1. You'll be redirected to Microsoft's consent page
2. Sign in with your Partner Center credentials
3. Review the requested permissions
4. Click Accept
5. You'll be redirected back to Automatum

Step 7: Sync Products

Import your Azure Marketplace offers:

1. Go to Listings
2. Click Sync from Azure
3. Select the offers you want to manage in Automatum
4. Click Import Selected

Plan Selection

Azure Marketplace offers can have multiple plans. Automatum will import all plans associated with your offers.

Supported Offer Types

Automatum supports these Azure Marketplace offer types:

Offer Type	Private Offers	Usage Tracking	Metering
SaaS	✅	✅	✅

Verification

Verify your integration is working:

1. Check that your offers appear in Listings
2. View existing private offers
3. Create a test private offer
4. Verify customer entitlements sync correctly

Troubleshooting

Connection Failed

Error: Invalid Client Credentials

• Verify the Application (Client) ID is correct
• Check that the client secret hasn't expired
• Ensure the secret value was copied correctly

Error: Insufficient Permissions

• Verify API permissions are configured correctly
• Check that admin consent was granted
• Ensure your Partner Center account has appropriate roles

Products Not Syncing

No offers found

• Verify you have published offers in Partner Center
• Check that offers are in "Live" or "Preview" status
• Ensure your Publisher ID is correct

Partial sync

• Some offer types may not be fully supported yet
• Check the sync log in Settings > Integrations > Azure > Sync History

Private Offers Not Creating

Error: Plan not found

• Ensure the plan ID exists in your offer
• Verify the plan is active and published

Error: Customer not eligible

• Check that the Azure tenant ID is correct
• Verify the customer has necessary permissions

Azure-Specific Features

Plan Management

Azure offers can have multiple plans with different pricing:

// Creating a private offer with specific plan
const offer = {
  marketplace: 'azure',
  offerId: 'your-offer-id',
  planId: 'premium-plan',
  customerTenantId: 'customer-tenant-id',
  pricing: {
    discountPercentage: 20,
    billingTerm: 'annual'
  }
};

Custom Amendments

Azure allows custom terms and amendments:

• Custom contract duration
• Custom payment schedules
• Specialized legal terms
• Amendment to existing agreements

Billing Terms

Supported billing terms for Azure private offers:

• Monthly
• Annual
• Multi-year (up to 3 years)
• Custom durations

Security Best Practices

1. Rotate client secrets every 12 months
2. Use Azure Key Vault to store secrets if calling APIs directly
3. Enable MFA on your Partner Center account
4. Review audit logs in Partner Center regularly
5. Limit API permissions to only what's necessary

Next Steps

• Create Azure private offers
• Set up SaaS metering
• Configure customer notifications
• View Azure analytics

Resources

• Azure Marketplace Documentation
• Partner Center API Reference
• Azure AD App Registration Guide

Need Help?

Contact support@automatum.io or use the in-app chat for assistance with Azure integration.