# Choix — Gestion des utilisateurs (chat privé) **Date** : 2025-03-03 **Contexte** : Chatbot RAG documentaire sur le wiki Intersel --- ## 1. Accès au chat : **Privé** Le chat n’est accessible qu’aux utilisateurs **authentifiés**. --- ## 2. Authentification : **Comptes wiki** Seuls les utilisateurs ayant un compte sur le **wiki Intersel** (Dokuwiki) peuvent accéder au chatbot. - **Source de vérité** : le wiki (https://wiki.intersel.fr) - **Identifiant utilisateur** : le `username` du wiki (ex. `augustin_podvin`) **Justification** : le RAG indexe le wiki ; les utilisateurs autorisés sont ceux qui ont déjà accès au wiki. --- ### 2.1 Option privilégiée : **Cookie ou jeton du wiki** Objectif : éviter de redemander login/mot de passe. Si l’utilisateur est déjà connecté au wiki, il accède au chatbot sans ressaisir ses identifiants. | Scénario | Domaine wiki | Domaine chatbot | Faisabilité | |----------|--------------|-----------------|-------------| | **A. Même domaine** | wiki.intersel.fr | wiki.intersel.fr/chat | ✅ Le cookie Dokuwiki est envoyé au chatbot. On peut vérifier la session. | | **B. Sous-domaines** | wiki.intersel.fr | chat.intersel.fr | ⚠️ Cookie non partagé par défaut. Nécessite config cookie sur `.intersel.fr` (plugin ou config Dokuwiki). | | **C. Domaines différents** | wiki.intersel.fr | localhost ou autre | ❌ Cookie non partagé. Il faut un **jeton** passé par URL. | **Mécanismes possibles :** 1. **Cookie du wiki (scénario A ou B)** - Le chatbot reçoit le cookie de session Dokuwiki. - On appelle une page protégée du wiki (ex. `/doku.php`) avec ce cookie pour vérifier l’identité et récupérer le `username`. - Si OK → on crée une session Flask côté chatbot. 2. **Jeton passé par URL (scénario C ou lien depuis le wiki)** - Sur le wiki : lien « Accéder au chatbot » qui redirige vers `https://chatbot.../login?token=xxx`. - Le token est généré par un script/plugin sur le wiki (secret partagé, usage unique, courte durée). - Le chatbot valide le token et crée sa session. 3. **Fallback : formulaire login** - Si pas de cookie/ token valide : formulaire classique username + password, validation via `login_to_wiki()`. --- ### 2.2 Cookie PHP du wiki — fonctionnement détaillé Dokuwiki utilise des cookies PHP pour la session (observés sur wiki.intersel.fr) : | Cookie | Rôle | Attributs | |--------|------|------------| | **DW<hash>** (ex. `DW68700bfd16c2027d...`) | Authentification : contient username + mot de passe chiffrés (Blowfish). Expire en 1 an ou à la fermeture du navigateur. | HttpOnly, Secure, SameSite=Lax | | **DokuWiki** | Identifiant de session PHP (données temporaires, protection CSRF). Valeur ex. `ak9rpcmh4nt0mksfv5nj2u3l4e`. | HttpOnly, Secure, Session | | **FCK_NmSp_acl** | ACL / permissions (même valeur que DokuWiki ou lié). Optionnel pour l’auth. | HttpOnly, Secure | **Condition** : le chatbot doit être sur le **même domaine** que le wiki (ex. `wiki.intersel.fr/chat`) pour que le navigateur envoie ces cookies au serveur du chatbot. Les cookies HttpOnly ne sont pas lisibles en JavaScript ; le backend Flask les reçoit automatiquement dans le header `Cookie` des requêtes. **Flux de validation :** 1. L’utilisateur ouvre `wiki.intersel.fr/chat` (chatbot servi via reverse proxy sur le même domaine). 2. Le navigateur envoie les cookies `DW*` et `DokuWiki` avec la requête. 3. Le chatbot (Flask) reçoit la requête avec le header `Cookie`. 4. Pour valider : le chatbot fait une requête HTTP vers le wiki en **transmettant ce cookie**. 5. Le wiki vérifie le cookie et renvoie la page (ou une API). 6. Si la réponse indique « utilisateur connecté » → on extrait le `username` et on crée une session Flask. **Mise en œuvre côté wiki** (au choix) : - **Option simple** : requête GET vers `wiki.intersel.fr/doku.php` avec le cookie, puis parsing du HTML pour détecter le username (présence de « logout », lien profil, etc.). - **Option propre** : ajouter un script PHP sur le wiki (ex. `lib/exe/checkauth.php`) qui lit la session Dokuwiki et renvoie du JSON : `{"user": "augustin_podvin"}` ou `401` si non connecté. **Résumé** : oui, on peut s’appuyer sur le cookie PHP du wiki, à condition que le chatbot soit servi sur le même domaine (reverse proxy sur `wiki.intersel.fr/chat`). --- ## 3. Mémoire : **Par utilisateur** Chaque utilisateur a sa **propre mémoire** (Q/R persistées pour le RAG). - **Actuel** : mémoire globale partagée (`memory_chunks.json`, `faiss_memory_index.index`) - **Cible** : mémoire isolée par utilisateur **Options techniques** : - **A** : Fichiers séparés par user → `memory_chunks_{username}.json` + `faiss_memory_{username}.index` - **B** : Fichier unique avec champ `user_id` / `username` et filtrage à la lecture --- ## 4. Chats sauvegardés Les conversations sont **liées à l’utilisateur** et stockées en base (modèle `Chat` avec `user_id`). - **Identifiant** : `username` wiki (ou `user_id` si on garde une table `User` synchronisée) - **Routes** : `/api/save_chat`, `/api/user_chats` déjà présentes, à brancher sur l’auth wiki --- ## 5. Modèle utilisateur **Option A — Sans table User** - Auth = validation wiki uniquement - Identifiant = `username` wiki - Chats et mémoire indexés par `username` **Option B — Table User synchronisée** - À la 1ère connexion wiki réussie : création/mise à jour d’un `User` (email optionnel si le wiki l’expose) - `user_id` = clé pour chats et mémoire - Permet d’enrichir le profil plus tard (nom, email, etc.) --- ## 6. Sessions - **Flask sessions** (cookies sécurisés) ou **JWT** - Stockage côté client : cookie httpOnly (sessions) ou token (JWT) - Durée de session à définir (ex. 24 h, 7 jours) --- ## 7. Récapitulatif des impacts | Composant | Modification | |-----------|--------------| | `src/agent_ai/auth.py` | Réutiliser `login_to_wiki` pour l’auth utilisateur | | `src/api/routes.py` | Remplacer signup/signin par auth wiki ; sécuriser save_chat, user_chats | | `src/service/memory_service.py` | Mémoire par user (fichiers ou champ user) | | `src/service/qa_service.py` | Passer `user_id`/`username` pour la mémoire | | `src/api/qa_routes.py` | Exiger une session/token valide | | `src/templates/index.html` | Rediriger vers login si non connecté ; charger chats via API | | `src/templates/login.html` | Formulaire username + password wiki (pas email) | | `src/templates/register.html` | Supprimer ou remplacer par « Créer un compte sur le wiki » | --- ## 8. Points à trancher - [ ] **Déploiement** : chatbot sur même domaine que le wiki (A), sous-domaine (B) ou domaine différent (C) ? - [ ] **Auth wiki** : cookie (A/B) ou jeton URL (C) en priorité ? - [ ] Option A ou B pour le modèle utilisateur (sans/avec table User) - [ ] Option A ou B pour la mémoire (fichiers séparés vs fichier unique) - [ ] Sessions Flask vs JWT - [ ] Durée de session - [ ] Gestion du logout (invalidation session / token)