Sur cette page
Gestionnaire de secrets
Le gestionnaire de secrets stocke en toute sécurité les mots de passe, clés d'API, matériel TLS et autres valeurs sensibles dans un coffre durci, contrôle qui peut lire chacun d'eux, et peut générer pour vous des secrets robustes à la demande.
Chaque secret est stocké chiffré dans le service sécurisé de secrets et n'est retourné qu'aux appelants que vous avez explicitement autorisés. La console n'affiche jamais la valeur d'un secret dans une liste; vous devez ouvrir le secret pour révéler sa charge utile, et l'accès peut être restreint davantage par une liste de contrôle d'accès (ACL) propre au secret.
Les secrets portent un type (par exemple phrase secrète, clé symétrique, certificat ou blob opaque), un algorithme facultatif et une date d'expiration facultative. Les secrets connexes peuvent être regroupés dans des conteneurs afin qu'une application en consomme un ensemble cohérent d'un coup, comme un certificat accompagné de sa clé privée.
Concepts clés
Secret — Une valeur chiffrée unique (mot de passe, clé, certificat) avec un nom, un type et une expiration facultative.
Charge utile — La valeur réelle du secret. Elle est écrite une fois et lue uniquement par une révélation autorisée.
Conteneur — Un groupe nommé de secrets connexes qu'une application ou un répartiteur de charge consomme ensemble.
ACL — La liste de contrôle d'accès propre au secret qui décide quels utilisateurs ou applications peuvent le lire.
Consommateur — Un service (comme un répartiteur de charge) qui référence un conteneur et y est répertorié.
Rotation — Le remplacement de la valeur d'un secret par une nouvelle en conservant le même nom et les mêmes références.
Avant de commencer
- Vous travaillez dans le projet qui doit posséder le secret.
- Vous avez la valeur à stocker, ou vous prévoyez d'en générer une.
- Pour les secrets de certificat, le certificat et sa clé privée.
Étape par étape
- Ouvrez le coffre
Allez dans Sécurité et ouvrez Secrets. Le tableau montre le nom, le type, le statut, l'algorithme et l'expiration de chaque secret.
Capture d'écran — Le coffre Secrets avec la boîte de recherche et le filtre par typeLe coffre Secrets avec la boîte de recherche et le filtre par type - Créez ou générez un secret
- Choisissez Créer un secret. Dans l'onglet Saisie manuelle, donnez-lui un nom et un type, puis collez la valeur ou téléversez un fichier.
- Ou passez à l'onglet Générer pour que la plateforme produise une valeur aléatoire robuste (une phrase secrète, ou une clé symétrique avec un algorithme et une taille de clé choisis).
Capture d'écran — La boîte de dialogue Créer un secret avec les onglets Saisie manuelle et GénérerLa boîte de dialogue Créer un secret avec les onglets Saisie manuelle et Générer - Copiez tout de suite une valeur générée
Quand vous générez un secret, sa valeur est affichée une seule fois dans une boîte de dialogue. Copiez-la avant de fermer, puis stockez-la là où l'application consommatrice l'attend.
Capture d'écran — La confirmation de secret généré montrant la valeur à copierLa confirmation de secret généré montrant la valeur à copier - Regroupez les secrets connexes
Ouvrez Gérer les conteneurs pour créer un conteneur et y ajouter les secrets qui vont ensemble, par exemple un certificat et sa clé privée.
Capture d'écran — Le gestionnaire de conteneurs avec les secrets membresLe gestionnaire de conteneurs avec les secrets membres - Restreignez l'accès
Modifiez l'ACL du secret afin que seuls les utilisateurs ou identifiants d'application qui en ont vraiment besoin puissent lire la charge utile.
- Rotation ou suppression
Utilisez les actions de la ligne pour révéler, faire pivoter ou supprimer un secret. La rotation est disponible pour les secrets de type phrase secrète, symétrique et clé privée; les secrets de certificat ont une rotation de certificat dédiée.
Exemples
# Lister les secrets, puis récupérer une charge utile par ID patrii secret list patrii secret get <secret-id> --output-file db-password.txt
patrii secret generate \ --name prod-db-password \ --type passphrase \ --length 32
resource "patrii_secret" "db_password" {
name = "prod-db-password"
secret_type = "passphrase"
payload = var.db_password
payload_content_type = "text/plain"
}Limites et caractéristiques
Types de secrets que vous pouvez stocker :
| Type | Usage typique |
|---|---|
passphrase | Mots de passe et secrets de style humain; peut être généré et pivoté. |
symmetric | Clés de chiffrement symétriques (par exemple AES) avec une taille de clé choisie. |
public / private | Les deux moitiés d'une paire de clés asymétriques (RSA, ECDSA, EdDSA). |
certificate | Certificats TLS, gérés et pivotés à part; consommables par les répartiteurs de charge. |
opaque | Tout blob arbitraire que la plateforme n'a pas besoin d'interpréter. |
Bonnes pratiques
- Préférez les secrets générés aux secrets saisis à la main pour tout ce qui est machine à machine.
- Donnez à chaque secret un nom clair et fixez une expiration pour repérer facilement le matériel périmé.
- Accordez l'accès en lecture via une ACL au plus petit ensemble d'utilisateurs ou d'identifiants d'application qui en ont besoin.
- Regroupez un certificat et sa clé privée dans un conteneur pour que les consommateurs référencent un seul objet.
- Faites pivoter les secrets selon un calendrier et immédiatement après toute exposition suspectée.
Questions fréquentes
Puis-je voir la valeur d'un secret dans la liste ?
Que signifie la colonne Utilisé dans ?
Pourquoi ne puis-je pas supprimer un secret ?
Pour aller plus loin
Tout ce que vous faites ici dans la console est aussi disponible via l'API Patrii Cloud pour l'automatisation et les scripts.