Erstellen von Netzwerkzonen mithilfe der API

Sie können Netzzonen mit dem Befehl create-zone erstellen. Weitere Informationen finden Sie in den API-Dokumenten.

Das serviceRef Attribut für VPC-Infrastrukturdienste lautet is. Cloud Block Storage ist server-protect, und File Storage for VPC ist is.share.

{
  "name": "Example zone 1",
  "description": "",
  "addresses": [
    {
      "type": "serviceRef",
      "ref": {
        "service_name": "is"
      }
    }
  ]
}

{
  "name": "Example zone 1",
  "description": "",
  "addresses": [
    {
      "type": "serviceRef",
      "ref": {
        "service_name": "server-protect"
      }
    }
  ]
}

Erstellen von Netzwerkzonen über die Befehlszeilenschnittstelle (CLI)

1. Um Netzwerkzonen über die CLI zu erstellen, installieren Sie das CBR-CLI-Plugin.

2. Verwenden Sie den cbr-zone-create Befehl, um Netzwerkstandorte, VPCs und Dienstreferenzen zu Netzwerkzonen hinzuzufügen. Weitere Informationen finden Sie in der C BR-CLI-Referenz.

   Um eine Liste der verfügbaren Service-Referenzziele anzuzeigen, führen Sie den ibmcloud cbr service-ref-targetsBefehl aus. Die service_name für VPC-Infrastrukturdienste ist is. Cloud Block Storage ist server-protect, und File Storage for VPC ist is.share.

   Der folgende Beispielbefehl fügt den is Dienst, der in der IBM Cloud®-Konsole als „VPC Infrastructure Services“ bezeichnet wird, zu einer Netzwerkzone hinzu.

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

   Der folgende Beispielbefehl fügt die server-protect Service, genannt* Cloud Block Storage* In IBM Cloud® Konsole, zu einer Netzwerkzone.

   ibmcloud cbr zone-create --name example-zone-1 --description "Example zone 1" --service-ref service_name=server-protect
   

Netzzonen über die Konsole erstellen

1. Legen Sie fest, welche Ressourcen Sie Ihrer Zulassungsliste hinzufügen wollen.
2. Überprüfen Sie den Abschnitt „Dienstreferenzen“, um festzustellen, ob Sie Ihrer Netzwerkzone eine Dienstreferenz hinzufügen müssen.
3. Führen Sie die folgenden Schritte aus, um kontextbasierte Einschränkungen in der Konsole zu erstellen.

Regeln mithilfe der API erstellen

Sehen Sie sich die folgenden Beispielanforderungen zum Erstellen von Regeln an. Weitere Informationen zu v1/rules API, siehe API-Dokumentation.

Nach der Erstellung einer Regel kann es bis zu 10 Minuten dauern, bis Sie diese Regel aktualisieren können.

Mit der folgenden Beispiel-Nutzlast wird eine Regel erstellt, die die virtuellen Serverinstanzen schützt und den zugriff nur von der angegebenen Netzwerkzone über einen privaten Endpunkt erlaubt.

{
  "contexts": [
    {
      "attributes": [
        {
          "name": "endpointType",
          "value": "private"
        },
        {
          "name": "networkZoneId",
          "value": "45ec64065b7c2bf84b3edec803335111"
        }
      ]
    }
  ],
  "resources": [
    {
      "attributes": [
        {
          "name": "resourceGroupId",
          "value": "1171749e3a8545069d04e6fca1ded18f"
        },
        {
          "name": "serviceName",
          "value": "is"
        },
        {
          "name": "instanceId",
          "value": "*"
        }
      ]
    }
  ]
}

Regeln über die Befehlszeilenschnittstelle erstellen

1. Um Regeln über die Befehlszeilenschnittstelle zu erstellen, installieren Sie das CBR-CLI-Plug-in.
2. Verwenden Sie den ibmcloud cbr rule-create -Befehl, um CBR-Regeln zu erstellen. Weitere Informationen finden Sie in der CLI-Referenz für CBR.

Die folgenden Beispiele sind Durchsetzungsregeln. Sie können Berichte nur erstellen, indem Sie --enforcement-mode report hinzufügen.

Der folgende CLI-Beispielbefehl erstellt eine kontextbasierte Einschränkungsregel für alle virtuellen Serverinstanzen im aktuellen Konto:

ibmcloud cbr rule-create  --zone-id a7eeb5dd8e6bdce670eba1afce18e37f --description "Test CBR for VSIs" --service-name is --resource-attributes "instanceId=*"

Der folgende Beispiel-CLI-Befehl erstellt eine kontextbasierte Einschränkungsregel für einen bestimmten Blockspeicherdatenträger im aktuellen Konto:

ibmcloud cbr rule-create --zone-id a7eeb5dd8e6bdce670eba1afce18e37f --description "Test CBR for volume" --service-name is --resource-attributes "volumeId=UUID_OF_THE_VOLUME"

Der folgende CLI-Beispielbefehl erstellt eine kontextbasierte Einschränkungsregel für alle virtuellen Serverinstanzen im aktuellen Account und beschränkt den Zugriff auf private Endpunkte:

ibmcloud cbr rule-create --context-attributes 'endpointType=private' --zone-id a7eeb5dd8e6bdce670eba1afce18e37f --description "Test CBR for VSIs" --service-name is --resource-attributes "instanceId=*"

Der folgende CLI-Beispielbefehl erstellt eine kontextbasierte Einschränkungsregel für alle virtuellen Serverinstanzen in der Ressourcengruppe und beschränkt den Zugriff auf private Endpunkte:

ibmcloud cbr rule-create --context-attributes 'endpointType=private' --zone-id a7eeb5dd8e6bdce670eba1afce18e37f --description "Test CBR for VSIs" --service-name is --resource-attributes "instanceId=*" --resource-group-id 1171749e3a8545069d04e6fca1ded18f

Regeln in der Konsole erstellen

1. Rufen Sie Verwalten > Kontextbasierte Einschränkungen in der Konsole von IBM Cloud® auf.

2. Wählen Sie „ Regeln “ aus und klicken Sie auf „ Erstellen “.

3. Wählen Sie VPC Infrastructure Services aus und klicken Sie auf Weiter.

4. Wählen Sie als Geltungsbereich der Regel „ Alle Ressourcen “ oder „ Bestimmte Ressourcen “ aus. Weitere Informationen finden Sie unter Schutz der Ressourcen der VPC-Infrastrukturdienste. Klicken Sie auf Weiter.

5. Definieren Sie die zulässigen Endpunkttypen.

   • Behalten Sie die Einstellung Nein bei, um alle Endpunkttypen zuzulassen.
   • Setzen Sie den Schalter auf Ja, um nur bestimmte Endpunkttypen zuzulassen, und treffen Sie dann eine Auswahl in der Liste.

6. Wählen Sie eine oder mehrere vorhandene Netzwerkzonen aus oder erstellen Sie eine Netzwerkzone, indem Sie auf „Erstellen“ klicken.

   Kontexte definieren die Position, von der aus auf Ihre Ressourcen zugegriffen werden kann, und verknüpfen Ihre Netzzone mit Ihrer Regel.

7. Klicken Sie auf „Hinzufügen“, um Ihre Konfiguration zur Übersicht hinzuzufügen. Klicken Sie auf Weiter.

8. Benennen Sie Ihre Regel und wählen Sie aus, wie sie durchgesetzt werden soll. Klicken Sie anschließend auf Erstellen.