/ms-partner-tools

Python library for interacting with the Microsoft Partner Center

Primary LanguagePythonMIT LicenseMIT

MS Partner Tools

SonarCloud

PyPI

Wrapper for the Microsoft Partner Center REST API.

Supports Python 3.8+.

Currently, only a few Partner Center interactions are supported:

  • Enrolling devices in Autopilot on your customers tenant
  • Listing customers
  • Listing devices in a batch group

Installation

pip install ms-partner-tools

or clone the repo and run python setup.py install.

App Registration

In the Azure AD portal, create a new App registration.

Under API permissions, add the Microsoft Partner Center user_impersonation permission. You can search for it under "APIs my organization uses". Please note that this only supports delegated permissions, not application permissions.

The device code flow requires the "Allow public client flows" option to be turned on. This needs a client secret.

If the interactive auth flow is used, you must add the "Mobile and desktop applications" platform and set the "Redirect URI" to http://localhost:8400.

Sample Usage

CLI

You must first run partnertools-cli configure to set up the authentication details (from the app registration).

Registering a device

$ partnertools-cli register-device
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code <CODE> to authenticate.
? Please select a customer: Test Customer - (00000000-0000-0000-0000-000000000000)
? Please select a device type: Surface Laptop 4 - Microsoft Corporation
? Please enter the serial number: 000000 

Device was added

SDK

Listing customers

import os
from partner_tools.auth import DeviceCode
from partner_tools import PartnerTools

client = PartnerTools(auth_info=DeviceCode(
    client_id=os.getenv('CLIENT_ID'),
    client_secret=os.getenv('CLIENT_SECRET'),
    tenant_id=os.getenv('TENANT_ID')
))

customers = client.customer.get_customers()

for customer in customers:
    print(f'Customer: {customer["companyProfile"]["companyName"]}, Tenant ID: {customer["id"]}')