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

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an.
info

In diesem Thema erfahren Sie, wie Sie Schlüssel/Wert-Paar-Zuordnungen (Key Value Maps, KVMs) in der Benutzeroberfläche erstellen und bearbeiten. Die KVMs, die Sie in der Benutzeroberfläche erstellen, sind auf die Umgebung beschränkt. Weitere Informationen zu KVMs und Umfang 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. Die Unterstützung 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 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 „wahr“:
    conf_apigee_apigee.feature.kvmencryption=true
  3. Speichern Sie die Änderungen.
  4. Ändern Sie den Inhaber von ui.properties in „apigee“:
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Edge-Benutzeroberfläche neu starten:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

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

Verwalten Sie Ihre KVMs wie unten beschrieben. KVMs werden auf Umgebungsebene 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 über die 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-Paarzuordnungen 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.
      Property-Name Beschreibung
      Name Name des 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 gilt für die gesamte Karte. Die Verschlüsselung kann nicht für jeden Eintrag einzeln festgelegt werden.
      Hinweis:Sie können KVMs nur dann verschlüsseln, wenn Sie sie erstellen. Eine Schlüssel/Wert-Zuordnung kann nach dem Erstellen nicht mehr verschlüsselt oder entschlüsselt werden.
    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 KMV, um die aktuellen Einträge aufzurufen.
    2. Klicken Sie auf + (Pluszeichen).
    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.

      Bei 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 aufzurufen.
    2. Bewegen Sie den Mauszeiger auf den KVM-Eintrag, um das Aktionsmenü aufzurufen, und führen Sie eine der folgenden Aktionen aus:
      • Klicken Sie auf , um den Wert eines Eintrags zu kopieren.
      • 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.

Klassisches Edge (Private Cloud)

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

  1. Melden Sie sich bei 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-Paarzuordnungen 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 des 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 gilt für die gesamte Karte. Die Verschlüsselung kann nicht für jeden Eintrag einzeln festgelegt werden.
      Hinweis:Sie können KVMs nur dann verschlüsseln, wenn Sie sie erstellen. Eine Schlüssel/Wert-Zuordnung kann nach dem Erstellen nicht mehr verschlüsselt oder entschlüsselt werden.
    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: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 auf Speichern.
      • Wenn Sie einen Eintrag löschen möchten, klicken Sie auf Löschen.