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

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

In diesem Thema erfahren Sie, wie Sie Schlüssel/Wert-Zuordnungen (KVMs) in der Benutzeroberfläche erstellen und bearbeiten. Die KVMs, die Sie in der UI erstellen, sind umgebungsbezogen. Weitere Informationen zu KVMs und Bereichen finden Sie unter Mit Schlüssel/Wert-Zuordnungen arbeiten.

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

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

  1. Öffnen Sie auf dem Edge-UI-Server 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 Neustart

Schlüssel/Wert-Zuordnungen für die Umgebung verwalten

Verwalten Sie Ihre KVMs wie unten beschrieben. KVMs werden im Bereich Umgebung definiert. Wenn Sie beispielsweise eine KVM in der Testumgebung erstellen, haben API-Proxys, die in der Produktionsumgebung ausgeführt werden, keinen Zugriff auf die KVM.

Edge

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

  1. Melden Sie sich unter apigee.com/edge an.
  2. Wählen Sie in der linken Navigationsleiste Verwaltung > Umgebungen > Schlüssel/Wert-Zuordnungen aus.
  3. So erstellen Sie eine KVM:
    1. Klicken Sie auf + Schlüssel/Wert-Zuordnung.
    2. Geben Sie Attributwerte für die neue KVM ein. In der folgenden Tabelle werden die Einstellungen beschrieben.
      Eigenschaftsname Beschreibung
      Name Name der KVM. Darf in der Umgebung nur einmal vorkommen. Verweisen Sie auf diesen Namen in 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 auf der gesamten Karte festgelegt. Sie können die Verschlüsselung von Eintrag nach Eintrag nicht festlegen.
      Hinweis: Sie können KVMs nur verschlüsseln, wenn Sie sie erstellen. Sie können eine Schlüssel/Wert-Zuordnung nicht mehr verschlüsseln oder entschlüsseln, nachdem sie erstellt wurde.
    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 des KMV, um die aktuellen Einträge anzuzeigen.
    2. Klicken Sie auf + (Pluszeichen).
    3. Geben Sie Eigenschaftswerte für den neuen KVM-Eintrag wie unten beschrieben ein.
      Eigenschaftsname Beschreibung
      Schlüssel

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

      Mit Apigee Edge for Public Cloud dürfen Schlüsselnamen nicht größer 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 15 MB nicht überschreiten.
    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 eine der folgenden Aufgaben auszuführen:
      • Klicken Sie auf , um den Wert eines Eintrags zu kopieren.
      • Klicken Sie auf , um einen Eintrag zu bearbeiten. Bearbeiten Sie dann den Eintrag und klicken Sie auf Aktualisieren.
      • Klicken Sie auf , um einen Eintrag zu löschen. Klicken Sie dann zur Bestätigung auf Löschen.

Classic Edge (Private Cloud)

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

  1. Melden Sie sich bei http://ms-ip:9000 an, wobei ms-ip die IP-Adresse oder der DNS-Name des Knotens des Verwaltungsservers 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 Property-Werte für die neue KVM wie unten beschrieben ein.
      Eigenschaftsname Beschreibung
      Name Name der KVM. Darf in der Umgebung nur einmal vorkommen. Verweisen Sie auf diesen Namen in 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 auf der gesamten Karte festgelegt. Sie können die Verschlüsselung von Eintrag nach Eintrag nicht festlegen.
      Hinweis: Sie können KVMs nur verschlüsseln, wenn Sie sie erstellen. Sie können eine Schlüssel/Wert-Zuordnung nicht mehr verschlüsseln oder entschlüsseln, nachdem sie erstellt wurde.
    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 + Entry (+ Eintrag).
    3. Geben Sie Eigenschaftswerte für den neuen KVM-Eintrag wie unten beschrieben ein.
      Eigenschaftsname Beschreibung
      Schlüssel

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

      Hinweis: Bei Edge for Public Cloud dürfen Schlüsselnamen nicht größer 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 15 MB nicht überschreiten.
    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 dann auf Speichern.
      • Wenn Sie einen Eintrag löschen möchten, klicken Sie auf Löschen.