Skip to content

All Django Settings options

Setting Description
MICROSOFT_SSO_ALLOWABLE_DOMAINS List of domains that will be allowed to create users. Default: []
MICROSOFT_SSO_ALWAYS_UPDATE_USER_DATA If true, update default user info from Microsoft data at every login. This will also make their password unusable. Otherwise, all of this happens only on create. Default: False
MICROSOFT_SSO_AUTHENTICATION_BACKEND The authentication backend to use. Default: None
MICROSOFT_SSO_AUTHORITY A info that defines the token authority. You should set it with your tenant URL or AuthorityBuilder instance. Default: None
MICROSOFT_SSO_AUTO_CREATE_FIRST_SUPERUSER If True, the first user that logs in will be created as superuser if no superuser exists in the database at all. Default: False
MICROSOFT_SSO_AUTO_CREATE_USERS Enable or disable the auto-create users feature. Default: True
MICROSOFT_SSO_CALLBACK_DOMAIN The netloc to be used on Callback URI. Default: None
MICROSOFT_SSO_CLIENT_ID The Microsoft OAuth 2.0 Web Application Client ID. Default: None
MICROSOFT_SSO_CLIENT_SECRET The Microsoft OAuth 2.0 Web Application Client Secret. Default: None
MICROSOFT_SSO_ENABLE_LOGS Show Logs from the library. Default: True
MICROSOFT_SSO_ENABLE_MESSAGES Show Messages using Django Messages Framework. Default: True
MICROSOFT_SSO_ENABLED Enable or disable the plugin. Default: True
MICROSOFT_SSO_GRAPH_TIMEOUT The timeout in seconds for the Microsoft Graph API requests. Default: 10
MICROSOFT_SSO_LOGIN_FAILED_URL The named url path that the user will be redirected to if an authentication error is encountered. Default: admin:index
MICROSOFT_SSO_LOGO_URL The URL of the logo to be used on the login button. Default: https://purepng.com/public/uploads/large/purepng.com-microsoft-logo-iconlogobrand-logoiconslogos-251519939091wmudn.png
MICROSOFT_SSO_NEXT_URL The named url path that the user will be redirected if there is no next url after successful authentication. Default: admin:index
MICROSOFT_SSO_PRE_CREATE_CALLBACK Callable for processing pre-create logic. Default: django_microsoft_sso.hooks.pre_create_user
MICROSOFT_SSO_PRE_LOGIN_CALLBACK Callable for processing pre-login logic. Default: django_microsoft_sso.hooks.pre_login_user
MICROSOFT_SSO_PRE_VALIDATE_CALLBACK Callable for processing pre-validate logic. Default: django_microsoft_sso.hooks.pre_validate_user
MICROSOFT_SSO_PROJECT_ID The Microsoft OAuth 2.0 Project ID. Default: None
MICROSOFT_SSO_SAVE_ACCESS_TOKEN Save the access token in the session. Default: False
MICROSOFT_SSO_SAVE_BASIC_MICROSOFT_INFO Save basic Microsoft info on database. Default: True
MICROSOFT_SSO_SCOPES The Microsoft OAuth 2.0 Scopes. Default: ["User.ReadBasic.All"]
MICROSOFT_SSO_SESSION_COOKIE_AGE The age of the session cookie in seconds. Default: 3600
MICROSOFT_SSO_SHOW_FAILED_LOGIN_MESSAGE Show a message on browser when the user creation fails on database. Default: False
MICROSOFT_SSO_STAFF_LIST List of emails that will be created as staff. Default: []
MICROSOFT_SSO_SUPERUSER_LIST List of emails that will be created as superuser. Default: []
MICROSOFT_SSO_TEXT The text to be used on the login button. Default: Sign in with Microsoft
MICROSOFT_SSO_TIMEOUT The timeout in seconds for the Microsoft SSO authentication returns info, in minutes. Default: 10
MICROSOFT_SSO_UNIQUE_EMAIL When get or create a new user, check if the email already exists. Default: False
SSO_SHOW_FORM_ON_ADMIN_PAGE Show the form on the admin page. Default: True
SSO_USE_ALTERNATE_W003 Use alternate W003 warning. You need to silence original templates.E003 warning. Default: False