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.

⏱ 9 minutes📍 Administration · installation de la plateforme · inscription d’une organisation

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 :

  1. 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.
  2. Quel coffre ? : Azure Key Vault (ou Managed HSM), AWS KMS ou Google Cloud KMS.
  3. Pour Azure, Un nouveau coffre ou un coffre existant ? Un nouveau coffre reçoit toujours une nouvelle clé.
  4. 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.
  5. 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 :

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 :

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).

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

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é

Révoquer votre clé

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.