Glossaire de référence
CLOISON utilise un vocabulaire précis — et vous le méritez aussi. Ce glossaire fixe le sens exact des termes employés dans la documentation, le journal de transparence et le rapport de conformité, pour qu'un même mot ne puisse jamais être compris de deux façons. Notre cadre de référence est celui où CLOISON se déploie d'abord : le droit sénégalais et ouest-africain (loi n°2008-12, CEDEAO / UEMOA, Convention de Malabo). Le RGPD y figure à titre complémentaire, pour l'expansion européenne — il n'est pas le cadre premier.
Les quatre sections suivent l'ordre d'un déploiement réel : comprendre ce qui est protégé, où tourne le moteur, par quelle preuve, puis sous quel droit. Si vous ne devez retenir qu'une chose, lisez Confidentialité & données puis Cadre juridique & souveraineté.
Confidentialité & données
Ce que CLOISON traite, et ce qu'il ne prétend pas faire. La distinction entre pseudonymiser et anonymiser est le fondement de toute la suite.
- PII · Personally Identifiable Information
- Données personnelles identifiantes : nom, email, téléphone, numéro de CNI, adresse… Deux lettres pour la catégorie de tout ce que CLOISON détecte avant l'envoi.
- Pseudonymisation
- Remplacement réversible d'un identifiant par un jeton lié à l'identité d'origine. La valeur en clair reste reconstituable — c'est ce qui permet de restaurer la réponse.
- Anonymisation
- Donnée rendue irréversiblement non-liaible. CLOISON pseudonymise, il n'anonymise pas.
- Quasi-identifiants
- Combinaison de champs (âge + ville + date…) capable de ré-identifier sans nom. CLOISON les signale (généralisation / suppression, k-anonymat) et ne prétend pas les résoudre.
- Jeton ⟦…⟧
- Représentation stable d'une valeur pseudonymisée, salée par conversation (le sel = la rotation). C'est la forme que voit le modèle, à la place de la donnée en clair.
- Coffre · chiffré
- Registre local chiffré
${jeton ↔ valeur}; il ne vit que côté client (edge), jamais sur le cloud. - Clé composite
- Identifiant + clé placés dans le seul champ « clé », pour ne jamais exposer de secret dans l'URL.
- Déterminisme & coréférence
- Le même clair produit le même jeton dans une session ; la cohérence entre références est conservée.
Un jeton n'est pas une anonymisation. Dès qu'un quasi-identifiant suffit à re-identifier, le risque persiste : c'est pourquoi CLOISON signale ces champs et applique des seuils de k-anonymat plutôt que de prétendre les avoir supprimés.
Architecture & cloisonnement
Où tourne le moteur, ce qui traverse le réseau, et ce que retient le plan de contrôle.
- Proxy OpenAI-compatible
- Passerelle qui imite le protocole OpenAI ; deux champs (base URL + clé composite).
- Edge
- Le moteur s'exécute chez le client, à la frontière ; le clair ne quitte pas le poste (N0).
- Plan de contrôle aveugle
- Le cloud ne recueille que des compteurs agrégés signés, jamais de texte ni de clair.
- N0 / N1 / N2 / N3 · échelle de cloisonnement
- Poste (rien), site (le client), enclave (scellé, prouvé), hébergé (l'éditeur lit le clair — jamais l'argument).
- Mode Audit · observe-only
- Détection + comptage sans masquage, rapport de conformité signé à seuils k-anonymes.
- NER · Named Entity Recognition
- Détection automatique des entités (personnes, lieux, formats de CNI…).
Échelle de cloisonnement
| Niveau | Le moteur tourne… | Ce que voit l'éditeur | Notre position |
|---|---|---|---|
| N0 | sur votre poste | rien | zéro transfert de clair |
| N1 | sur votre site | rien | clés chez vous, toujours |
| N2 | dans une enclave scellée | prouvé | attestation vérifiable |
| N3 | hébergé (api.wonkom.ai) | peut lire le clair | jamais l'argument |
Exemple pratique — lancer le moteur en local
En N0, le moteur écoute sur une adresse de boucle locale. Le clair ne franchit jamais la frontière.
# 1. Lancer le moteur (N0)
./cloison serve --listen 127.0.0.1:8787
# 2. Vérifier qu'il répond
curl -s http://localhost:8787/health
# cloison.toml — politique de pseudonymisation (N0)
[fields]
name = "pseudonymize"
email = "pseudonymize"
phone = "pseudonymize"
cni = "pseudonymize"
age = "generalize" # quasi-identifiant
[proxy]
base_url = "https://api.openai.com/v1"
composite_key = "org_…:sk-…" # identifiant + clé, un seul champ
Cryptographie & preuve
Les primitives qui rendent la protection vérifiable — de la dérivation d'un jeton à la preuve d'inclusion.
- HMAC
- Empreinte à clé pour dériver un jeton (mieux qu'un hachage nu ; le sel de session fait la rotation).
- AEAD
- Chiffrement authentifié (AES-256-GCM / XChaCha20-Poly1305) pour le coffre au repos.
- Ed25519
- Signature cryptographique utilisée par le journal de transparence et les reçus.
- Chaîne de hachage / Merkle
- Journal append-only où chaque entrée scelle la précédente ; preuve d'inclusion.
- k-anonymat k
- Seuil d'agrégation minimal pour qu'un compteur publié ne puisse rien révéler sur un individu.
- WASM · WebAssembly
- Build portable du moteur qui tourne dans le navigateur (cloison-verify) et sur mobile.
Cadre juridique & souveraineté
Notre référence n'est pas européenne par défaut : nous déployons d'abord en Afrique de l'Ouest, sous le droit sénégalais et ouest-africain. Le RGPD est une lecture complémentaire pour la suite, pas le cadre qui gouverne.
- Loi n°2008-12 · Sénégal
- Loi sénégalaise de protection des données personnelles. Notre cadre premier : elle fixe la déclaration et l'autorisation préalable.
- CEDEAO
- Acte additionnel A/SA.1/01/10 (2010), applicable aussi à l'UEMOA.
- Convention de Malabo · 2014
- Convention africaine de cybersécurité et protection des données, ratifiée par le Sénégal.
- CDP
- Autorité de protection des données (Commission de protection des Données personnelles).
- Régime à deux étages
- Déclaration (données ordinaires) ; autorisation préalable de la CDP (données sensibles : santé, biométrie…).
- Responsable ≠ sous-traitant
- Qui fixe la finalité du traitement. CLOISON se positionne en sous-traitant / intermédiaire technique (corpus sans exfiltration, opt-in séparé).
- RGPD
- Référentiel européen ; lecture complémentaire pour le fast-follow Europe, pas notre cadre premier.
- AGPL-3.0
- Licence de la passerelle (les forks hébergés doivent rester ouverts).
Pour un déploiement en Afrique de l'Ouest, la loi n°2008-12, l'acte CEDEAO et la Convention de Malabo priment. Le RGPD reste utile en complément : il devient le cadre principal lorsque le traitement vise l'Europe. Nous ne faisons pas l'inverse.