Erstellen von Netzwerkzonen mit Hilfe der API

Sie können Netzzonen mit dem Befehl create-zone erstellen. Weitere Informationen finden Sie in der API-Dokumentation. Sie können Secrets Manager als Servicereferenz zu Netzzonen hinzufügen, damit Secrets Manager auf Ressourcen und Services in Ihrem Konto zugreifen kann, die Gegenstand einer Regel sind.

Das Attribut serviceRef für Secrets Manager lautet secrets-manager.

Sie können bestimmen, welche Services verfügbar sind, indem Sie nach Referenzziele suchen.

Beispielnutzdaten zum Hinzufügen von Secrets Manager zu einer Netzzone.

{
  "name": "Example zone 1",
  "description": "",
  "addresses": [
    {
      "type": "serviceRef",
      "ref": {
        "service_name": "secrets-manager",
        "account_id": "ACCOUNT-ID"
      }
    }
  ]
}

Beispielnutzdaten zum Hinzufügen mehrerer Services, IP-Adressen und VPCs zu einer Netzzone.

{
  "name": "zone",
  "description": "",
  "addresses": [
    {
      "type": "ipAddress",
      "value": "192.168.0.0"
    },
    {
      "type": "vpc",
      "value": "crn:v1:bluemix:public:is:us-east:a/CRN"
    },
    {
      "type": "vpc",
      "value": "crn:v1:bluemix:public:is:us-south:a/CRN"
    },
    {
      "type": "serviceRef",
      "ref": {
        "service_name": "cloud-object-storage",
        "account_id": "ACCOUNT-ID"
      }
    },
    {
      "type": "serviceRef",
      "ref": {
        "service_name": "codeengine",
        "account_id": "ACCOUNT-ID"
      }
    },
    {
      "type": "serviceRef",
      "ref": {
        "service_name": "containers-kubernetes",
        "account_id": "ACCOUNT-ID"
      }
    },
    {
      "type": "serviceRef",
      "ref": {
        "service_type": "platform_service",
        "account_id": "ACCOUNT-ID"
      }
    },
    {
      "type": "serviceRef",
      "ref": {
        "service_name": "iam-groups",
        "account_id": "ACCOUNT-ID"
      }
    }
  ],
  "excluded": []
}

Nachdem Sie Zonen erstellt haben, können Sie diese aktualisieren oder entfernen.

Erstellen von Netzwerkzonen mit Hilfe der Benutzeroberfläche

Nachdem Sie die Voraussetzungen und Anforderungen festgelegt haben, können Sie Zonen in der Benutzerschnittstelle (UI) erstellen. Weitere Informationen finden Sie unter Kontextbasierte Einschränkungen erstellen.

1. Bestimmen Sie die Ressourcen, die Sie Ihrer Zulassungsliste hinzufügen möchten.
2. Führen Sie die Schritte zum Erstellen kontextbasierter Einschränkungen in der Konsole aus. Fügen Sie den Service Secrets Manager Ihren Netzzonen hinzu, damit IBM Cloud® Secrets Manager auf Services und Ressourcen in Ihrem Account zugreifen kann.

Nachdem Sie Zonen erstellt haben, können Sie diese auch aktualisieren oder entfernen.

Erstellen von Netzwerkzonen mit Hilfe der CLI

Mit dem Befehl cbr-zone-create können Sie Netzadressen, VPCs und Servicereferenzen zu Netzzonen hinzufügen. Weitere Informationen finden Sie in der CLI-Referenz für CBR. Fügen Sie Secrets Manager als Servicereferenz zu Netzzonen hinzu und ermöglichen Sie Secrets Manager den Zugriff auf Ressourcen und Services in Ihrem Konto, die Gegenstand einer Regel sind.

1. Um Netzzonen über die Befehlszeilenschnittstelle zu erstellen, installieren Sie das CBR-CLI-Plug-in.
2. Mit dem Befehl cbr-zone-create können Sie Netzzonen Ressourcen hinzufügen. Weitere Informationen finden Sie in der CLI-Referenz für CBR. Beachten Sie, dass service_name für Secrets Manager secrets-manager ist.

Führen Sie den ibmcloud cbr service-ref-targets -Befehl aus, um eine Liste der verfügbaren Servicereferenzen zu suchen.

Beispielbefehl zum Hinzufügen des secrets-manager-Service zu einer Netzzone.

ibmcloud cbr zone-create --name example-zone-1 --description "Example zone 1" --service-ref service_name=secrets-manager

Regeln mithilfe der API erstellen

Sie können Regeln mit der API definieren, indem Sie die Informationen verwenden, die Sie beim Erstellen von Netzzonen gesammelt haben.

Im folgenden Beispiel erfahren Sie, wie Sie Regeln für Secrets Managererstellen. Weitere Informationen finden Sie in der API-Dokumentation.

Die folgenden Beispielnutzdaten erstellen eine Regel, die den CLUSTER-ID-Cluster schützt. Nur Ressourcen in der Zone NETWORK-ZONE-ID können auf den Cluster zugreifen. Wenn keine operations angegeben werden, können Ressourcen in der NETWORK-ZONE-ID-Zone sowohl auf die cluster-als auch auf management-API zugreifen.

{
  "description": "Example rule 1",
  "resources": [
    {
      "attributes": [
        {
          "name": "accountId",
          "value": "ACCOUNT-ID"
        },
        {
          "name": "serviceName",
          "value": "secrets-manager"
        },
        {
          "name": "serviceInstance",
          "value": "CLUSTER-ID"
        }
      ]
    }
  ],
  "contexts": [
    {
      "attributes": [
        {
          "name": "networkZoneId",
          "value": "NETWORK-ZONE-ID"
        },
        {
          "name": "endpointType",
          "value": "private"
        }
      ]
    }
  ]
}

Nach der Erstellung von Regeln können Sie diese aktualisieren und löschen.

Erstellen von Regeln mit Hilfe der Benutzeroberfläche

Nachdem Sie die Voraussetzungen und Anforderungen festgelegt haben, können Sie Regeln in der Benutzerschnittstelle erstellen.

1. Bestimmen Sie die Ressourcen, die Sie Ihrer Zulassungsliste hinzufügen möchten.
2. Führen Sie die Schritte zum Erstellen kontextbasierter Einschränkungen in der Konsole aus. Fügen Sie den Service Secrets Manager Ihren Netzzonen hinzu, damit IBM Cloud® Secrets Manager auf Services und Ressourcen in Ihrem Account zugreifen kann.

Nach der Erstellung von Regeln können Sie diese aktualisieren und löschen.

Regeln über die Befehlszeilenschnittstelle erstellen

Sehen Sie sich die folgenden Beispiele an, um zu erfahren, wie Regeln für Secrets Managererstellt werden. Weitere Informationen finden Sie in der CLI-Referenz für CBR.

1. Um Regeln über die Befehlszeilenschnittstelle zu erstellen, installieren Sie das CBR-CLI-Plug-in.
2. Sie können den ibmcloud cbr rule-create -Befehl verwenden, um CBR-Regeln zu erstellen. Weitere Informationen finden Sie in der CLI-Referenz für CBR. Beachten Sie, dass service_name für Secrets Manager secrets-manager ist. Führen Sie den Befehl ibmcloud cbr service-ref-targets aus, um eine Liste der Servicenamen zu suchen. Führen Sie den Befehl ibmcloud cbr api-types --service-name SERVICE aus, um eine Liste der API-Typen für einen Service zu suchen.

Beispielbefehl zum Erstellen einer Regel, die den Schlüssel addresses und den API-Typ cluster sowie den Typ ipAddress verwendet.

ibmcloud cbr rule-create my-rule-1 --service-name secrets-manager --api-type crn:v1:bluemix:public:secrets-manager::::api-type:cluster --zone-id ZONE-ID

Der folgende Befehl erstellt eine Regel, die den CLUSTER-ID-Cluster schützt. Nur Ressourcen in der NETWORK-ZONE-ID-Netzzone können auf den Cluster zugreifen. Diese Regel enthält die API-Typen cluster und management.

ibmcloud cbr rule-create my-rule-2 --service-name secrets-manager --service-instance CLUSTER-ID --zone-id NETWORK-ZONE-ID