NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1698 most downloaded on PyPI
Python social authentication made simple.
Latest stable
7.0.0
Last release 13 days ago
09 Nov 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
61 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Assigning BaseAuth.strategy is deprecated and emits a DeprecationWarning. Type checkers now treat it as read-only. Create the backend with the intende…
BaseAuth.get_provider_error() hook for classifying provider errors in
callbacks and HTTP responses.BaseAuth.authenticate() now runs the pipeline on the backend passed in the
backend keyword argument through its new run_authentication() method.
This preserves the original backend's state when a framework such as Django
calls authenticate() on a separate backend instance. Passing a strategy
different from the supplied backend's strategy now raises
AuthConfigurationError; create the backend with the intended strategy.BaseAuth.strategy is deprecated and emits a DeprecationWarning.
Type checkers now treat it as read-only. Create the backend with the intended
strategy instead.invalid_request) or
of a deactivated user's refresh token (401 User is inactive) now raises
AuthCredentialError with reauthentication_required instead of
AuthProviderError or AuthCanceled.invalid_request failures as AuthConfigurationError.AADSTS9002325, explaining
that server-side callbacks must use the Web platform in the app registration.BaseStrategy.get_session_id(), BaseStrategy.restore_session(), and
BaseStrategy.SESSION_SAVE_KEY. Custom strategies and backends using them
must migrate to browser-bound callback correlation.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add a Weblate OpenID Connect backend with Hosted Weblate defaults, configurable issuer, PKCE, official branding, and optional legal-version storage.
get_title() method for sign-in labels.SOCIAL_AUTH_SLACK_TEAM against the workspace ID returned by Slack
before login. Configurations using a workspace name or Enterprise organization
ID must change to a workspace ID.ID_KEY values other
than mailchimp_identity; remove any old user_id override before upgrading.SOCIAL_AUTH_GOOGLE_ONETAP_KEY to
keep One Tap sign-in working.NonceMixin.consume().
New abandoned session transactions are pruned on a subsequent authorization start.next values from resolving configuration settings
into post-login redirects, which could disclose URL-like setting values.ID_KEY is configured,
preventing an account with a matching username from claiming a pre-6.0
association created under a stable identifier. Existing same-identifier
associations still re-key; deployments with older rows should review their
stored identifier keys before changing ID_KEY settings. Compatibility UID
hooks retain empty-key policy semantics and require an explicit opt-in for
unverified matches when ID_KEY is configured.PROFILE_EXTRA_PARAMS setting, preventing concurrent profile requests from
using another login's token.SubjectConfirmationData InResponseTo when the unsigned response envelope
attribute is missing, so a solicited response cannot be replayed as
IdP-initiated by stripping it.sub claims
(Not supported currently. Use oid claim. and the legacy spelling without
the space after the period) issued by user flows whose "Subject (sub) claim"
setting is "Not supported", preventing every user of such a flow from being
bound to one association. Configure
SOCIAL_AUTH_AZUREAD_B2C_OAUTH2_ID_KEY = "oid" to use the object ID claim
on those flows. Existing rows stored under the placeholder UID cannot be
attributed to a specific account and should be reviewed and removed.invalid_claim.bad_refresh_token response now raises AuthCredentialError with
reauthentication_required, like invalid_grant, instead of an
AuthProviderError.Reject missing provider user identifiers before converting them to strings, preventing absent identifiers from being stored and matched as the shared
"None".hub_id and user_id), Monzo
(user_id), WLCG (sub), Asana (data.gid), and Dropbox (account_id).
HubSpot identities are scoped to both the portal and installing user.ID_KEY after adding such a field to
their profile response.Existing social-auth rows whose UID is "None" cannot be attributed to a
specific provider account. Administrators should review and remove those rows,
then require affected users to authenticate again; they are not migrated
automatically.
Removed the Docker Hub OAuth2 backend (docker) because its authorization, token, and profile endpoints are no longer available. Remove social_core.bac
docker) because its authorization,
token, and profile endpoints are no longer available. Remove
social_core.backends.docker.DockerOAuth2 from backend configuration.
See #1176.live),
Evernote Sandbox (evernote-sandbox), PixelPin (pixelpin-openidconnect),
Behance (behance), and NGP VAN ActionID OpenID (actionid-openid). Their
authentication endpoints have been retired or are no longer available; see
#1176.
Remove social_core.backends.live.LiveOAuth2,
social_core.backends.evernote.EvernoteSandboxOAuth,
social_core.backends.pixelpin.PixelPinOpenIDConnect,
social_core.backends.behance.BehanceOAuth2, and
social_core.backends.ngpvan.ActionIDOpenID from backend configuration.
Live Connect users can configure social_core.backends.microsoft.MicrosoftOAuth2
(microsoft-graph), but identifiers are not compatible and existing account
associations are not migrated automatically. Production Evernote remains
supported. This removes the old ActionID OpenID integration, not the ActionID
service. Existing stored account associations are not deleted.(provider, id_key, uid)
lookups instead of scanning stored JSON during authentication. Configure
backend-scoped LEGACY_ID_KEYS for explicit identifier changes.ALLOW_UNVERIFIED_LEGACY_UID_MIGRATION is explicitly enabled. Missing evidence
stops authentication unless the transition's compatibility policy allows it.None for unavailable names instead of invented empty
strings, preventing logins and account associations from clearing existing
names. Name normalization still fills missing or blank fields from available
names, but preserves unavailable components when derivation produces nothing.
Explicit provider-supplied empty strings remain valid profile updates.invalidate() and refresh() controls.evidence_key
argument to migrate_social_auth() and revalidate supplied evidence atomically.
The pipeline now passes keyed legacy_identifiers; legacy_uids and
get_legacy_user_ids() remain available for compatibility.BaseAuth.get_user_names() is deprecated. Backends should return provider-supplied names from get_user_details() and leave normalization to the social_…
SOCIAL_AUTH_<BACKEND>_NONCE_LIFETIME to change the duration. Storage
integrations must persist issued and lifetime; stored nonces without
a valid lifetime are rejected.SOCIAL_AUTH_EMAIL_VALIDATION_EXPIRED_THRESHOLD to change their lifetime.
Storage integrations must persist each code's creation timestamp; undated
codes are rejected when expiry is enabled.SOCIAL_AUTH_<BACKEND>_ALLOW_UNVERIFIED_LEGACY_UID_MIGRATION.social_core.pipeline.social_auth.social_names immediately
after social_core.pipeline.social_auth.social_details to retain automatic
conversion between full names and first/last names.id_key values, accept id_key
in get_social_auth() and create_social_auth(), and implement
get_social_auth_by_extra_data() and atomic migrate_social_auth().
Existing associations use an empty identifier key until migration.AuthCredentialError with reauthentication_required
when a stored access token is expired and no renewal credential is available.
Custom backends that exchange access tokens must override get_refresh_token().groups
instead of details["groups"]. MediaWiki identity retrieval now runs in
user_data() rather than get_user_details().SocialAuthBaseException and
AuthException retain broad catch compatibility; migrate removed specialized
classes using the exception reference in social-docs.get_request_data() instead of overriding
request_data(). The latter now returns effective data for the active partial
pipeline, including confirmed external-link data.request argument. Use
strategy.request_data() for parameters and the framework strategy's
request attribute for its native request object.title and optional icon metadata for authentication
backends, with packaged icons shared with Django applications. Backend
identifiers remain unchanged; display labels follow current service branding.vk-id) with mandatory S256 PKCE, payload callbacks,
server-side profiles, and device-bound refresh tokens with automatic renewal.AUTHORITY_URL and opt-in PKCE through
USE_PKCE. Azure AD B2C exposes a logout_url() helper using policy discovery.BaseAuth.ASSOCIATION_ONLY capability for user-bound connections,
shared by Drip, Last.fm, Mixcloud, and Twilio Connect.life_science_eosc) with temporary
configuration for the EOSC federation.SOCIAL_AUTH_<BACKEND>_FIRSTLAST_FROM_FULL and
SOCIAL_AUTH_<BACKEND>_FULL_FROM_FIRSTLAST, both enabled by default.BaseAuth.get_user_names() is deprecated. Backends should return
provider-supplied names from get_user_details() and leave normalization
to the social_names pipeline step.rate_limited, including
responses with HTTP 400 or 403, so callers receive retry guidance.EXTRA_DATA entries when requesting
profile fields, and requests the supported photo_50 field while preserving
the legacy photo and user_photo response keys.OPENID_CONFIGURATION_URL overrides.get_auth_token() uses stored refresh tokens and persists refreshed
credentials instead of sending an access token as a refresh token.Added a CESID AAI OpenID Connect backend.
user argument to do_auth() and a BaseAuth.prepare_auth()
hook for backend-specific authentication initiation.FACEBOOK_COMPLETE_URI when submitting the callback.VK app authentication now fetches user profiles directly from VK and verifies that the profile ID matches the signed viewer ID, preventing forged call
AuthReauthenticationRequired, a subclass of AuthTokenError, for
OpenID Connect token refreshes that require the user to sign in again.openid, profile, and email scopes and
raises AuthTokenError when the token response lacks an ID token.Added a Helmholtz AAI OpenID Connect backend.
ALLOWED_REDIRECT_SCHEMES setting.AuthForbidden.LINE backend now validates callback state before exchanging authorization codes, preventing login CSRF.
Externally resumable partial request links now require confirmation even in the browser session that created the partial, preventing validation links
LoginRadius backend now validates callback state to prevent login CSRF.
five_hundred_px), legacy Google App Engine bundled Users
(gae), Jawbone, Moves, Mozilla Persona, Readability Parser API, and Wunderlist.google-plus / GooglePlusAuth).GitHub backend now handles scoped email fetching deterministically.
QueryDict values.This release might contain breaking changes. Review the removed backends and stricter OAuth, OpenID Connect, and Azure AD validation before upgrading.
This release might contain breaking changes. Review the removed backends and stricter OAuth, OpenID Connect, and Azure AD validation before upgrading.
AUTH_EXTRA_ARGUMENTS values are no longer overridden by request data unless
the key is listed in AUTH_EXTRA_ARGUMENTS_OVERRIDE_ALLOWLIST.sub does not
match the validated ID token subject.OpenID Connect backends can now opt in to PKCE support
Require PyJWT >= 2.12.0 to address CVE-2026-32597
storage.UserProtocol now supports read-only attributes for better type-checker compatibilitysanitize_redirect() now handles invalid redirect values that raise ValueErrorPyJWT >= 2.12.0 to address CVE-2026-32597Fixed partial pipeline handling for unauthenticated users
This project welcomes donations to make the development sustainable. The following platforms are available for funding Python Social Auth:
Improved error handling in SAML
This project welcomes donations to make the development sustainable. The following platforms are available for funding Python Social Auth:
Added registry to configure default strategy
This project welcomes donations to make the development sustainable. The following platforms are available for funding Python Social Auth:
The timeout parameter can be again configured
ID_KEY is now configurableThis project welcomes donations to make the development sustainable. The following platforms are available for funding Python Social Auth:
Fixed extra_data() invocation from refresh_token()
extra_data() invocation from refresh_token()Fixed Gitea backend API authentication headers
RelayState and attributes handling in the SAML backend
AuthMissingParameter errorid_token when not present in the responseat_hash validation in OIDCAuthTokenErrorextra_data method of backends now receives pipeline arguments as pipeline_kwargsALLOW_INACTIVE_USERS_LOGINFixed getting user info in LinkedIn authentication.
This project welcomes donations to make the development sustainable, you can fund Python Social Auth on the following platforms:
Fixed crash in partial pipelines for some backends
This project welcomes donations to make the development sustainable, you can fund Python Social Auth on following platforms:
OAuth2 backends now default to POST method
This project welcomes donations to make the development sustainable, you can fund Python Social Auth on following platforms:
fix: revert API changes from #986 by @nijel in https://github.com/python-social-auth/social-core/pull/1020
Full Changelog: https://github.com/python-social-auth/social-core/compare/4.5.5...4.5.6
chore: drop 10 years deprecated interface by @nijel in https://github.com/python-social-auth/social-core/pull/1002
HTTPError response text by @dases in https://github.com/python-social-auth/social-core/pull/1008Full Changelog: https://github.com/python-social-auth/social-core/compare/4.5.4...4.5.5
family-name with ORCIDSOCIAL_AUTH_FORCE_EMAIL_LOWERCASE.tokens alias for access_token on UserMixin which has been deprecated for 10 years now.LinkedIn supports refresh token
uid is automatically converted to string in the pipelineuid is automatically converted to string in the pipeline### Added - OpenStreetMap OAuth2 ### Changed - Etsy backend fixes
Updated Facebook API version to 18.0
OpenID Connect skips at_hash validation when missing
at_hash validation when missingredirect_name is now passed to backend on do_completenext is preserved through SAML RelayStateID_KEY is no longer configurable (it never worked)Add backend for LinkedIn OpenID Connect
Fixed Azure AD Tenant authentication with custom signing keys
ID_KEY configurableMoved Facebook Limited Login to a separate module to avoid extra dependency
Removed OpenStackDevOpenId backend
user_data method in StripeOAuth2 to return email in get_user_detailslxmlAdd backend for Hashicorp Vault OIDC backend
Add fields that populate on create but not update SOCIAL_AUTH_IMMUTABLE_USER_FIELDS
SOCIAL_AUTH_IMMUTABLE_USER_FIELDSInstagram Legacy API has been replaced with Instagram Basic Display API since the first one was deprecated, see.
Changes:
self.dataexpires_in for Zoom backendget and delete class methods for NonceMixinself.dataexpires_in for Zoom backend### Changed - Updated PyJWT version to 2.0.0 - Remove six dependency
PyJWT version to 2.0.0six dependencyFixes to Github-action release mechanism
Directly use access_token in Azure Tenant backend
access_token in Azure Tenant backendUpdated list of default user protected fields to include admin flags and password
Updated package upload method to use twine
twineReverted PR #388 due to dependency license incompatibility
Allow ignoring of default protected user fields with option SOCIAL_AUTH_NO_DEFAULT_PROTECTED_USER_FIELDS
SOCIAL_AUTH_NO_DEFAULT_PROTECTED_USER_FIELDSunidecode to cleanup usernames from unicode characterspytest version for Python2 and Python3user_details in user pipeline to allow model attributes to be updatedReplace deprecated Google+ API usage in GoogleOpenIdConnect
hmac.compare_digest for constant time comparisonsaml_config.json is included by addint it to MANIFEST.inemail_verified as part of user details on Auth0 backendversion parameter on Shopify session setupSOCIAL_AUTH_SHOPIFY_API_VERSION setting to override default API versionid attribute existence before using itlast_name from family_name in Cognito backendAuth0.com authentication backend
user_data method in AzureADOAuth2 to return access_token if
id_token is not present in responseReplace deprecated Google+ API usage with
get_user_details to return more detailsTelegram authentication backend
state parameter instead of redirect_stateuserPrincipalName to set username and email accordinglyunitest2 with Python 3unicode_literals on Slack backendsanitize_redirect to invalidate redirects like ///evil.comurlencode from sixid_tokenUpdate EvenOnline token expiration key
httpsAuthorization headerextra_data update to use the alias as key toosigned_request optional in Facebook App OAuth2 backendparams sending on GET access-token retrieval caseextras_requrie to specify python specific version dependenciesFix coinbase backend to use api v2
REDIRECT_STATE to False in FacebookOAuth2 backend.oauth_token as request headerFix using the entire SAML2 nameid string
Fix path in import BaseOAuth2 for Monzo
redirect_state usage on Disqus backendGET_ALL_EXTRA_DATA boolean flag.Use extra_data method when refreshing an access_token, ensure that auth-time is updated then
access_token, ensure that
auth-time is updated thenget_access_token method that will refresh if expiredauthenticate methodextra_dataid_token in GooglePlusAuth's AuthMissingParameterLimit Slack by team through SOCIAL_AUTH_SLACK_TEAM setting
SOCIAL_AUTH_SLACK_TEAM settingexpires to expires_in for Facebook OAuth2 backendid fetch to default to user id if not present in responseStrategy method to let implementation cleanup arguments passed to the authenticate method
Fixed broken dependencies while building the package
Store partial pipeline data in an storage class
auth_time with the last time authentication took place, use
auth_time to determine if access token expiredtestkey.pem is distributedsave_status_to_session to partialize a pipeline runDefined extras for SAML, and "all" that will install SAML and OpenIdConnect
extras for SAML, and "all" that will install SAML and OpenIdConnectauth_time in extra data by default to store the time that the authentication took placeextras requirements defined in the setup.py scriptReorganize requirements, make OpenIdConnect optional
social-core[openidconnect]Update Google+ Auth tokeninfo API version, drop support for deprecated API scopes. Refs #791.
expires_in as expires for LinkedIn OAuth2. Refs #666SOCIAL_AUTH_USER_AGENT setting to override the default User-Agent header.
Refs #752make docker-tox)callback_uri and oauth_verifier parameters on authenticated API calls.
Refs #871One column per quarter.