Integration von Secrets Manager in Schematics Terraform mit Hilfe der Konsole

Folgen Sie den Schritten zur Aktivierung von Secrets Manager in Schematics, um eine sichere Verbindung mit Schematics Terraform herzustellen.

1. Melden Sie sich bei der Konsole IBM Cloud an.
2. Klicken Sie auf das Menü > Plattformautomatisierung > Schematics > Terraform > Arbeitsbereich erstellen.
   • Im Abschnitt Vorlage angeben:
     • GitHub, GitLab, oder Bitbucket repository URL- <provide your Terraform template Git repository URL>.
     • Persönlicher Zugangstoken- <leave it blank>. Sie können auf Open reference picker klicken, um Ihre Secrets Manager Schlüsselreferenz auszuwählen. Weitere Informationen finden Sie unter Erstellen einer Secrets Manager Instanz.
3. Auf der Seite Referenz auswählen wählen Sie Konto, Dienstinstanz und Geheimnis.
4. Klicken Sie auf OK.
5. Klicken Sie auf Erstellen, um einen Arbeitsbereich zu erstellen.

Beachten Sie die geheime Referenz für eine Eingangsvariable, die als Referenz gespeichert ist.

Schritte zur Integration von Secrets Manager in Schematics mit Hilfe von CLI

Befolgen Sie die Schritte zur Aktivierung von Secrets Manager in Schematics, um die Terraform Schematics sicher zu aktualisieren.

1. Laden Sie die Befehlszeile herunter, installieren Sie sie und führen Sie die gemeinsamen Befehle aus, um Ihre Region anzuvisieren, eine Service-to-Service-Richtlinie zu erstellen, eine Secrets Manager-Instanz zu erstellen, die Secrets in Ihrem Terraform-Code zu referenzieren und anzuwenden.

   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. Verweisen Sie auf das Geheimnis in Ihrem Terraform-Code.

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

3. Übernehmen Sie den Arbeitsbereich Schematics

   ibmcloud schematics workspace apply --id <WORKSPACE_ID>
   

Integration von Secrets Manager in Schematics Terraform mit Hilfe der API

Folgen Sie den Schritten zur Aktivierung von Secrets Manager in Schematics, um eine sichere Verbindung mit Schematics Terraform herzustellen.

1. Befolgen Sie die Schritte, um Ihren IAM Zugriffstoken abzurufen und authentifizieren Sie mit IBM Cloud Schematics mit der API.

2. Erstellen Sie eine Secrets Manager Instanz (falls noch nicht erstellt), indem Sie Ihren Zielendpunkt und IBM Cloud Resource Controller API verwenden.

    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. Erstellen Sie ein Geheimnis in Secrets Manager mit Hilfe von Secrets Manager API.

    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. Erstellen Sie einen Dienst für die IAM-Richtlinie

    {
      "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. Verweisen Sie auf das Geheimnis in Ihrer Terraform-Variablendatei, indem Sie Schematics workspace verwenden.

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

6. Aktualisieren Sie den Arbeitsbereich mit der Terraform-Vorlage, um das Geheimnis zu referenzieren.

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

7. Wenden Sie den Arbeitsbereich mit der Terraform-Vorlage an.

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

Einbindung von Secrets Manager in Schematics Terraform mit Hilfe von Terraform

Folgen Sie den Schritten zur Aktivierung von Secrets Manager in Schematics, um eine sichere Verbindung mit Schematics Terraform herzustellen.

1. Definieren Sie die Secrets Manager Instanz.

2. Erstellen Sie ein Geheimnis in Secrets Manager. Sie können die Befehlszeilenschnittstelle verwenden oder manuell Geheimnisse erstellen. In Terraform werden Geheimnisse normalerweise referenziert und nicht direkt erstellt.

3. Erstellen Sie die IAM Service-to-Service-Richtlinie.

4. Verweisen Sie auf das Geheimnis in Terraform-Variablen. Ersetzen Sie secret-id durch die tatsächliche ID des in Secrets Manager gespeicherten Geheimnisses.

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

5. Verwenden Sie den Schematics-Provider oder die CLI, um Ihren Arbeitsbereich mit der vorherigen Konfiguration zu erstellen.