Voir la source de Authentification OpenID par Authelia

L'annuaire des utilisateurs Sigma est disponible pour l'authentification auprès de sites binets tiers à travers le protocole [https://fr.wikipedia.org/wiki/OpenID OpenID].

Le serveur d'authentification est situé à l'adresse [https://auth.binets.fr auth.binets.fr] et est une instance [https://www.authelia.com/ Authelia].

Pour permettre à votre site de bénéficier de ce moyen d'authentification, faites un [https://panix.binets.fr ticket Panix] en précisant l'url complète de callback vers laquelle Authelia redirigera l'utilisateur après une connexion réussie. La demande doit être justifiée, suite à quoi un BRman ajoutera votre site à la liste des bénéficiaires autorisés.

==Comment ça marche ?==
TODO: expliquer le flow, les scopes

==Informations disponibles==

Les informations disponibles sur authelia pour un utilisateur sont :
* email ;
* uid ;
* Prénom NOM ;
* groupes Sigma (seulement les groupes dont on est membre).

==Example d'implémentation==
===Pour Node.js et Adonis JS===

Le protocole OpenID est très commun, et de nombreux packets existent qui nous simplifieront la vie. Pour tous les backend basés sur Node.js (Adonis JS, nest.js, Express...), il est possible d'utiliser le packet [https://www.npmjs.com/package/openid-client openid-client].

Voici un example pour Adonis JS, qui s'adapte à tout backend basé sur Node.js, sur [https://gitlab.binets.fr/svg/example-backend/-/blob/main/app/Controllers/auth/authSigmaUser.ts Gitlab].

Cette implémentation nécessite:
* Qu'une route (comme <code>/auth/sigmaUser/login/</code>) pointe vers la fonction<code>loginSigmaUser</code>
* Que la route <code>/auth/sigmaUser/callback/</code> pointe vers la fonction <code>callbackSigmaUser</code>
* Une base de données avec trois colonnes: state, codeVerifier et date de création
* Un cron (fonction qui s'éxécute régulièrement, par exemple une fois par jours) qui supprime les lignes de la base de donnée susnommée qui sont trop vieilles (par exemple vieilles de plus d'une heure). Voir l'[https://gitlab.binets.fr/svg/example-backend/-/blob/main/app/Controllers/cron.ts implémentation du cron] (qui est ici exécuté lorsqu'un autre programme fait une requête à une certaine route)

Le cron est nécessaire, car si un utilisateur commence à se connecter, une nouvelle ligne est crée dans la base de données. Elle est ensuite supprimée lorsqu'il a tapé ses identifiants. Si l'utilisateur ne tape jamais ses identiiants, la ligne n'est jamais supprimée, d'où la nécessité du cron.

===Utilisation du serveur Authelia de test===

L'exemple précédent utilise le serveur réel du BR, mais il est préférable d'utiliser un serveur de test sur ton ordinateur pendant que tu développes.

Pour ce faire, clone ce [https://gitlab.binets.fr/br/docker-openid repo] sur ton pc.

L'adresse du serveur d'authentification devient alors <code>http://localhost:9091</code> au lieu de <code>https://auth.binets.fr</code> (il faut donc changer la variable <code>AUTH_URL</code> de l'exemple précédent)

Pour lancer le serveur de test fait <code>docker compose up</code>