Skip to main content

Ripple – Connect Azure Cost Data to Ripple

How to connect your Azure CSP cost data to Ripple using Microsoft Partner Center.

Written by Yo Fukuda

Overview

This guide walks you through connecting your Azure CSP cost data to Ripple via the Microsoft Partner Center API. The process takes approximately 5–8 minutes, though some steps require navigating multiple Azure portals.


Why Ripple Needs Partner Center Access

Ripple connects to your Microsoft Partner Center to retrieve the data needed to manage your Azure CSP billing. Specifically, Partner Center access allows Ripple to:

  • Import your subscription list — Subscriptions are imported into Ripple as Ripple Customers, which can then be added to Billing Groups and included in invoices

  • Retrieve subscription details — Information such as subscription status and type helps Ripple determine the correct calculation method for each subscription when generating invoices

  • Check invoice finalisation status — Partner Center provides invoice metadata that tells Ripple when an invoice has been finalised, which determines when Ripple can retrieve billed consumption data

Your data stays yours. Ripple only reads the subscription and invoice metadata necessary to calculate and generate your invoices. We do not store, share, or use your customer list for any purpose outside of your Ripple account. Access is scoped strictly to what is needed for billing.


Prerequisites

Before you begin, ensure you have the following:

  • An active Azure CSP account with Microsoft Partner Center access

  • A user with Global Admin Agent privileges — several steps in this guide require admin-level access

  • MFA authentication device ready — admin accounts typically have MFA enabled; have your device on hand before starting

  • A secure place to save credentials — you will collect the following during this process:

Partner ID (7-digit number): 
App ID / Client ID:
Account ID:
Secret Key:
Directory (Tenant) ID:

Step 1: Retrieve Partner Center Credentials

Find your Partner ID

  1. Sign in to Partner Center as a Global Admin and select the Settings (gear) icon

  2. Go to Account settings > Legal info

    1. (Note: Your Microsoft AI Cloud Partner Program and CSP credentials may differ)

  3. Select Identifiers

  4. Copy and save the 7-digit Partner ID displayed

Find your App ID / Client ID and Secret Key

  1. Sign in to Partner Center using your Global Admin account

  2. From the Settings menu (gear icon), select Partner settings

    • If Partner settings is not available, select Account settings instead

  3. Select App management

  4. If no app exists yet, add a new Web app. If one already exists, click Add key

  5. After the key is generated, copy and save the following:

    • App ID / Client ID

    • Secret Key


Step 2: Register an Application in Azure Portal

You will need the following from this step:

1. Application (client) ID: 
2. Directory (tenant) ID:
3. Client secret value:

Create an App Registration

  1. Sign in to the Azure Partner Dashboard using your Global Admin account

  2. From the left menu, click Azure Active Directory

  3. In Azure Active Directory, click App registrations from the left menu

  4. Click + New registration at the top of the page

  5. Enter a name of your choice (e.g., Ripple-Azure-CSP)

  6. Select your application user name and choose [Your Org] only – Single tenant, then set the following Redirect URL for API access:

    1. Use the Next environment URL only if you are testing in the staging environment. For standard integration, use the Production URL.

Add API Permissions

In rare cases, searching by ID may return a different API. If this happens, search by the API name "Microsoft Partner Center" instead.

API

Permission

Microsoft Partner Center

(fa3d9a0c-3fb0-42cc-9193-47c7ecd2edbd)

Access Partner Center

Microsoft Graph

Application permissions:

PartnerBilling.Read.All

Microsoft Partner

(4990cffe-04e8-4e8b-808a-1175604b879f)

Partner Center


Granting API Permissions to the Application User

  1. Click on the application user you just created

  2. In the application management screen, click API permissions from the left menu

  3. Click + Add a permission

  4. In the panel that appears on the right, select APIs my organization uses

  5. Add the following APIs:

    • Microsoft Partner Center (fa3d9a0c-3fb0-42cc-9193-47c7ecd2edbd)

      • Access Partner Center

    • Microsoft Graph (00000003-0000-0000-c000-000000000000)

      • User.Read

    • Microsoft Partner (4990cffe-04e8-4e8b-808a-1175604b879f)

      • Partner Center

  6. After selecting all three API permissions, return to the API permissions screen and click ✔ Grant admin consent for [Your Org], then click Yes to confirm

  7. Go to Overview in the left menu and copy and save your Application (client) ID and Directory (tenant) ID

Generating a Client Secret

This step must be performed by a user with Global Admin privileges.

  1. From the left menu, click Certificates & secrets

  2. Click + New client secret

    • Description: optional (e.g., Client secret for Ripple-Azure-CSP API integration)

    • Expiration: 1 year is recommended

  3. Set the description and expiration, then click Add

  4. Copy and save the Value of the newly created Client Secret immediately — it will not be shown again


Step 3: Configure Ripple

How to Connect Your Partner Center Credentials

  1. Log in to Ripple using your browser's Incognito / Private mode to avoid cache-related authentication issues

    1. Notes Using Incognito / Private mode helps prevent authentication errors caused by cached sessions.

  2. From the left menu, go to Settings > Azure Settings

  3. Under Onboarding Cloud Solution Provider (CSP) to Ripple, enter the Partner ID you saved in Step 1

  4. Under Partner Center credentials, enter the Account ID, Application ID, and Secret Key from Step 1

  5. Under Partner API credentials, enter the Application (client) ID, Directory (tenant) ID, and Client secret from Step 2

  6. Click Next in the bottom right — you will be redirected to the Azure authentication page.

  7. Sign in with your Global Admin account to complete authentication

  8. After successful authentication, a secret code will be generated automatically. Review it, then click Done in Ripple to finish


Reference


Need More Help?

If any errors occur during the process or if you have any questions, please reach out to us:

Did this answer your question?