> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/pennersr/django-allauth/llms.txt
> Use this file to discover all available pages before exploring further.
# Supported Providers
> Complete list of 100+ authentication providers supported by django-allauth
## Overview
django-allauth supports **100+ authentication providers** across multiple protocols including OAuth 1.0a, OAuth 2.0, OpenID Connect, and SAML 2.0. Each provider can be configured independently with custom scopes, authentication parameters, and behaviors.
## Popular Providers
OAuth2 - Profile, email, calendar, drive
OAuth2 - User profile, repositories, organizations
OAuth2 - Profile, email, friends
OAuth2 - Azure AD, Office 365
OAuth2 - Sign in with Apple
OAuth2 - Profile, tweets
OAuth2 - Profile, connections
OAuth2 - Login with Amazon
OAuth2 - Self-hosted & SaaS
## All Providers (A-Z)
Voice, text, and video
Social network
Photo sharing
Korean messaging
Asian messaging
Professional network
Discussion platform
Team communication
Multimedia messaging
Messaging platform
Short video
Microblogging
Social media
Game streaming
Video platform
Russian social
Chinese social
WeChat platform
Messaging
Video conferencing
Git hosting
Self-hosted Git
Code hosting
DevOps platform
Q\&A network
Identity platform
Identity provider
Jira, Confluence
Microsoft identity
Open source IAM
SSO framework
Access management
Identity service
Enterprise SSO
Modern SSO
AWS services
Cloud storage
Cloud hosting
File storage
Note taking
Gmail, Drive, Calendar
CRM platform
Office 365, OneDrive
Self-hosted cloud
Workspace
CRM platform
E-commerce
Project management
Business suite
Cryptocurrency
Payments
Trading platform
Accounting
Trading app
Payment processing
Budget app
Genetic testing
Fitness tracking
Athletic training
Fitness devices
Photo sharing
Visual discovery
Audio streaming
Music streaming
Gaming platform
Beer tracking
Research computing
Research organization
Academic identity
Research data
Notebooks
Researcher ID
Chinese search
Korean portal
Latvian social
Korean platform
Asian messaging
Russian email
Korean search
Russian social
Russian search
Startup platform
Task management
Project management
Blizzard gaming
Education platform
Norwegian education
Enterprise communication
Music database
Medical network
Email marketing
Payment API
Education platform
Online learning
Event management
Gaming
Life tracking
RSS reader
Lark platform
Design tool
Photography
Elite Dangerous
Mozilla identity
Creator platform
Chess platform
Email marketing
Email server
Wiki platform
Event platform
Collaboration
Mapping platform
Creator support
Read later
File sharing
Stock social
Microsoft services
Professional network
Yahoo services
## Protocol Categories
### OAuth 2.0 Providers
Most modern providers use OAuth 2.0. These require:
* Client ID and secret from provider's developer portal
* Redirect URI configuration
* Optional scope configuration
**Popular OAuth2 providers**: Google, GitHub, Facebook, Microsoft, Twitter (v2), LinkedIn, Amazon
### OAuth 1.0a Providers
Legacy OAuth protocol, still used by some providers:
**OAuth1 providers**: Twitter (original), Flickr, Discogs
### OpenID Connect (OIDC)
Modern identity layer built on OAuth 2.0:
* Standardized user info endpoint
* ID tokens with user claims
* Discovery via .well-known endpoints
* Support for multiple independent providers
**Configuration**:
```python theme={null}
SOCIALACCOUNT_PROVIDERS = {
'openid_connect': {
'APPS': [
{
'provider_id': 'my-sso',
'name': 'Company SSO',
'client_id': 'client-id',
'secret': 'client-secret',
'settings': {
'server_url': 'https://sso.company.com',
},
},
],
}
}
```
### SAML 2.0
Enterprise SSO protocol:
* XML-based authentication
* Support for multiple Identity Providers
* Complex attribute mapping
* Metadata exchange
**Installation**:
```bash theme={null}
pip install "django-allauth[saml]"
```
**Configuration**:
```python theme={null}
SOCIALACCOUNT_PROVIDERS = {
'saml': {
'APPS': [
{
'name': 'Company SAML',
'provider_id': 'urn:company.com',
'client_id': 'company-slug',
'settings': {
'idp': {
'entity_id': 'urn:company.com',
'metadata_url': 'https://company.com/saml/metadata',
},
},
},
],
}
}
```
## Provider Setup Guide
### 1. Add to INSTALLED\_APPS
```python theme={null}
INSTALLED_APPS = [
# ...
'allauth.socialaccount.providers.google',
'allauth.socialaccount.providers.github',
# Add more providers as needed
]
```
### 2. Register App with Provider
Each provider requires app registration:
1. Visit provider's developer portal
2. Create new OAuth application
3. Configure redirect URI: `https://yourdomain.com/accounts/{provider}/login/callback/`
4. Note client ID and secret
### 3. Configure in Django
Settings-based:
```python theme={null}
SOCIALACCOUNT_PROVIDERS = {
'provider_name': {
'APPS': [
{
'client_id': 'your-client-id',
'secret': 'your-secret',
},
],
}
}
```
Or via Django admin at `/admin/socialaccount/socialapp/`
## Provider-Specific Guides
### Google
**Developer Console**: [https://console.developers.google.com/](https://console.developers.google.com/)
**Configuration**:
```python theme={null}
INSTALLED_APPS = [
'allauth.socialaccount.providers.google',
]
SOCIALACCOUNT_PROVIDERS = {
'google': {
'APPS': [
{
'client_id': 'your-client-id.apps.googleusercontent.com',
'secret': 'your-client-secret',
},
],
'SCOPE': ['profile', 'email'],
'AUTH_PARAMS': {
'access_type': 'online',
},
'OAUTH_PKCE_ENABLED': True,
}
}
```
**Redirect URI**: `https://yourdomain.com/accounts/google/login/callback/`
**One Tap Sign-In**:
```html theme={null}
```
### GitHub
**Developer Settings**: [https://github.com/settings/applications/new](https://github.com/settings/applications/new)
**Configuration**:
```python theme={null}
INSTALLED_APPS = [
'allauth.socialaccount.providers.github',
]
SOCIALACCOUNT_PROVIDERS = {
'github': {
'APPS': [
{
'client_id': 'your-github-client-id',
'secret': 'your-github-secret',
},
],
'SCOPE': ['user', 'repo', 'read:org'],
'VERIFIED_EMAIL': True,
}
}
```
**Redirect URI**: `https://yourdomain.com/accounts/github/login/callback/`
**GitHub Enterprise**:
```python theme={null}
SOCIALACCOUNT_PROVIDERS = {
'github': {
'GITHUB_URL': 'https://github.company.com',
}
}
```
### Facebook
**Developer Portal**: [https://developers.facebook.com/](https://developers.facebook.com/)
**Configuration**:
```python theme={null}
INSTALLED_APPS = [
'allauth.socialaccount.providers.facebook',
]
SOCIALACCOUNT_PROVIDERS = {
'facebook': {
'APPS': [
{
'client_id': 'your-app-id',
'secret': 'your-app-secret',
},
],
'METHOD': 'oauth2',
'SCOPE': ['email', 'public_profile'],
'FIELDS': [
'id',
'email',
'name',
'first_name',
'last_name',
'verified',
],
'VERIFIED_EMAIL': False,
}
}
```
### Microsoft / Azure AD
**Azure Portal**: [https://portal.azure.com/](https://portal.azure.com/)
**Configuration**:
```python theme={null}
INSTALLED_APPS = [
'allauth.socialaccount.providers.microsoft',
]
SOCIALACCOUNT_PROVIDERS = {
'microsoft': {
'APPS': [
{
'client_id': 'your-application-id',
'secret': 'your-client-secret',
},
],
'TENANT': 'common', # or your tenant ID
}
}
```
### Apple
**Developer Portal**: [https://developer.apple.com/](https://developer.apple.com/)
**Configuration**:
```python theme={null}
INSTALLED_APPS = [
'allauth.socialaccount.providers.apple',
]
SOCIALACCOUNT_PROVIDERS = {
'apple': {
'APPS': [
{
'client_id': 'com.yourcompany.service',
'secret': 'your-secret',
'key': 'your-key-id',
'settings': {
'certificate_key': '''-----BEGIN PRIVATE KEY-----
Your private key here
-----END PRIVATE KEY-----''',
},
},
],
}
}
```
### Twitter (OAuth2)
**Developer Portal**: [https://developer.twitter.com/](https://developer.twitter.com/)
**Configuration**:
```python theme={null}
INSTALLED_APPS = [
'allauth.socialaccount.providers.twitter_oauth2',
]
SOCIALACCOUNT_PROVIDERS = {
'twitter_oauth2': {
'APPS': [
{
'client_id': 'your-client-id',
'secret': 'your-client-secret',
},
],
}
}
```
## Common Scopes Reference
### Google Scopes
* `profile`: Basic profile information
* `email`: Email address
* `openid`: OpenID Connect
* `https://www.googleapis.com/auth/calendar`: Calendar access
* `https://www.googleapis.com/auth/drive`: Drive access
### GitHub Scopes
* `user`: Read user profile
* `user:email`: Access email addresses
* `repo`: Full repository access
* `read:org`: Read organization data
* `gist`: Gist access
### Facebook Permissions
* `public_profile`: Basic profile
* `email`: Email address
* `user_friends`: Friends list
* `user_birthday`: Birthday
### Microsoft Scopes
* `openid`: OpenID Connect
* `profile`: User profile
* `email`: Email address
* `User.Read`: Read user profile
* `offline_access`: Refresh tokens
## Testing Providers
### Development Redirect URIs
For local testing:
* `http://127.0.0.1:8000/accounts/{provider}/login/callback/`
* `http://localhost:8000/accounts/{provider}/login/callback/`
### Production Redirect URIs
* `https://yourdomain.com/accounts/{provider}/login/callback/`
* `https://www.yourdomain.com/accounts/{provider}/login/callback/`
Configure both HTTP and HTTPS redirect URIs in provider settings if needed for development vs production.
## Template Usage
### Login Links
```html theme={null}
{% load socialaccount %}
Login with Google
Login with GitHub
```
### With Next Parameter
```html theme={null}
{% load socialaccount %}
Login with Google
```
### Display Connected Accounts
```html theme={null}
{% load socialaccount %}
{% get_social_accounts user as accounts %}
{% for account in accounts %}
Connected: {{ account.provider }} - {{ account }}
{% endfor %}
```
## Next Steps
Detailed configuration options for providers
Customize scopes, adapters, and provider behavior