Intégrer Secrets Manager dans Schematics Terraform en utilisant la console

Suivez les étapes pour permettre à Secrets Manager dans Schematics de se connecter en toute sécurité à Schematics Terraform.

1. Connectez-vous à la console IBM Cloud.
2. Cliquez sur l'icône Menu > Platform Automation > Schematics > Terraform > Créer un espace de travail.
   • Dans la section Specify Template:
     • GitHub, GitLab, ou Bitbucket référentiel URL- <provide your Terraform template Git repository URL>.
     • Jeton d'accès personnel- <leave it blank>. Vous pouvez cliquer sur Open reference picker pour sélectionner votre clé de référence Secrets Manager. Pour plus d'informations, voir la création d'une instance Secrets Manager.
3. Dans la page Sélectionner une référence, sélectionnez Compte, Instance de service et Secret.
4. Cliquez sur OK.
5. Cliquez sur Créer pour créer un espace de travail.

Observez la référence secrète d'une variable d'entrée, qui est stockée en tant que référence.

Étapes pour intégrer Secrets Manager dans Schematics en utilisant le CLI

Suivez les étapes pour permettre à Secrets Manager dans Schematics de mettre à jour en toute sécurité le Terraform Schematics.

1. Téléchargez et installez la ligne de commande et exécutez les commandes partagées pour cibler votre région, créer une politique de service à service, créer une instance Secrets Manager, référencer les secrets dans votre code Terraform et appliquer.

   ibmcloud login --sso
   ibmcloud target -r <region>
   ibmcloud iam service-policy-create --source-service-name schematics --target-service-instance-name <your-secrets-manager-name> --roles "Viewer,SecretReader"
   ibmcloud secrets-manager secret-create --secret-type arbitrary --name <secret-name> --payload <secret-value>
   

2. Faites référence au secret dans votre code Terraform.

    variable "my_secret" {
    default = "ref://secrets-manager.<REGION>.<INSTANCE_NAME>/<SECRET_GROUP>/SECRET_NAME"
   }
   

3. Appliquer l'espace de travail Schematics

   ibmcloud schematics workspace apply --id <WORKSPACE_ID>
   

Intégrer Secrets Manager dans Schematics Terraform en utilisant l'API

Suivez les étapes pour permettre à Secrets Manager dans Schematics de se connecter en toute sécurité à Schematics Terraform.

1. Suivez les étapes permettant d'extraire votre jeton d'accès IAM et de vous authentifier auprès d'IBM Cloud Schematics à l'aide de l'API.

2. Créez une instance Secrets Manager (si ce n'est pas déjà fait) en utilisant votre point de terminaison cible et l'API du contrôleur de ressources IBM Cloud.

    curl -X POST /v1/resource_instances -H "Authorization: <iam_access_token>" -d '{"name": "my-secrets-manager",
    "target": "test-eu-de",
    "resource_group": "default",
    "resource_plan_id": "<plan-id-for-secrets-manager>"
    }'
   

3. Créez un secret dans Secrets Manager en utilisant l'API Secrets Manager.

    curl -X POST /api/v1/secrets/arbitrary  -H "Authorization: <iam_access_token>" -d '{"name": "my-token-secret","description": "Token for private Git repo","secret_group_id": "<secret-group-id>","resources": [],"payload": "your-token-value"}'
   

4. Créer un service pour gérer la politique IAM

    {
      "type": "service",
      "subjects": [{
        "attributes": [{
          "name": "serviceName",
          "value": "schematics"
        }]
      }],
      "roles": [
        { "role_id": "crn:v1:bluemix:public:iam::::role:Viewer" },
        { "role_id": "crn:v1:bluemix:public:iam::::role:SecretReader" }
      ],
      "resources": [{
        "attributes": [{
          "name": "serviceInstance",
          "value": "<secrets-manager-instance-id>"
        }]
      }]
    }
   

5. Faites référence au secret dans votre fichier de variables Terraform en utilisant l'espace de travail Schematics.

    variable "git_token" {
    default = "ref://secrets-manager.<REGION>.<INSTANCE_NAME>/<SECRET_GROUP>/SECRET_NAME"
   }
   

6. Mettre à jour l'espace de travail avec le modèle Terraform pour référencer le secret.

   curl -X PATCH /v1/workspaces/{workspace_id}
   

7. Appliquer l'espace de travail avec le modèle Terraform.

   curl -X POST /v1/workspaces/{workspace_id}/actions/apply
   

Intégrer Secrets Manager dans Schematics Terraform en utilisant Terraform

Suivez les étapes pour permettre à Secrets Manager dans Schematics de se connecter en toute sécurité à Schematics Terraform.

1. Définir l'instance Secrets Manager.

2. Créez un secret sur Secrets Manager. Vous pouvez utiliser l'interface de programmation ou créer manuellement des secrets. Dans Terraform, les secrets sont généralement référencés, et non créés directement.

3. Créer une politique IAM Service.

4. Référencez le secret dans les variables Terraform. Remplacer secret-id par l'ID réel du secret stocké dans Secrets Manager.

    variable "git_token" {
    default = "ref://secrets-manager.<REGION>.<INSTANCE_NAME>/<SECRET_GROUP>/SECRET_NAME"
   }
   

5. Utilisez le fournisseur Terraform Schematics ou le CLI pour créer votre espace de travail avec la configuration précédente.