CHOIX.md 7.0 KB

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)