Documentation › Chiffrement et votre propre clé
Chiffrement et votre propre clé
SerenForce chiffre tous les secrets qu’il garde. Chaque organisation a sa propre clé, séparée de celle de la plateforme, et vous pouvez même apporter la vôtre.
Ce qui est protégé
Tout secret que SerenForce conserve est chiffré : chaînes de connexion, secrets client, clés de stockage et de cache, clés des services d’email et d’IA, et les valeurs marquées Secret dans un appel d’API d’un process. Chaque organisation (tenant) a sa propre clé, distincte de celle de la plateforme : les secrets d’une organisation ne peuvent pas être lus avec la clé d’une autre.
La source de la clé
L’écran vous pose les questions une par une ; la suivante n’apparaît qu’après votre réponse :
- Comment protéger les clés de données ? : Avec la clé racine de l’installation (rien d’autre à faire ; la page Statut affiche alors un avertissement) ou Avec une clé dans un coffre, c’est-à-dire votre propre clé (BYOK). Pour une organisation, elle demande l’offre Business ou une licence Entreprise de la plateforme ; pour la plateforme elle-même, aucune licence n’est demandée.
- Quel coffre ? : Azure Key Vault (ou Managed HSM), AWS KMS ou Google Cloud KMS.
- Pour Azure, Un nouveau coffre ou un coffre existant ? Un nouveau coffre reçoit toujours une nouvelle clé.
- Dans un coffre existant, et pour AWS ou Google, Une nouvelle clé ou une clé existante ? Une clé existante se donne par son adresse (URI, ARN ou nom) ; une nouvelle clé est générée pour vous.
- Pour un nouveau coffre ou une nouvelle clé dans Azure : SerenForce le crée maintenant (vous vous connectez à Azure) ou J’exécute un script (Bicep, ARM ou Terraform). Pour AWS et Google, la nouvelle clé est générée par un script (Terraform, CloudFormation ou gcloud), puis vous saisissez son adresse.
La clé doit être protégée contre la suppression : protection contre la purge (Azure), suppression toujours différée (AWS), délai d’au moins 24 heures avant destruction (Google). Vos réponses sont gardées : après un rechargement de la page, l’écran les retrouve.
Le coffre de la plateforme et la clé dédiée gérée par SerenForce ne sont plus proposés : une organisation qui les utilise déjà les garde tant que vous ne choisissez pas une autre clé, et sa clé dédiée se révoque ou se détruit toujours (voir plus bas).
Le bouton Vérifier la clé lance cinq contrôles : la clé est-elle autorisée, joignable, à vous, capable de chiffrer et de déchiffrer, et protégée contre la suppression.
Prouver que la clé est à vous
SerenForce affiche un jeton de propriété propre à votre organisation. Il empêche d’utiliser la clé d’une autre organisation :
- Azure : ajoutez à la clé l’étiquette
serenforce-tenantavec la valeur du jeton (le script fourni le fait). - AWS : donnez l’ARN de la clé et l’ARN du rôle que SerenForce endosse ; le rôle n’accepte que le jeton comme ExternalId. Le script Terraform ou CloudFormation crée la clé et le rôle, sans aucun secret.
- Google Cloud : donnez le nom de la clé et accordez le droit de chiffrer et de déchiffrer au compte de service affiché, propre à votre organisation. Le script Terraform ou gcloud le fait.
Une clé d’AWS ou de Google protège les secrets ; la base de données et les fichiers d’une organisation ne peuvent utiliser qu’une clé d’Azure.
Pendant l’installation de la plateforme
L’étape Chiffrement (facultative, après Licence) pose les questions ci-dessus, quelle que soit la licence de la plateforme (SaaS ou Entreprise). La clé racine de la plateforme peut être dans Azure Key Vault ou dans Google Cloud KMS (par un script ou avec une clé existante) ; Google Cloud KMS n’est proposé que si la plateforme est configurée pour lui. Le compte de service affiché doit recevoir sur la clé les rôles « Cloud KMS CryptoKey Encrypter/Decrypter » et « Cloud KMS Viewer ». AWS KMS est affiché (bientôt disponible).
Pour un coffre existant, connectez-vous sous Se connecter à Azure, saisissez l’abonnement puis cliquez sur Trouver mes coffres. Choisissez le coffre et cliquez sur Utiliser ce coffre : son groupe de ressources et son nom se remplissent. Pour une clé existante, cliquez ensuite sur Trouver les clés du coffre, choisissez la clé puis Utiliser cette clé : son URI se remplit. Vous pouvez aussi tout saisir vous-même. Votre accès à Azure n’est jamais gardé.
Sans réponse, le bouton Utiliser cette clé vous demande de choisir la clé racine ou un coffre. Voir Configurer la plateforme.
En ajoutant une organisation
Dans l’administration, l’inscription d’une organisation a une étape Chiffrement. Avec votre propre clé, la base de données (Azure SQL ou Azure Database for PostgreSQL) et les fichiers (Azure Blob Storage ou Amazon S3) sont chiffrés avec elle aussi. Cochez Seulement les secrets pour ne l’utiliser que pour les secrets. Donnez l’abonnement et le groupe de ressources pour appliquer le réglage tout de suite, ou téléchargez le script.
Pour mettre la clé dans un coffre existant, faites comme à l’installation : connectez-vous à Azure, saisissez l’abonnement, cliquez sur Trouver mes coffres puis sur Trouver les clés du coffre. Seules les clés données à cette organisation (avec son étiquette serenforce-tenant) sont listées. Le coffre choisi est gardé avec l’inscription en cours, jamais votre accès à Azure. La même liste existe sur la page Chiffrement.
Sans réponse à cette étape, l’organisation utilise la clé de la plateforme : le coffre ou la clé racine de la plateforme, sinon la clé Azure Key Vault ou Google Cloud KMS choisie pour le catalogue à l’installation. Si aucune ne convient (par exemple une clé AWS KMS pour le catalogue), l’inscription échoue. Choisissez alors un coffre.
La page Chiffrement de l’administration
Choisissez le catalogue ou une organisation : la page montre la clé utilisée, ses clés de données, les derniers changements et la prochaine rotation annuelle. Deux actions :
- Utiliser cette clé : change la clé de l’organisation.
- Renouveler la clé de données : remplace la clé de données par une nouvelle.
Ces deux actions demandent de vous reconnecter avec un second facteur (de moins de 10 minutes). Voir Second facteur. Chaque changement est enregistré et envoyé par email à tous les super administrateurs. La clé de données est de toute façon renouvelée au moins une fois par an (voir plus bas). Le champ Renouvellement de la clé de données choisit, pour le catalogue ou l’organisation, si elle est renouvelée Automatique (une fois par an) ou À la demande.
Renouveler la clé de votre organisation
Avec l’offre Business (ou une licence Entreprise), les personnes qui ont le rôle Security administrator (« Administrateur sécurité ») gèrent elles-mêmes le chiffrement de leur organisation : Administration › Encryption. L’onglet montre la clé qui protège les secrets, la date du dernier renouvellement et la date avant laquelle la clé doit être renouvelée. Même le rôle Administrator ne le voit pas : ce rôle se donne volontairement (voir les rôles fournis).
- Automatic (« Automatique », par défaut) : SerenForce renouvelle la clé une fois par an, sans rien à faire.
- On demand (« À la demande ») : vous choisissez le moment. Les administrateurs sécurité et les administrateurs reçoivent un rappel 30 jours et 7 jours avant l’échéance, et l’onglet affiche un bandeau. Si la clé n’est pas renouvelée à temps, elle l’est automatiquement ce jour-là.
Renew the key now (« Renouveler la clé maintenant ») demande de vous reconnecter avec votre second facteur (de moins de 10 minutes). La clé peut être renouvelée une fois toutes les 24 heures : l’onglet indique alors à partir de quand vous pourrez la renouveler de nouveau. Chaque changement est enregistré et envoyé par email aux super administrateurs et aux administrateurs de l’organisation ; les emails ne contiennent jamais de lien à cliquer, seulement « connectez-vous à SerenForce ».
Une organisation qui partage son espace avec d’autres organisations (offre Team) ne gère pas sa clé : l’onglet indique que l’administrateur de la plateforme s’en charge.
Second facteur
Changer, renouveler, révoquer ou détruire une clé demande un second facteur de moins de 10 minutes. Si votre connexion en prouve un, rien de plus à faire. Sinon (connexion Google, Amazon Cognito…), cliquez sur Recevoir un code par email : un code de 6 chiffres, valable 10 minutes, vous est envoyé. Après 5 codes faux, demandez-en un nouveau.
Révoquer ou détruire la clé dédiée
- Révoquer : la clé est désactivée tout de suite, plus rien ne peut être lu. Rétablir la remet en service.
- Demander la destruction : la clé est désactivée tout de suite et un second administrateur sécurité doit valider la destruction (jamais la personne qui l’a demandée). La destruction a lieu 7 jours après la demande ; jusque-là, Annuler la destruction remet la clé en service. Une fois détruite, rien de ce qu’elle protégeait ne peut plus être lu.
Chaque étape est envoyée par email aux administrateurs de l’organisation et aux super administrateurs, et inscrite dans le journal d’audit.
Contrôle quotidien et continuité
- Chaque jour, SerenForce vérifie la clé utilisée : elle répond, elle est à vous, elle chiffre et déchiffre, sa suppression n’est pas programmée, elle n’expire pas dans les 30 jours, ses versions encore utiles sont actives. Un problème est envoyé par email tout de suite, puis chaque jour tant qu’il dure, et affiché sur la page Chiffrement et la page Statut.
- Si le coffre ne répond pas (réseau, panne), SerenForce continue avec la dernière clé connue jusqu’à son retour ; la page Statut affiche un avertissement. Si la clé est refusée (désactivée, supprimée, droit retiré), la coupure est immédiate.
- Quand la clé est indisponible, l’application affiche « La clé de chiffrement de votre organisation est indisponible. Contactez votre administrateur. »
- Une ancienne clé de données détruite après un renouvellement est gardée 90 jours : si une valeur en a encore besoin, les super administrateurs sont prévenus et peuvent la rétablir.
Révoquer votre clé
- Si vous révoquez votre propre clé, dans les 15 minutes la plateforme ne peut plus lire les secrets de cette organisation. La page Statut l’affiche en rouge et les super administrateurs reçoivent un email.
- Supprimer une organisation détruit ses clés : rien de ce qu’elle avait chiffré ne pourra plus être lu.
Installation sans Azure DevOps ou sur votre serveur
La clé racine est créée avec une commande. Gardez la copie de récupération et sa phrase de passe dans deux endroits sûrs et séparés.
SerenForce.Api keys init # crée la clé racine (et la copie de récupération)
SerenForce.Api keys rotate # la remplace par une nouvelle clé (l’ancienne reste lisible le temps du changement)
SerenForce.Api keys import # la restaure sur un autre serveur
SerenForce.Api keys check # la vérifie
SerenForce.Api keys restore-data-key <id> # rétablit une clé de données détruite (90 jours)
La copie de récupération est chiffrée par une phrase de passe que la commande vous demande (et redemande à l’import) ; la phrase n’est jamais gardée.