semvec/pypi-packages huggingface dataset:
ms-partner-tools 0.1.1
SDK for interacting with the Microsoft Partner Center
License: MIT

# MS Partner Tools
[![SonarCloud](https://sonarcloud.io/images/project_badges/sonarcloud-black.svg)](https://sonarcloud.io/summary/new_code?id=techstormpc_ms-partner-tools)

[![PyPI](https://img.shields.io/pypi/v/ms-partner-tools.svg)](https://pypi.org/project/ms-partner-tools/#description)

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

```bash
$ 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

```python
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"]}')
```