Licence RAG

Serveur de licences du parc Ocade RAG

Licences

0 active

0 active0 suspendue0 révoquée0 expirée

Vérifications

0

0 site actif

appels de vérification cumulés

Catalogue plugins

0 plugin

0 licence équipée · gouvernance par liste blanche

Relance fin de maintenance (J-30)

Un e-mail part à toutes ces adresses un mois avant la fin de maintenance d'une licence, pour relancer le client. Ces adresses reçoivent aussi les alertes d'e-mails en panne des instances.

Aucun destinataire : aucune relance ne sera envoyée.

Chargement...

Catalogue plugins

Miroir du groupe GitLab plugins-ocade-rag. L'interrupteur « Disponible » rend un plugin proposable à tous les sites (réglage général, distinct des droits de chaque licence).

Aucun plugin. Cliquez sur « Synchroniser GitLab » pour remonter le catalogue.

Guide technique complet — fonctionnement, anti-triche, variables & pièges

Chaque instance RAG Platform (le « produit », ex. rag.autocade2.fr) vérifie sa licence en appelant POST /api/verify de ce serveur avec sa LICENCE_KEY (variable Coolify). La réponse fait autorité — elle vit dans cette base, le client n'y a pas accès et ne peut pas se réactiver lui-même. La plateforme revérifie au démarrage, puis toutes les 30 minutes environ, et aussi au fil de l'utilisation si la dernière vérification est trop ancienne.

1. Les 4 statuts

ActiveTout fonctionne, mises à jour autorisées.
SuspendueL'outil fonctionne (HTTP 200, valid:true) mais sans droit aux mises à jour (réponse updates:false) → badge + bannière ambre « Licence suspendue ». Ne bloque jamais l'usage. La licence reste surveillée dans la Supervision.
RévoquéeL'instance se bloque (403 sur le chat) si le blocage est actif (c'est le cas par défaut). Pour une rupture de contrat.
ExpiréeComme « Révoquée », automatique dès que la date de fin de maintenance est passée. Le tableau l'affiche « Expirée » dès ce moment ; pour débloquer le client, utilisez « Prolonger pour réactiver » (ajout d'une période).

2. Blocage ou simple observation — l'interrupteur

Depuis le 2026-06-11, le blocage est actif par défaut sur la plateforme : une licence révoquée/expirée bloque le chat (403) sans qu'aucune variable ne soit à poser. Le badge/bannière s'affichent comme avant.

Pour désactiver le blocage (mode observation — débloquer tout le monde sans redéployer une autre version) : poser LICENCE_ENFORCE=0 sur l'application RAG INTERFACE, puis redéployez-la. Une licence suspendue ne bloque jamais : seules les licences révoquées ou expirées bloquent.

Le client n'est pas bloqué malgré la révocation ? Deux causes : (1) l'instance tourne une version antérieure au 2026-06-11 (avant le blocage par défaut) → redéployez la dernière version ; (2) la variable LICENCE_ENFORCE est restée à 0 (mode observation) → la retirer (ou la passer à 1) dans la section « Environment Variables » (PAS « Preview Deployments »), « Available at Runtime » (disponible à l'exécution), puis redéployez. Signe que c'est bon : badge rouge ET le chat renvoie 403.

3. Suspendre / Révoquer / Réactiver

  1. Suspendre (retard de paiement, litige doux) → bouton Suspendre → statut « Suspendue ». L'outil tourne toujours, badge ambre côté client, et l'instance reste surveillée dans la Supervision. Pour couper réellement les mises à jour : désactivez aussi la clé de déploiement GitLab (la clé d'accès en lecture au code ; voir le point 8).
  2. Révoquer (fin de contrat) → bouton Révoquer → statut « Révoquée » → blocage actif, le chat renvoie 403 dans ~1 min (ou au rechargement côté client). Désactivez aussi la clé de déploiement GitLab pour bloquer les mises à jour de contournement.
  3. Réactiver → bouton Réactiver → « Active » (le client retrouve l'accès en ~1 min) + réactivez la clé de déploiement GitLab si vous l'aviez coupée. Une licence expirée se réactive par « Prolonger pour réactiver ».

4. Toutes les variables d'environnement

AppVariableRôle
LICENCE RAGSUPABASE_DB_URLOBLIGATOIRE — sinon les auto-migrations ne s'appliquent pas (voir §8).
LICENCE RAGLICENCE_SIGN_KEYClé privée Ed25519 → le serveur signe ses réponses (anti faux-serveur).
RAG INTERFACELICENCE_KEYLa clé de licence du client (celle créée ici).
RAG INTERFACELICENCE_ENFORCEPlus besoin de la poser — blocage actif par défaut (403) généré nativement. Mettre 0 seulement pour désactiver (mode observation).
RAG INTERFACELICENCE_REQUIRE_SIGPlus besoin de la poser — signature exigée par défaut (#348). Mettre 0 seulement pour accepter un serveur qui ne signe pas (dépannage).
RAG INTERFACELICENCE_INSTANCE_IDOptionnel — identifiant fixe de l'instance (sinon un nouvel identifiant est tiré à chaque démarrage ; utile pour la localisation et la détection d'anomalies).

5. Anti-triche : signatures Ed25519 (ordre CRITIQUE)

Sans signature, un client malin pointe LICENCE_VERIFY_URL vers un faux serveur renvoyant valid:true. La signature ferme ce trou : le serveur signe, la plateforme exige + vérifie avec la clé publique embarquée. L'ordre évite de bloquer un client légitime (clé publique sur la plateforme AVANT que le serveur ne signe) :

  1. Redéployer RAG INTERFACE (récupère la nouvelle clé publique embarquée).
  2. Poser LICENCE_SIGN_KEY sur LICENCE RAG, puis redéployez. Le serveur signe.
  3. Vérifier que /api/verify renvoie une sig non nulle et valide.
  4. Rien à poser sur RAG INTERFACE : depuis #348 la signature est exigée par défaut (opt-out LICENCE_REQUIRE_SIG=0). Sans LICENCE_SIGN_KEY, ce serveur répond 503 sans verdict et les instances passent en période de grâce.

6. Détection d'anomalies (section en haut du dashboard)

La liste est recalculée à chaque chargement et rafraîchie toutes les 3 minutes, à partir des vérifications (qui portent IP, pays, instance_id). Elle est rangée en deux groupes : « À traiter » (une action est attendue) et « Pour information » (le cockpit a déjà agi). Principales anomalies :

  • Partage de clé : une même clé vue depuis ≥3 instances distinctes sur 24 h.
  • Multi-pays : clé vérifiée depuis ≥3 pays distincts.
  • Instance muette : licence active qui vérifiait régulièrement puis s'est tue >48 h (vérification peut-être retirée du code = triche).

Bouton Acquitter pour retirer une anomalie traitée. Les alertes « E-mails en panne » sont aussi envoyées par e-mail aux adresses de la relance J-30, si l'envoi d'e-mails (SMTP) est configuré sur ce serveur.

7. Ce que le client voit

Licence suspendue : badge ambre « Licence suspendue » + bannière (partout) + page /licence au clic. Licence révoquée : badge rouge « Licence révoquée » + bannière rouge. La page /licence explique le statut et donne le contact contact@ocadefusion.fr.

8. Pièges critiques

SUPABASE_DB_URL obligatoire sur LICENCE RAG : le repli RPC des auto-migrations ne fonctionne pas sur cette base (la fonction exec_migration n'y existe pas). Sans cette variable, toute nouvelle migration échoue en silence (ex. le statut « Suspendue » renverra une erreur 500 à la suspension). Format : postgresql://postgres:PWD@supabase-db-…:5432/postgres.

Clé de déploiement GitLab : par convention coolify-rag-<client> (son nom est noté sur la licence comme aide-mémoire). La désactiver coupe les mises à jour immédiatement (levier le plus rapide, indépendant du statut).

9. Limites assumées (« solide pragmatique 95 % »)

Le client a la main sur son code et son Coolify. Un client déterminé peut retirer la vérification du code source ou poser LICENCE_ENFORCE=0 → imbloquable à 100 %. La parade : la clé de déploiement GitLab (coupe les mises à jour) + la détection d'anomalies (l'instance muette le trahit) + la traçabilité des vérifications. Reculer l'horloge pour étendre la grâce 7 j est bloqué (anti-rollback).

Guide marketplace plugins — fonctionnement, plugins avant publication, propagation

Le marketplace distribue des plugins (extensions de l'outil RAG) aux instances clientes, par licence et de façon contrôlée. Chaque instance ne reçoit que ce à quoi sa licence lui donne droit, sans jamais accéder au code source privé.

1. Principe — 1 dépôt GitLab = 1 plugin

Chaque plugin est un dépôt GitLab privé du groupe PLUGINS-OCADE-RAG. Le bouton « Synchroniser GitLab » (section Catalogue plugins) remonte ces dépôts dans le Catalogue (lecture de la fiche de description du plugin : nom, description, version).

Deux axes distincts contrôlent la distribution :

  • Interrupteur « Disponible » (catalogue) = le plugin est proposable à tous les sites (réglage général, activé ou désactivé pour tous).
  • Droits PAR LICENCE (bouton « Plugins » sur une ligne) = on coche quels plugins cette licence reçoit.

2. Ce que l'instance reçoit réellement

Une instance ne reçoit que les plugins « Disponible » ET accordés à sa licence(l'intersection des deux axes ci-dessus). La liste est fournie par l'endpoint signé entitlements, que l'instance interroge :

  • environ une fois par jour et au démarrage de l'instance ;
  • à chaque invalidation — le compteur plugins_rev (renvoyé par /api/verify) change et l'instance se rafraîchit ;
  • immédiatement via le bouton « Recharger ses plugins » (une licence) ou « Recharger les plugins de tous les sites » (toutes les licences) → propagation en ~1 min.

3. Plugins avant publication — tester avant de propager

Une licence dont l'interrupteur « Reçoit les plugins avant publication » est activé (sous le bouton « Plugins », badge « Plugins en avant-première » sur sa ligne) reçoit la dernière version de chaque plugin (la dernière modification enregistrée dans GitLab) en avant-première. Toutes les autres licences reçoivent la version « publiée » — une version figée, qui ne bouge pas tant qu'on ne publie pas.

Le bouton « Publier » sur un plugin (catalogue) fige la dernière version comme version publiéeet la propage à toutes les instances (les licences « avant publication », elles, l'ont déjà). Les sites l'installent en ~1 min. Une confirmation vous est demandée avant.

Le badge « Nouvelle version à publier » (catalogue) signale qu'une version plus récente que la version publiée existe mais n'a pas encore été publiée : seules les licences « avant publication » la reçoivent pour l'instant.

À ne pas confondre avec « Déployée en premier » (Supervision), qui règle l'ordre des mises à jour de l'outil lui-même, pas celui des plugins.

4. Sécurité — le code privé n'est jamais exposé

  • L'instance ne voit jamais le code source GitLab : elle télécharge le plugin via un relais de ce serveur de licence. Le jeton d'accès GitLab reste sur le serveur et n'est jamais transmis au client.
  • Les réponses d'autorisation (endpoint entitlements) sont signées Ed25519 : un faux serveur de licence local ne peut pas fabriquer une liste d'autorisations acceptée.
  • Le droit est revérifié en direct au moment du téléchargement : même si une instance connaît le nom d'un plugin, le relais refuse si la licence n'y a plus droit (« disponible » ET « accordé »).