Skip to content
Snippets Groups Projects
Commit ebad0bbe authored by Tom Teichler's avatar Tom Teichler :beers:
Browse files

[Docs] Add documentation about social accounts

parent ed3ce706
No related branches found
No related tags found
1 merge request!889Add docs about social accounts
Pipeline #49337 canceled
docs/_static/create_social_application.png

41 KiB

Social accounts
===============
AlekSIS can authenticate users against third party applications using OAuth2
or OpenID
.. warning::
Socialaccounts are NOT working with two factor authentication! If a user
authenticates with a social account, the two factor authentication is
ignored! Will be fixed in a future release.
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 your AlekSIS
instance and configure client id and secret in the Backend Admin interface,
located at `https://aleksis.example.com/admin <https://aleksis.example.com/admin>`_.
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