This Identity library is an authentication/authorization library that:
DISCLAIMER: The code in this repo is not officially supported by Microsoft and is not intended for production use. The intention of this repo is to unblock customers who would like to use a higher level API, before such an API has been migrated to an Microsoft library with official support. Migration of this API to official support is not guaranteed and is not currently on the MSAL roadmap. Please ensure to fully test any code used from this repository to ensure it works in your environment.
| Microsoft Entra ID | Microsoft Entra External ID | Microsoft Entra External ID with Custom Domain | Azure AD B2C | |
|---|---|---|---|---|
| App Registration | Following only the step 1, 2 and 3 of this [Quickstart: Add sign-in with Microsoft to a Python web app](https://learn.microsoft.com/entra/identity-platform/quickstart-web-app-python-sign-in?tabs=windows) | Follow only the page 1 of this [Tutorial: Prepare your customer tenant ...](https://learn.microsoft.com/entra/external-id/customers/tutorial-web-app-python-flask-prepare-tenant) | Coming soon. | Following only the step 1 and 2 (including 2.1 and 2.2) of this [Configure authentication in a sample Python web app by using Azure AD B2C](https://learn.microsoft.com/azure/active-directory-b2c/configure-authentication-sample-python-web-app?tabs=linux) |
| Web App Sign In & Sign Out | By using this library, it will automatically renew signed-in session when the ID token expires. * [Sample written in ](https://github.com/Azure-Samples/ms-identity-python-webapp-django) * [Sample written in ](https://github.com/Azure-Samples/ms-identity-python-webapp) * [Sample written in ](https://github.com/rayluo/python-webapp-quart) * Need support for more web frameworks? [Upvote existing feature request or create a new one](https://github.com/rayluo/identity/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc) | |||
| How to customize the login page | The default login page will typically redirect users to your Identity Provider, so you don't have to customize it. But if the default login page is shown in your browser, you can read its HTML source code, and find the how-to instructions there. | |||
| Web App Calls a web API | This library supports: + Incremental consent. If the user needs to consent to more permissions, the library will automatically redirect the user to the consent page. + Automatically cache the access token and renew it when needed They are demonstrated by the same samples above. | |||
| Web API Calls another web API (On-behalf-of) | In roadmap. | |||
| How to build the samples above from scratch | Read our [docs here](https://identity-library.readthedocs.io/en/latest/) | |||
| Other scenarios | [Upvote existing feature request or create a new one](https://github.com/rayluo/identity/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc) | |||
This package is available on PyPI. Choose the package declaration that matches your web framework:
Note: Make sure you put "identity[...]" in quotes to ensure it works in all terminals.
pip install "identity[django]"pip install "identity[flask]"pip install "identity[quart]"This library follows Semantic Versioning.
Your project should declare identity dependency with proper lower and upper bound.
You can find the changes for each version under Releases.