Microsoft GraphAPI interaction with Python

Office 365 administrator enthusiasts that live and breathe python may find this module useful. This module uses, and shows you how to use all API's used by Microsoft Administrators. Office 365 Management API (used to query Audit logs), Azure AD Graph API, and the MSGraphAPI. The requests for tokens is different for each of these API's. These can easily be translated to powershell if you choose.

Installation

Install directly from this repo via pip.

pip install git+https://github.com/jasonmlehman/msgraphapi.git

Alternatively, as I can't seem to get the above to work on Windows, you can clone the repo, change to the top-level directory (with the setup.py file) and use pip to install the local files in "editable" mode (-e).

git clone https://github.com/jasonmlehman/msgraphapi.git
cd msgraphapi
pip install -e .

Create a creds.json file as dicated here, copied locally (i.e. /etc/creds.json)

https://github.com/jasonmlehman/msgraphapi/blob/master/msgraphapi/creds/creds.json

How to use

Test config with the following command:

  listrolemembers -listrole TRUE -credpath /etc/creds.json

The above command should list all available office 365 roles within the tenant

To use within python to add a user to an office 365 role:

  from msgraphapi import msgraphapi

  credfile = "/etc/creds.json"
  userupn = "john.doe@somewhere.onmicrosoft.com"
  rolename = "Exchange Service Administrator"

  r = msgraphapi(credfile)

  # Get the directory objects ID
  userupnid = r.getupnid(userupn)
  roleid = r.getroleid(rolename)

  result = r.addusertorole(userupnid,roleid)
  print(result)

Prerequisites

Python 2.7
requests module
An Office 365 for business account

Confusion with which RESTful endpoint to use

There is a lot of confusion as to which RESTful endpoint one should be using. There is the Microsoft Graph API (graph.microsoft.com) and the Azure AD Graph API (graph.windows.net). Microsofts roadmap calls for developers to use the Microsoft Graph API. New functionality will be eventually be put into Microsoft Graph that may not be available with Azure AAD graph. This module will show you how to use both API's. There are some fundamental differences in which you interact with the API's. Authentication tokens, headers, etc.

Application Registration

There is a lot of confusion online about how to setup the application access for the Microsoft Graph API. Some reads will have you create something within Azure Active directory and some will have you create something on apps.dev.microsoft.com. I'll set the record straight: I ONLY created the application in Azure AD and didn't mess around with any app creation on apps.dev.microsoft.com. This allowed me to authenticate using both API's. Each time I tried to use the one created on apps.dev.microsoft.com I failed miserably. I created my application using these steps:

Sign into Azure Active directory (portal.azure.com) as a global Admin (or simply have a global admin do this for you).
Select "Azure Active Directory" from the pane on the left
Select "Enterprise Applications"
Select "New Application"
Select "Application you are developing"
Select "Ok, take me to App Registrations to register my new application."
Select "New application registration"
In "name" put in a friendly name
In the "Application Type" choose "Web App/API"
In the "Sign in/url" just put in "http://localhost"
Select "Create application"
Select "Settings-Required Permissions" You will have to give the permissions you will require depending on what you will do with the API.
Select "Keys" and generate a secret
Document application ID

Msgraphapi

Install / Use

README