Skip to content
Snippets Groups Projects
Commit eaff1be7 authored by Nik | Klampfradler's avatar Nik | Klampfradler
Browse files

Merge branch '438-2fa-check-integration-of-django-two-factor-auth-and-allauth-2' into 'master'

Add docs about social accounts

See merge request !889
parents 54555ace 37240931
No related branches found
No related tags found
1 merge request!889Add docs about social accounts
Pipeline #49341 canceled
docs/_static/create_social_application.png

41 KiB

Social accounts
===============
AlekSIS can authenticate users against third party applications using OAuth2
or OpenID.
.. warning::
Social accounts are **not** working with two factor authentication! If a user
authenticates with a social account, the two factor authentication is
ignored on login (but enforced for views that require two factor authentication later).
Configuring social account provider
-----------------------------------
For available providers, see documentation of `django-allauth
<https://django-allauth.readthedocs.io/en/latest/providers.html>`_.
A new social account provider can be configured in your configuration file
(located in ``/etc/aleksis/``).
Configuration example::
[auth.providers.gitlab]
GITLAB_URL = "https://gitlab.exmaple.com"
After configuring a new auth provider, you have to restart AlekSIS and configure client id and secret in the Backend Admin interface.
Click "Social applications" and add a new application. Choose your
provider and enter client id and secret from your application and choose
your site:
.. image:: ../_static/create_social_application.png
:width: 400
:alt: Create social application
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment