Configuration de votre instance Vault Dedicated
Dans ce tutoriel, vous apprendrez à configurer une instance plan Vault Dedicated d’ IBM Cloud® Secrets Manager en provisionnant l’instance, en récupérant ses points de terminaison, en générant un jeton d’administration et en vous
connectant à l’interface utilisateur de Vault pour la configuration initiale.
Cette offre Vault Dedicated propose Vault Enterprise sous forme de service géré dans l' IBM Cloud. Une fois votre instance provisionnée, vous pouvez utiliser le tableau de bord de l'instance pour trouver les informations de connexion
et ouvrir l'interface utilisateur de Vault afin de commencer à configurer votre environnement Vault.
L'offre Vault Dedicated est actuellement disponible en version bêta publique. Les fonctionnalités bêta sont fournies à des fins d'évaluation et de test et présentent certaines limitations par rapport aux fonctionnalités généralement disponibles.
Limitations de la version bêta publique dédiée de Vault
Pendant la période de bêta publique, le forfait Vault Dedicated est soumis aux restrictions temporaires suivantes :
- Limite d'instances: une seule instance Vault Dedicated par compte pendant la phase bêta.
- Pas de parcours de mise à niveau: il n'est pas possible de passer de la version bêta à la version GA. Toutes les instances bêta seront supprimées avant la mise à disposition générale.
- Disponibilité régionale: disponible à Dallas et à Francfort.
- Gratuit pendant la phase bêta: aucun frais n'est facturé pendant la période bêta.
- Migration de la version bêta vers la version GA: la migration des données des instances bêta vers les instances GA n'est pas prise en charge.
Ces restrictions sont temporaires et ne s'appliquent que pendant la période de bêta publique. Ce contenu sera supprimé ou modifié lorsque le forfait Vault Dedicated sera disponible pour le grand public.
Avant de commencer
Avant de commencer, assurez-vous de disposer d'un compte IBM Cloud et des droits d'accès IAM requis pour utiliser le service.
Vous devez disposer des rôles suivants :
- Le rôle de service Manager permet de provisionner une instance et de générer un jeton d'administration.
- Rôle de service Auteur, Lecteur ou Observateur pour consulter les détails de l'instance.
Provisionner une instance du forfait Vault Dedicated
Créez une instance de plan Vault Dedicated à partir du catalogue IBM Cloud.
-
Dans la console d' IBM Cloud, accédez au Catalogue.
-
Sélectionnez Secrets Manager.
-
Choisissez la formule Vault Dedicated.
-
Configurer l'instance :
- Sélectionnez une région de déploiement.
- Saisissez un nom d'instance unique.
- Sélectionnez un groupe de ressources.
- Choisissez entre le chiffrement géré par le service et le chiffrement géré par le client à l’aide d’ Key Protect.
- Sélectionnez des points de terminaison privés uniquement, ou activez un point de terminaison public si nécessaire.
Si vous sélectionnez des points de terminaison exclusivement privés, veuillez prendre connaissance des exigences suivantes avant d'essayer de vous connecter :
- Accès à l'API: vous devez créer une passerelle VPE (Virtual Private Endpoint) ciblant votre instance Vault Dedicated. Les points de terminaison des services cloud (CSE) ne sont pas pris en charge pour cette offre. Voir Utilisation des points de terminaison de service pour se connecter en privé à Secrets Manager.
- Accès à l'interface utilisateur de Vault: vous devez utiliser un VPN Client-to-Site qui achemine le trafic via le VPE. L'interface utilisateur de Vault privée URL n'est pas accessible depuis un navigateur situé en dehors du réseau privé IBM Cloud sans VPN. Consultez la section Utilisation d'un VPN client-site pour se connecter de manière sécurisée à Secrets Manager.
Si vous prévoyez d'utiliser à la fois des instances de type
Vault DedicatedetStandard, adoptez une convention de nommage permettant d'identifier facilement le type d'instance, par exemple en incluant-standardou-vault dedicateddans le nom de l'instance. -
Cliquez sur Créer.
Le provisionnement s'effectue généralement en quelques minutes, mais peut prendre jusqu'à 15 minutes.
Pour plus d'informations sur la mise en service d'une instance, consultez la section Création d'une instance.
Générer un jeton d'administrateur
Pour accéder à l'interface utilisateur de Vault en vue de la configuration initiale, générez un jeton d'administrateur.
Les jetons d'administration sont destinés uniquement à la configuration initiale et à l'accès d'urgence. Révoquez-les dès que vous avez terminé vos tâches de configuration.
Génération d'un jeton d'administration dans l'interface utilisateur
- Dans le tableau de bord de votre instance d' Secrets Manager, cliquez sur Créer un jeton dans la section Créer un nouveau jeton d'administrateur.
- Copiez le jeton d'administration généré et conservez-le en lieu sûr. Vous aurez besoin de ce jeton pour vous connecter à l'interface utilisateur de Vault.
Génération d'un jeton d'administrateur à partir de l'interface de ligne de commande (CLI)
Pour générer un nouveau jeton d'administration Vault à l'aide de l'interface CLI d' IBM Cloud, exécutez la commande suivante.
ibmcloud secrets-manager-instance-management admin-token-create --id {instance_id}
La commande renvoie le jeton d'administrateur de Vault. Conservez-le en lieu sûr : vous en aurez besoin pour vous connecter à l'interface utilisateur de Vault.
Génération d'un jeton d'administration à l'aide de l'API
curl -X POST \
-H "Authorization: Bearer {iam_token}" \
-H "Accept: application/json" \
"https://{region}.secrets-manager.cloud.ibm.com/v2/instances/{id}/admintokens"
Une requête réussie renvoie HTTP201 Created. La réponse contient un seul token champ : conservez-le en lieu sûr et utilisez-le pour vous connecter à l'interface utilisateur de Vault. Le jeton est valable pendant 1
heure.
Génération d'un jeton d'administration avec Terraform
Pour générer un jeton d'administrateur Vault avec Terraform, utilisez la ressource ibm_sm_admin_token. Le jeton est valable pendant 1 heure et est automatiquement renouvelé lorsqu'il est sur le point d'expirer.
resource "ibm_sm_admin_token" "sm_admin_token" {
instance_id = "bfc50c2e-d66d-4f37-9ccf-9713f8325b39"
}
Une fois la ressource créée, le jeton d’administrateur Vault est disponible dans l’attribut token.
Ouvrir l'interface utilisateur de Vault
Utilisez le point de terminaison de l'API Vault pour ouvrir l'interface utilisateur de Vault et vous connecter à l'aide du jeton d'administrateur.
- Dans le tableau de bord de l'instance d' Secrets Manager, cliquez sur Lancer l'interface utilisateur Web pour accéder à l'interface utilisateur native de Vault.
- Sur la page de connexion à Vault, utilisez le jeton d'administrateur que vous avez créé et effectuez la configuration initiale de Vault.
Révoquer le jeton d'administrateur
Une fois la configuration initiale terminée, révoquez tous les jetons d'administrateur actifs afin de réduire le risque d'accès non autorisé.
Révocation des jetons d'administrateur dans l'interface utilisateur
- Dans le tableau de bord de votre instance d' Secrets Manager, cliquez sur Révoquer dans la section Révoquer tous les jetons d'administrateur.
- Confirmez la révocation lorsque vous y êtes invité.
La révocation du jeton l'invalide immédiatement et contribue à réduire le risque d'accès non autorisé.
Révocation des jetons d'administrateur depuis l'interface de ligne de commande (CLI)
Pour révoquer tous les jetons d'administrateur Vault actifs à l'aide de l'interface de ligne de commande (CLI) de l' IBM Cloud, exécutez la commande suivante.
ibmcloud secrets-manager-instance-management admin-tokens-delete --id {instance_id}
Cette opération invalide immédiatement tous les jetons d'administrateur, ce qui nécessite la génération de nouveaux jetons pour tout accès administratif futur.
Révocation des jetons d'administrateur via l'API
curl -X DELETE \
-H "Authorization: Bearer {iam_token}" \
"https://{region}.secrets-manager.cloud.ibm.com/v2/instances/{id}/admintokens"
Une révocation réussie renvoie un code d'état 204 No Content.
Etapes suivantes
Une fois connecté à Vault, vous pouvez poursuivre la configuration initiale de votre instance.
- Pour configurer les méthodes d'authentification pour vos équipes et vos applications, consultez la section Configuration des méthodes d'authentification.
- Pour intégrer ces produits à vos applications à l'aide de l'API Vault, de l'interface de ligne de commande (CLI) ou des kits de développement logiciel (SDK), consultez la section Intégration à vos applications.
- Pour découvrir les fonctionnalités de l'API et de l'interface CLI de Vault, consultez la présentation de référence de l'API et de l'interface CLI.