azauthlib is a Python library that streamlines the authentication process with Azure Microsoft Graph. From interactive logins to client credentials flow, azauthlib provides an intuitive interface, robust token management, and a GUI for seamless configuration.

🔐 Whether you're building applications that interact with Microsoft Graph APIs or automating workflows, azauthlib has you covered.

✨ Features ✨

✅ Multiple Authentication Flows

• Silent Authentication
• Interactive Authentication
• Device Code Flow
• Client Credentials

✅ Graphical User Interface (GUI)

• Configure credentials with an easy-to-use GUI.

✅ Token Management

• Automatic refresh for access tokens
• Secure token storage

✅ Flexible Environment Configuration

• Use .env files, OS variables, or direct input.

✅ Customizable Permissions

• Specify Microsoft Graph API scopes effortlessly.

🚀 Installation

Install from PyPI

pip install azauthlib

Install from Source

git clone https://github.com/cedricmoorejr/azauthlib.git
cd azauthlib
pip install .

📋 Requirements

• Python 3.7+
• msal
• portalocker
• python-dotenv

Install dependencies manually if needed:

pip install -r requirements.txt

🛠 Getting Started

1️⃣ Prerequisites

• Register an app in Azure Active Directory via the Azure Portal.

• Collect the following:

  • CLIENT_ID
  • TENANT_ID
  • (Optional) CLIENT_SECRET

• Assign the appropriate Microsoft Graph API permissions.

2️⃣ Configuration Options

🌐 Option A: GUI Mode

Launch the GUI for intuitive configuration:

python config_app.py

💡 What You Can Do in the GUI:

• Enter credentials (CLIENT_ID, TENANT_ID, etc.).
• Choose your authentication method.
• Credentials are saved securely in a .env file.

🛠 Option B: Non-GUI Mode

1. Using Environment Variables (Recommended):

export TENANT_ID="your-tenant-id"
export CLIENT_ID="your-client-id"
export CLIENT_SECRET="your-client-secret"

2. Hardcoding in Code (⚠️ Not Recommended):

from azauthlib import Authentication

auth = Authentication(scopes="Files.ReadWrite.All")
auth.Build.WithEntry(
    client_id="your-client-id",
    tenant_id="your-tenant-id",
    client_secret="your-client-secret"
)

🔑 Authentication Flows

🔒 Silent Authentication

Authenticate using cached tokens.

auth.Silent()

🌐 Interactive Authentication

Prompts user to log in via a browser.

auth.Interactive()

📱 Device Code Flow

Displays a device code for cross-device authentication.

auth.DeviceCodeFlow(webbrowser_enabled=True)

🤝 Client Credentials Flow

Authenticate server-to-server.

auth.ClientCredentials()

💼 Token Management

• Access Token: Retrieve the active token.

  token = auth.access_token
  

• Token Expiry: Check token lifetime.

  print("Token expires in:", auth.token_expires_in)
  

• Automatic Refresh: Tokens are refreshed seamlessly.

📜 Logging

Easily track authentication flow and token operations using Python’s logging module. Customize as needed!

🤝 Contributing

We welcome contributions! 🚀 Here's how you can help:

1. Fork the repo.
2. Create a feature or bugfix branch.
3. Submit a PR with a detailed description.

📄 License

This project is licensed under the Apache License 2.0. See the LICENSE file for more details.

ℹ️ Trademarks

• This project references Microsoft trademarks such as Azure and Microsoft Graph. Please ensure compliance with Microsoft’s Trademark Guidelines.

🔗 GitHub Repository
💬 Feedback? Issues? We’d love to hear from you!