Apporter ou conserver sa propre clé
Configurer des clés détenues par le client et des références sans cache, vérifier la révocation et récupérer en toute sécurité.
La garde de clé par le client s'applique aux secrets stockés de l'organisation et des espaces de travail ainsi qu'aux identifiants d'extension de l'organisation. Elle ne chiffre pas l'ensemble de la base de données : les sessions d'identité de la plateforme, les comptes de connexion, la configuration d'amorçage SSO, le stockage d'audit et les identifiants de connexion conservent leur protection au niveau du déploiement. Un secret référencé est récupéré en mémoire pour être utilisé. Les clés détenues par le client n'empêchent pas un processus autorisé de voir le texte en clair pendant cette utilisation.
Prérequis opérateur
Deux limites relèvent de l'opérateur du déploiement Scrydon, et non d'un administrateur d'organisation. Définissez-les dans les valeurs Helm sous auth.secretsCustody :
-
platformIdentityBindings— l'authentification Kubernetes et l'identité de workload Azure font que Scrydon s'authentifie en tant que son propre workload. Cette identité est la même pour toutes les organisations du déploiement ; un coffre qui lui fait confiance répondrait donc sinon à n'importe quelle organisation qui le désigne. Une connexion utilisant l'une de ces méthodes est refusée tant que l'opérateur n'a pas lié cette organisation à ce coffre :yamlauth: secretsCustody: platformIdentityBindings: - organizationId: "<your organization id>" vaultUrl: "https://customer-vault.vault.azure.net"Un jeton Vault ou AppRole ne nécessite aucune liaison : présenter un identifiant que vous avez émis prouve quel client fait la demande. Sur un déploiement partagé, privilégiez ces méthodes.
-
allowPrivateNetworks— une URL de coffre est contactée depuis Scrydon ; par défaut, elle doit donc être un hôte HTTPS public. Définissez cette valeur surtrueuniquement lorsque toutes les organisations du déploiement vous appartiennent et que le coffre se trouve sur votre réseau privé. Lehttp://simple n'est accepté que dans ce mode, et uniquement vers une adresse privée ou de bouclage, car Transit renvoie les clés de données dans le corps de sa réponse : un coffre à une adresse publique exigehttps://. Une adresse IP est vérifiée à l'enregistrement de l'URL, un nom d'hôte à chaque connexion, sur l'adresse vers laquelle il se résout.
Déploiement de référence OpenBao
Exploitez OpenBao sous le contrôle du client, en dehors de la release Helm Scrydon. Utilisez un namespace ou un cluster Kubernetes exploité séparément, trois réplicas avec stockage Raft intégré, des volumes persistants, des certificats TLS approuvés par Scrydon et une procédure d'instantané/restauration testée. Le mode développement est réservé aux tests jetables.
Ajoutez le dépôt Helm officiel et sélectionnez une version de chart approuvée :
helm repo add openbao https://openbao.github.io/openbao-helm
helm repo update
helm search repo openbao/openbao --versions
helm template customer-bao openbao/openbao --version "$BAO_CHART_VERSION" \
--namespace customer-bao --values customer-bao-values.yamlExaminez les manifests générés avant d'installer avec la même version et les mêmes valeurs. Configurez server.ha.enabled: true, server.ha.replicas: 3 et server.ha.raft.enabled: true dans les valeurs du chart. Désactivez le mode autonome. Suivez la référence de configuration du chart pour la découverte des pairs Raft, les montages de volumes TLS, le stockage et les permissions du compte de service. Les valeurs par défaut autonomes du chart ne constituent pas une configuration de production.
Pour une référence de déverrouillage automatique statique, injectez dans chaque pod OpenBao une clé de 32 octets provenant d'une source de confiance existante du client, séparément de son volume Raft et de ses sauvegardes. Incluez ceci dans la configuration du serveur Raft :
seal "static" {
current_key_id = "customer-seal-1"
current_key = "file:///openbao/secrets/customer-seal-1.key"
}Le client doit contrôler ce fichier et sa copie de récupération. Cela rattache la confiance au système qui le fournit ; il ne s'agit pas d'une revendication HSM. Consultez les exigences et la rotation du scellement statique avant de choisir ce modèle. Initialisez le cluster selon la procédure opérateur, joignez tous les pairs Raft, activez la journalisation d'audit et vérifiez la récupération indépendamment de Scrydon.
Créer une clé Transit et une identité restreinte
Exécutez ces commandes en tant qu'opérateur OpenBao autorisé. Ne donnez pas le jeton root à Scrydon. L'exemple utilise une clé et une sous-arborescence KV dédiées :
bao secrets enable transit
bao write transit/keys/scrydon type=aes256-gcm96
bao secrets enable -path=secret kv-v2
bao kv put secret/scrydon/probe value=connection-check
bao policy write scrydon - <<'POLICY'
path "transit/keys/scrydon" { capabilities = ["read"] }
path "transit/datakey/plaintext/scrydon" { capabilities = ["update"] }
path "transit/decrypt/scrydon" { capabilities = ["update"] }
path "secret/data/scrydon/*" { capabilities = ["read"] }
POLICYOmettez la configuration KV et son ACL si vous n'avez besoin que de secrets stockés. Ne répétez pas secrets enable pour un montage existant.
Pour l'authentification Kubernetes, activez la méthode et configurez TokenReview sur le cluster qui exécute Scrydon. Lorsqu'OpenBao s'exécute dans ce cluster, son jeton de compte de service local et sa CA peuvent être utilisés ; accordez system:auth-delegator à son compte de service et configurez l'adresse du serveur d'API :
bao auth enable kubernetes
bao write auth/kubernetes/config kubernetes_host="$KUBERNETES_API_URL"
bao write auth/kubernetes/role/scrydon \
bound_service_account_names="$SCRYDON_SERVICE_ACCOUNT" \
bound_service_account_namespaces="$SCRYDON_NAMESPACE" \
policies=scrydon ttl=15mL'authentification Kubernetes présente l'identité de workload de Scrydon ; elle nécessite donc une liaison opérateur (voir Prérequis opérateur). Utilisez le compte de service réel du workload pour chaque processus qui résout des secrets. Les déploiements inter-clusters nécessitent la CA distante et une identité TokenReview gérée séparément ; ne supposez pas que le jeton local d'OpenBao peut contrôler un autre cluster. Scrydon lit son JWT Kubernetes projeté depuis l'emplacement standard du compte de service de l'hôte. Les paramètres de connexion ne peuvent pas désigner un fichier local arbitraire.
Ouvrez Paramètres → Plateforme → Secrets → Connexions et sélectionnez Ajouter une connexion. Choisissez OpenBao / Vault Transit, saisissez l'origine HTTPS et le nom de clé scrydon, puis choisissez la méthode de connexion : Jeton, AppRole ou Kubernetes (rôle scrydon). Les champs de chaque méthode apparaissent directement en dessous. Pour résoudre des secrets référencés depuis ce coffre, activez Secrets référencés : le montage KV v2 vaut secret par défaut, et un chemin de test optionnel tel que scrydon/probe#value fait que le test de connexion le lit également. Le montage Transit (par défaut transit), un namespace et une CA privée ou un certificat client se trouvent sous Options avancées.
Tester la connexion vérifie la connexion avant que vous ne l'enregistriez, et ce test ne stocke rien. Enregistrer exécute la même vérification et refuse une connexion que le coffre n'accepte pas, en affichant la raison dans le panneau — identifiants rejetés, clé manquante, adresse injoignable ou chemin de test illisible.
Les identifiants ne sont plus jamais affichés après l'enregistrement. Lorsque vous modifiez une connexion, laissez un identifiant vide pour conserver celui qui est stocké, ou saisissez une valeur pour le remplacer. Changer de méthode d'authentification exige de saisir ses identifiants. Le montage KV d'une connexion qui sert encore des secrets référencés ne peut être ni modifié ni supprimé : déplacez ou supprimez d'abord ces références.
HashiCorp Vault utilise le même type de connexion Transit/KV v2. Fournissez son namespace si nécessaire ; utilisez les procédures de déploiement et d'authentification Vault approuvées par le client plutôt que les commandes d'installation d'OpenBao.
Azure Key Vault
Les connexions Azure s'authentifient toujours avec l'identité de workload de Scrydon ; chacune nécessite donc une liaison opérateur (voir Prérequis opérateur). Utilisez une origine de coffre du cloud public telle que https://customer-vault.vault.azure.net et une clé RSA prenant en charge RSA-OAEP-256. Accordez à l'identité de workload les permissions de clé get, wrap et unwrap ; n'accordez la permission de secret get que si des références sont nécessaires. Configurez un identifiant d'identité fédérée Entra correspondant à l'émetteur et au sujet du workload, avec l'audience d'échange de jetons. Montez l'assertion projetée dans le workload Scrydon et définissez AZURE_FEDERATED_TOKEN_FILE sur ce chemin détenu par l'hôte.
Créez une connexion Azure Key Vault avec l'URL du coffre, l'ID de tenant, l'ID client et le nom de la clé. Une version optionnelle épingle les nouveaux encapsulages ; les enveloppes existantes conservent leur version d'encapsulage exacte. Gardez les versions antérieures utilisables pour le texte chiffré et les sauvegardes existants. Ce type de connexion ne fournit ni authentification par secret client ni point de terminaison de cloud souverain.
Le client utilise le flux client-credentials fédéré et l'API REST Key Vault 7.4. Consultez les opérations d'encapsulage Azure pour les permissions de clé et les algorithmes. La réussite d'un test local sur des fixtures de protocole ne prouve pas l'accès à votre tenant Azure : exécutez la sonde de connexion et l'exercice de révocation avec votre identité déployée.
Sélectionner la garde et migrer
Dans l'onglet Connexions, la section Clé de chiffrement détermine qui détient la clé. Choisissez la connexion sous Clé détenue par (seules les connexions dont le dernier test a réussi peuvent être choisies), choisissez Strict ou Performance · 5 min sous Accès à la clé, puis Appliquer. Scrydon effectue une sonde avant de sélectionner la garde et déplace les valeurs existantes par lots pouvant être repris. Le décompte de couverture inclut les secrets stockés et les champs de jetons d'extension non vides de l'organisation, y compris les anciens champs en clair. Les références et les champs d'identité internes à la plateforme sont exclus.
Gardez les anciennes et les nouvelles connexions disponibles jusqu'à ce que la couverture soit complète. En cas d'échec, rétablissez l'accès et sélectionnez Reprendre. Une valeur illisible sous sa clé actuelle — corrompue, ou encapsulée par une clé qui n'existe plus — est ignorée et comptabilisée plutôt que de bloquer le reste ; la page indique combien ont été ignorées, et elles restent sous leur protection précédente jusqu'à ce que vous les résolviez. Les lignes déjà migrées restent valides ; les nouvelles écritures utilisent la garde sélectionnée. Conservez les anciennes clés et la configuration des connexions aussi longtemps que des sauvegardes conservées contiennent leur texte chiffré, même après que la couverture en production a atteint 100 %.
Exercice de révocation
Utilisez une organisation, une clé et une identité jetables. Consignez le build de l'application, la version du coffre, le mode, la couverture et les horodatages, sans consigner de valeurs de secrets.
- Créez un secret stocké, sélectionnez la garde client et attendez une couverture complète. Lisez-le avec succès et créez une autre valeur stockée pour solliciter la DEK d'écriture. Si vous testez des références, créez-en une et utilisez Lire maintenant.
- Révoquez les permissions effectives de clé de l'identité dédiée dans le coffre. Modifier seulement un rôle Kubernetes peut ne pas invalider les jetons déjà émis ; révoquez ces jetons ou modifiez leur ACL effective. Notez le moment où le coffre commence à refuser les requêtes.
- Utilisez Vérifier la révocation. Cette action contourne le cache de DEK. Attendez-vous à un résultat refusé ou de clé manquante ; un coffre injoignable est un résultat différent.
- En mode Strict, la lecture et l'écriture stockées suivantes doivent échouer. En mode Performance, les lectures et écritures déjà préchauffées peuvent réussir jusqu'à ce que leur dernière vérification réussie date de 300 secondes. Passé ce délai, les deux doivent échouer. Une lecture de référence doit échouer immédiatement dans les deux modes.
- Rétablissez les permissions de l'identité. Relancez une sonde et vérifiez les lectures stockées, les écritures et les contrôles de références. Les échecs d'authentification AppRole/Kubernetes ont un délai de connexion borné ; prévoyez jusqu'à une minute pour une nouvelle tentative après le rétablissement de l'authentification.
- Repassez à la garde de la plateforme tant que la clé du client reste accessible. Attendez une couverture complète, supprimez les références, puis supprimez la connexion jetable. Ne supprimez pas une clé nécessaire à des sauvegardes conservées.
Une panne du coffre suit le même chemin à échec fermé. Repasser à la garde de la plateforme ne permet pas de récupérer des données dont la seule clé d'encapsulage a été détruite. La récupération exige la clé d'origine, une version utilisable ou une sauvegarde avec ses clés correspondantes.