Metadata-Version: 2.1
Name: ms-partner-tools
Version: 0.1.0
Summary: SDK for interacting with the Microsoft Partner Center
Home-page: https://github.com/techstormpc/ms-partner-tools
Author: TechStorm PC
Author-email: nathan@techstormpc.com
License: MIT
Description: # 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"]}')
        ```
        
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
