Multi-vault (intégrateur)
Page pour les intégrateurs on-premise qui déploient Veilio pour plusieurs clients finaux et veulent une base Postgres distincte par client — pas seulement une cloison logique dans un coffre partagé.
En une phrase
Une instance Veilio (licence multi-tenant) + N organisations client, chacune branchée sur son Postgres vault. Les jetons d’un client n’existent pas dans la DB d’un autre.
1. Cas d’usage
Vous êtes éditeur / intégrateur / ESN. Vous hébergez (ou faites héberger) Veilio chez vous, et vous tokenisez la PII de plusieurs clients.
Sans multi-vault, tous les jetons vivent dans le Postgres clients de l’instance : isolation par organizationId, même infrastructure de stockage.
Avec multi-vault :
- chaque client a sa propre URL Postgres (schéma
clientsVeilio) ; - tokenize / detokenize avec la clé API du client lit et écrit uniquement ce vault ;
- un dump, une sauvegarde ou un accès DBA sur la DB A ne contient pas les jetons de B ;
- vous pouvez placer chaque vault chez le client, dans un VPC séparé, ou sur des projets Postgres différents.
C’est le modèle adapté quand le contrat client exige une séparation physique des coffres, pas seulement un filtre applicatif.
2. Ce que ça n’est pas
| Multi-vault intégrateur | Instance on-prem « single tenant » | Coffre dédié SaaS | |
|---|---|---|---|
| Qui opère Veilio | Vous (intégrateur) | Le client final | Veilio |
| Combien d’orgs | N clients sous votre licence MT | 1 org | 1 org |
| Où sont les jetons | 1 Postgres par client | Le clients du kit | Postgres dédié côté Veilio |
| Licence typique | Standard MT / Pro MT | Standard / Pro | Abonnement cloud |
Le multi-vault ne remplace pas une instance on-prem dédiée vendue au client final. Il sert quand vous restez l’opérateur et que vous cloisonnez les coffres de vos clients.
3. Prérequis
- Instance on-premise installée (Guide d’installation).
- Licence multi-tenant (ex. Standard MT : jusqu’à 50 entreprises / vaults ; Pro MT : jusqu’à 300). Le plafond apparaît dans Dashboard → Licence (
Entreprises / vaults). - Organisation racine de type partenaire / intégrateur (exposée dans Dashboard → Intégrer → Coffres clients).
- Pour chaque client : un Postgres joignable depuis l’instance, avec le schéma clients Veilio appliqué (script fourni dans le wizard).
4. Parcours produit
- Ouvrez Dashboard → Intégrer → Coffres clients.
- Nouveau coffre client : nom, plan (Starter / Pro / Enterprise), puis étape vault.
- Démarrer la DB : créez un Postgres dédié (port Postgres, pas un port web).
- Injecter le script : copiez le script SQL du wizard, exécutez-le dans le terminal SQL de cette DB (
schéma clients+ tablesToken/AccessLog). - Coller l’URL : URL Postgres de ce vault uniquement — pas l’URL du vault partagé de l’instance. Testez la connexion.
- Créez une clé API sur l’org client. Les appels
tokenize/detokenizeavec cette clé ciblent ce vault.
Les quotas de jetons et de requêtes du plan client plafonnent l’usage de cette org. Clés API et fichiers restent illimités au sens plan ; seuls jetons et requêtes sont réglables en Enterprise.
5. Isolation (ce qui est garanti)
- Deux clés API appartenant à deux orgs clients → deux routes vault.
- Detokenize d’un jeton créé avec la clé A en utilisant la clé B → introuvable (le jeton n’existe pas dans le vault B).
- Même valeur en clair tokenisée chez A et chez B → deux jetons différents (pas de partage de mapping entre DBs).
- Clé de chiffrement par vault : à la création d’un coffre dédié, l’instance génère une clé propre à ce vault, protégée par la clé maître de l’instance. Un dump de la base A ne permet pas de lire les clairs de B, même si les deux bases fuyaient ensemble. Les organisations sur le vault partagé gardent le chiffrement standard de l’instance.
Vérification SQL (sur chaque Postgres client) :
SET search_path TO clients;
SELECT type, left(token, 24) AS token_prefix, "createdAt"
FROM "Token"
WHERE "shreddedAt" IS NULL
ORDER BY "createdAt" DESC
LIMIT 20;Les listes ne se chevauchent pas entre les deux bases.
6. Architecture (rappel)
┌─────────────────────────┐
│ Instance Veilio (MT) │
│ DB veilio (contrôle) │
└───────────┬─────────────┘
│
┌─────────────────────┼─────────────────────┐
▼ ▼ ▼
Postgres client A Postgres client B (vault partagé
schéma clients schéma clients instance, optionnel)- La base veilio du kit reste le plan de contrôle (utilisateurs, organisations, clés API, licence).
- Chaque organisation client avec vault dédié pointe vers son Postgres ; les jetons n’y sont chiffrés qu’avec la clé de ce coffre (générée à la création du vault, protégée par la clé maître de l’instance).
- Sans URL dédiée, l’organisation utilise le Postgres
clientspartagé de l’instance.
7. Bonnes pratiques
- Un vault = un client contractuel. Ne réutilisez pas la même URL pour deux organisations.
- Sauvegardes et rétention par vault (alignées sur le DPA de chaque client).
- Ne publiez pas le Postgres sur un port d’application web ; mappez un port Postgres dédié.
- Le script SQL de schéma du vault est fourni dans le wizard (étape « Injecter le script ») et aussi téléchargeable depuis votre instance une fois démarrée. Gardez-en une copie dans votre procédure d’onboarding client.
- Surveillez le compteur Entreprises / vaults de la licence avant de provisionner un nouveau client.
8. Suite
- Installation de l’instance : Guide d’installation
- API tokenize / detokenize : Intégration HTTP
- Questions d’exploitation : Suggestions & contact