Skip to content


This guide explains how to setup SAML2 authentication. Local authentication will continue to work.

Verified compatibility

SAML2 provider Does it work?
Microsoft Azure Enterprise App ✅

Install django3-auth-saml2

# echo 'django3-auth-saml2>=0.5.0' >> local_requirements.txt
# pip3 install -r local_requirements.txt


Create a new configuration file called in the same directory as the (e.g. /opt/peeringmanager/peering_manager/). Define all of the following settings in this file.

    # Using default remote backend
    'AUTHENTICATION_BACKEND': 'django.contrib.auth.backends.RemoteUserBackend',

    # Metadata is required
    'METADATA_AUTO_CONF_URL': "{AZURE_TENANT_ID}/federationmetadata/2007-06/federationmetadata.xml?appid={AZURE_APP_ID}",

    'ENTITY_ID': ""

Further settings are available, please see django3-auth-saml2 documentation, if needed.