From d578e5c70793750b2dc2ff0eadde74d10aaaa369 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Martin=20P=C3=A9pin?= <kerl@wkerl.me>
Date: Sat, 5 Sep 2020 22:53:26 +0200
Subject: [PATCH 1/2] More documentation

---
 README.md | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 61 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 7bfb31d..7410c10 100644
--- a/README.md
+++ b/README.md
@@ -40,9 +40,10 @@ urlpatterns = [
 ```
 
 La page de connexion principale de AuthENS est ensuite accessible via l'url
-nommée `"authens:login"`.
-Par commodité, AuthENS rend accessible la page de déconnexion par défaut de
-Django sous le nom `"authens:logout"`.
+nommée `authens:login`.
+La page de déconnexion est `authens:logout`, il est important d'utiliser cette
+vue est non la vue de déconnexion par défaut de Django pour déconnecter du CAS
+en plus du site.
 
 ### Dans le fichier `settings.py`
 
@@ -64,6 +65,14 @@ AUTHENTICATION_BACKENDS = [
 LOGIN_URL = reverse_lazy("authens:login")
 ```
 
+- (Optionnel) Par défaut AuthENS propose les 3 modes de connexion (CAS / Vieux
+  compte CAS / mot de passe). Le mode de connexion "Vieux compte CAS" peut être
+  désactivé en ajoutant :
+
+```python
+AUTHENS_USE_OLDCAS = False
+```
+
 - (Optionnel) AuthENS utilise le paramètre Django standard
   [`LOGIN_REDIRECT_URL`](https://docs.djangoproject.com/en/3.0/ref/settings/#login-redirect-url)
   par défaut pour rediriger l'utilisateurice en cas de connexion réussie.
@@ -79,7 +88,53 @@ En revanche lorsqu'un nouveau compte est créé manuellement et que ce compte
 correspond à un compte clipper, il faut enregistrer ce compte auprès d'AuthENS,
 autrement le compte Django et le compte clipper seront considérés comme deux
 comptes différents.
+Authens fournit une fonction `register_cas_account` pour cela.
 
-**TODO:** écrire le helper qui fait une requête sur le LDAP pour trouver tout
-seul la date de création de compte. Ça ressemblera à quelque chose du genre
-`register_clipper(user, login_clipper)`.
+Exemple:
+
+```python
+from authens.shortcuts import register_cas_account
+from django.http import HttpResponseRedirect
+from yourapp.forms import UserCreationForm
+
+def create_user_view(requests, cas_login: str):
+    if request.method == "POST":
+        form = UserCreationForm(request.POST)
+        if form.is_valid():
+            user = form.save()
+            register_cas_account(user, cas_login)
+            return HttpResponseRedirect("success.html")
+    else:
+        form = UserCreationForm()
+
+    return render(request, "create_user.html", {"form": form}
+```
+
+
+## Migration depuis `django_cas_ng`
+
+Pour migrer depuis `django_cas_ng`, il est recommandé de faire une
+[data migration](https://docs.djangoproject.com/en/3.1/howto/writing-migrations/#migrating-data-between-third-party-apps)
+et d'appliquer la fonction `register_cas_account` sur tou⋅tes les
+utilisateurices.
+
+Dans le cas où certain⋅es utilisateurices n'ont pas de clipper, on peut d'abord
+tester leur exitence dans le LDAP du SPI de la façon suivante:
+
+```python
+from authens.models impomrt CASAccount
+from authens.shortcuts import fetch_cas_account
+
+def migrate_user(user: User):
+    # On regarde si `user` existe dans le LDAP du SPI
+    ldap_info = fetch_cas_account(user.username)
+    if ldap_info:
+        # Si oui, on enregiste `user` en tant que compte CAS.
+        # Les deux lignes suivantes sont équivalentes à appeler
+        # `register_cas_account(user, user.username)` mais nous économisent une
+        # requête au LDAP.
+        entrance_year = ldap_info["entrance_year"]
+        CASAccount.objects.create(
+            user=user, cas_login=user.username, entrance_year=entrance_year
+        )
+```

From d44e17d3d376f2830b076a4d3309c5b56569ebdd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Martin=20P=C3=A9pin?= <kerl@wkerl.me>
Date: Sat, 21 Nov 2020 12:14:24 +0100
Subject: [PATCH 2/2] typo

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7410c10..00c76a4 100644
--- a/README.md
+++ b/README.md
@@ -119,7 +119,7 @@ et d'appliquer la fonction `register_cas_account` sur tou⋅tes les
 utilisateurices.
 
 Dans le cas où certain⋅es utilisateurices n'ont pas de clipper, on peut d'abord
-tester leur exitence dans le LDAP du SPI de la façon suivante:
+tester leur existence dans le LDAP du SPI de la façon suivante:
 
 ```python
 from authens.models impomrt CASAccount