Beispiel für die Verwendung der Konsole

Durch die Erstellung von Netzwerkzonen erstellen Sie eine Liste der zulässigen Standorte, von denen eine Zugriffsanfrage ausgeht. Fügen Sie den Katalogverwaltungsservice dieser Zulassungsliste als Servicereferenz hinzu. Nachdem Sie eine Netzzone erstellt haben, können Sie sie zu einer Regel hinzufügen.

Führen Sie die folgenden Schritte aus, um eine Netzwerkzone zu erstellen:

1. Klicken Sie in der IBM Cloud-Konsole auf Verwalten > Kontextbasierte Einschränkungen und wählen Sie Netzzonen aus.

2. Klicken Sie auf Erstellen.

   Statt eine Zone durch Eingaben in der Benutzerschnittstellen zu erstellen, können Sie das JSON-Codeformular verwenden, um direkt JSON-Code zum Erstellen einer Zone einzugeben. Klicken Sie hierzu auf Als JSON-Code eingeben.

3. Geben Sie einen eindeutigen Namen und eine Beschreibung ein. Beispiel: "Katalogzone" und "Interaktion von Katalogen mit anderen Services zulassen"

4. Referenzieren Sie einen Service. Wählen Sie den Servicetyp "IAM-Services" und anschließend den Katalogverwaltungsservice aus. Klicken Sie auf Hinzufügen, um die IP-Adressen des Service Ihrer Netzzone zuzuordnen.

5. Klicken Sie auf Weiter, um Ihre Netzzone zu überprüfen.

6. Klicken Sie auf Erstellen.

Beispiel unter Verwendung der CLI

Durch die Erstellung von Netzwerkzonen erstellen Sie eine Liste der zulässigen Standorte, von denen eine Zugriffsanfrage ausgeht. Fügen Sie den Katalogverwaltungsservice dieser Zulassungsliste als Servicereferenz hinzu. Nachdem Sie eine Netzzone erstellt haben, können Sie sie zu einer Regel hinzufügen.

1. Installieren Sie das CLI-Plug-in für kontextbasierte Einschränkungen, indem Sie den folgenden Befehl ausführen:

   ibmcloud plugin install cbr
   

2. Verwenden Sie zum Erstellen einer Netzzone den Befehl cbr zone-create.

   Im folgenden Beispiel wird eine Netzzone mit einer Servicereferenz erstellt. Weitere Informationen finden Sie unter Servicereferenzen.

   ibmcloud cbr zone-create --name CatalogZone --description "Allow catalogs to interact with other services" --service-ref service_name=globalcatalog-collection
   

   Zum Suchen einer Liste der verfügbaren Servicereferenzen führen Sie den Befehl ibmcloud cbr service-ref-targets aus.

Beispiel für die Verwendung der API

Durch die Erstellung von Netzwerkzonen erstellen Sie eine Liste der zulässigen Standorte, von denen eine Zugriffsanfrage ausgeht. Fügen Sie den Katalogverwaltungsservice dieser Zulassungsliste als Servicereferenz hinzu. Nachdem Sie eine Netzzone erstellt haben, können Sie sie zu einer Regel hinzufügen.

Um eine Netzzone zu erstellen, die den Katalogverwaltungsservice enthält, rufen Sie die API für kontextbasierte Einschränkungen wie im folgenden Beispiel gezeigt auf:

{
  "name": "Catalog zone",
  "description": "Allow catalogs to interact with other services",
  "addresses": [
    {
      "type": "serviceRef",
      "ref": {
        "service_name": "globalcatalog-collection"
      }
    }
  ]
}

AddressIPAddress ipAddressModel = new AddressIPAddress.Builder()
ServiceRefValue serviceRefValueModel = new ServiceRefValue.Builder()
  .accountId(accountID)
  .serviceName("globalcatalog-collection")
  .build();
AddressServiceRef serviceRefAddressModel = new AddressServiceRef.Builder()
  .type("serviceRef")
  .ref(serviceRefValueModel)
  .build();
CreateZoneOptions createZoneOptions = new CreateZoneOptions.Builder()
  .name("Catalog zone")
  .accountId(accountID)
  .description("Allow catalogs to interact with other services")
  .addresses(java.util.Arrays.asList(ipAddressModel, ipRangeAddressModel, subnetAddressModel, vpcAddressModel, serviceRefAddressModel))
  .excluded(java.util.Arrays.asList(excludedIPAddressModel))
  .build();

Response<Zone> response = contextBasedRestrictionsService.createZone(createZoneOptions).execute();
Zone zone = response.getResult();

System.out.println(zone);

// Request models needed by this operation.

// AddressServiceRef
const serviceRefAddressModel = {
  type: 'serviceRef',
  ref: {
    account_id: accountId,
    service_name: 'globalcatalog-collection',
  },
};

const params = {
  name: 'Catalog zone',
  accountId,
  addresses: [ipAddressModel, ipRangeAddressModel, subnetAddressModel, vpcAddressModel, serviceRefAddressModel],
  excluded: [excludedIPAddressModel],
  description: 'Allow catalogs to interact with other services',
};

try {
  const res = await contextBasedRestrictionsService.createZone(params);
  zoneId = res.result.id;
  zoneRev = res.headers.etag;
  console.log(JSON.stringify(res.result, null, 2));
} catch (err) {
  console.warn(err);
}

service_ref_address_model = {
  'type': 'serviceRef',
  'ref': {
    'account_id': account_id,
    'service_name': 'globalcatalog-collection',
  }
}

zone = context_based_restrictions_service.create_zone(
  name='catalog zone',
  account_id=account_id,
  addresses=[service_ref_address_model],
  description='allow catalogs to interact with other services',
).get_result()

print(json.dumps(zone, indent=2))

serviceRefAddressModel := &contextbasedrestrictionsv1.AddressServiceRef{
  Type: core.StringPtr("serviceRef"),
  Ref: &contextbasedrestrictionsv1.ServiceRefValue{
    AccountID:   core.StringPtr(accountID),
    ServiceName: core.StringPtr("globalcatalog-collection"),
  },

createZoneOptions := contextBasedRestrictionsService.NewCreateZoneOptions()
createZoneOptions.SetName("catalog zone")
createZoneOptions.SetAccountID(accountID)
createZoneOptions.SetDescription("allow catalogs to interact with other services")
createZoneOptions.SetAddresses([]contextbasedrestrictionsv1.AddressIntf{serviceRefAddressModel})

zone, response, err := contextBasedRestrictionsService.CreateZone(createZoneOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(zone, "", "  ")
fmt.Println(string(b))

Um eine Liste der verfügbaren Dienstreferenzen zu finden, rufen Sie die Methode ListAvailableServicerefTargets auf.