Schlüssel/Wert-Paar-Zuordnungen für die Umgebung erstellen und bearbeiten

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. info

In diesem Thema wird beschrieben, wie Sie Schlüssel/Wert-Zuordnungen (Key Value Maps, KVMs) in der Benutzeroberfläche erstellen und bearbeiten. Die in der Benutzeroberfläche erstellten KVMs sind auf die Umgebung beschränkt. Weitere Informationen zu KVMs und zum Bereich finden Sie unter Mit Schlüssel/Wert-Zuordnungen arbeiten.

Verschlüsselte KVMs in der Edge-Benutzeroberfläche mit Edge for Private Cloud aktivieren

Verschlüsselte KVMs werden in Edge for Private Cloud Version 4.17.01 und höher unterstützt. Der Support für verschlüsselte KVMs in der Edge-Benutzeroberfläche ist jedoch standardmäßig deaktiviert. So aktivieren Sie die Unterstützung für verschlüsselte KVMs in der Edge-Benutzeroberfläche:

  1. Öffnen Sie auf dem Edge-Benutzeroberflächenserver die Datei ui.properties in einem Editor. Wenn die Datei nicht vorhanden ist, erstellen Sie sie:
    > vi /opt/apigee/customer/application/ui.properties
  2. Setzen Sie das Token conf_apigee_apigee.feature.kvmencryption auf „true“:
    conf_apigee_apigee.feature.kvmencryption=true
  3. Speichern Sie die Änderungen.
  4. Ändern Sie den Eigentümer von ui.properties in "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Starten Sie die Edge-Benutzeroberfläche neu:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

Umgebungsbezogene Schlüssel/Wert-Zuordnungen verwalten

Verwalten Sie Ihre KVMs wie unten beschrieben. KVMs werden auf Umgebungsebene definiert. Wenn Sie beispielsweise eine KVM in der Umgebung „test“ erstellen, haben API-Proxys, die in der Umgebung „prod“ ausgeführt werden, keinen Zugriff auf die KVM.

Edge

So verwalten Sie KVMs mit der Edge-Benutzeroberfläche:

  1. Melden Sie sich unter apigee.com/edge an.
  2. Wählen Sie in der linken Navigationsleiste Admin > Umgebungen > Schlüssel/Wert-Zuordnungen aus.
  3. So erstellen Sie eine KVM:
    1. Klicken Sie auf + Schlüssel/Wert-Zuordnung.
    2. Geben Sie die Attributwerte für die neue KVM ein. In der folgenden Tabelle werden die Einstellungen beschrieben.
      Property-Name Beschreibung
      Name Name der KVM. Darf in der Umgebung nur einmal vorkommen. Verweisen Sie auf diesen Namen aus Richtlinien, die mit der KVM interagieren.
      VerschlüsseltFlag, das angibt, ob die KVM verschlüsselt ist. In der Benutzeroberfläche werden verschlüsselte Werte als Sternchen (*****) angezeigt. Die Verschlüsselung wird für die gesamte Zuordnung festgelegt. Sie können die Verschlüsselung nicht für einzelne Einträge festlegen.
      Hinweis:Sie können KVMs nur beim Erstellen verschlüsseln. Nachdem eine Schlüssel Wert-Zuordnung erstellt wurde, können Sie sie nicht mehr verschlüsseln oder entschlüsseln.
    3. Klicken Sie auf Hinzufügen.
  4. So fügen Sie einer KVM einen Eintrag hinzu:
    1. Klicken Sie in der Liste auf den Namen der KVM, um die aktuellen Einträge anzuzeigen.
    2. Klicken Sie auf +.
    3. Geben Sie wie unten beschrieben die Attributwerte für den neuen KVM-Eintrag ein.
      Property-Name Beschreibung
      Schlüssel

      Schlüsselname, mit dem Sie in Ihren API-Proxys auf den Datenwert zugreifen.

      In Apigee Edge for Public Cloud dürfen Schlüsselnamen nicht länger als 2 KB sein.

      In der Edge-Benutzeroberfläche dürfen Namen kein „/“ enthalten.
      Wert

      Wert des Schlüssels. Geben Sie eine beliebige Kombination aus Zahlen, Buchstaben oder Sonderzeichen ein.

      Hinweis:Die Gesamtgröße einer KVM darf nicht mehr als 15 MB betragen.
    4. Klicken Sie auf Hinzufügen.
  5. So verwalten Sie die Schlüsseleinträge in einer KVM:
    1. Klicken Sie in der Liste auf den Namen der KVM, um die aktuellen Einträge anzuzeigen.
    2. Bewegen Sie den Mauszeiger auf den KVM-Eintrag, um das Aktionsmenü aufzurufen, und führen Sie eine der folgenden Aufgaben aus:
      • Wenn Sie den Wert eines Eintrags kopieren möchten, klicken Sie auf .
      • Wenn Sie einen Eintrag bearbeiten möchten, klicken Sie auf . Bearbeiten Sie dann den Eintrag und klicken Sie auf Aktualisieren.
      • Wenn Sie einen Eintrag löschen möchten, klicken Sie auf . Klicken Sie dann auf Löschen, um den Vorgang zu bestätigen.

Classic Edge (Private Cloud)

So erstellen und bearbeiten Sie KVMs mit der Classic Edge-Benutzeroberfläche:

  1. Melden Sie sich unter http://ms-ip:9000 an, wobei ms-ip die IP-Adresse oder der DNS-Name des Management Server-Knotens ist.
  2. Wählen Sie APIs > Umgebungskonfiguration > Schlüssel/Wert-Zuordnungen aus.
  3. Wählen Sie die Umgebung aus, für die Sie Caches konfigurieren möchten, z. B. test oder prod.
  4. So erstellen Sie eine KVM:
    1. Klicken Sie auf + Schlüssel/Wert-Zuordnung.
    2. Geben Sie wie unten beschrieben die Attributwerte für die neue KVM ein.
      Property-Name Beschreibung
      Name Name der KVM. Darf in der Umgebung nur einmal vorkommen. Verweisen Sie auf diesen Namen aus Richtlinien, die mit der KVM interagieren.
      VerschlüsseltFlag, das angibt, ob die KVM verschlüsselt ist. In der Benutzeroberfläche werden verschlüsselte Werte als Sternchen (*****) angezeigt. Die Verschlüsselung wird für die gesamte Zuordnung festgelegt. Sie können die Verschlüsselung nicht für einzelne Einträge festlegen.
      Hinweis:Sie können KVMs nur beim Erstellen verschlüsseln. Nachdem eine Schlüssel Wert-Zuordnung erstellt wurde, können Sie sie nicht mehr verschlüsseln oder entschlüsseln.
    3. Klicken Sie auf Hinzufügen.
  5. So fügen Sie einer KVM einen Eintrag hinzu:
    1. Klicken Sie in der Liste auf den Namen der KVM, um die Liste der Einträge zu maximieren.
    2. Klicken Sie auf + Eintrag.
    3. Geben Sie wie unten beschrieben die Attributwerte für den neuen KVM-Eintrag ein.
      Property-Name Beschreibung
      Schlüssel

      Schlüsselname, mit dem Sie in Ihren API-Proxys auf den Datenwert zugreifen. In der Edge-Benutzeroberfläche dürfen Namen kein „/“ enthalten.

      Hinweis: In Edge for Public Cloud dürfen Schlüsselnamen nicht länger als 2 KB sein.
      Wert

      Wert des Schlüssels. Geben Sie eine beliebige Kombination aus Zahlen, Buchstaben oder Sonderzeichen ein.

      Hinweis:Die Gesamtgröße einer KVM darf nicht mehr als 15 MB betragen.
    4. Klicken Sie auf Speichern.
  6. So bearbeiten oder löschen Sie die Schlüsseleinträge in einer KVM:
    1. Klicken Sie in der Liste auf den Namen der KVM, um die Liste der Schlüsseleinträge zu maximieren.
    2. Führen Sie eine der folgenden Aktionen aus:
      • Wenn Sie einen Eintrag bearbeiten möchten, klicken Sie auf Bearbeiten, bearbeiten Sie den Eintrag und klicken Sie auf Speichern.
      • Wenn Sie einen Eintrag löschen möchten, klicken Sie auf Löschen.