4.19.01.03 – Edge für Private Cloud-Versionshinweise

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

Am 10. März 2020 wurde eine neue Version von Apigee Edge für Private Cloud veröffentlicht.

Aktualisierungsvorgang

Führen Sie die folgenden Schritte für die Edge-Knoten aus, um Ihre Installation zu aktualisieren:

  1. Auf allen Edge-Knoten:

    1. Yum-Repositories bereinigen:
      sudo yum clean all
    2. Laden Sie die aktuelle Edge-Datei 4.19.01 bootstrap_4.19.01.sh in /tmp/bootstrap_4.19.01.sh herunter:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
      .
    3. Installieren Sie das apigee-service-Dienstprogramm und die Abhängigkeiten von Edge 4.19.01:
      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

      Dabei sind uName:pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie den Parameter pWord weglassen, werden Sie aufgefordert, ihn einzugeben.

    4. Aktualisieren Sie das Dienstprogramm apigee-setup:
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. Führen Sie mit dem Befehl source das Skript apigee-service.sh aus:
      source /etc/profile.d/apigee-service.sh
  2. Aktualisieren Sie das Dienstprogramm apigee validate:
    sudo /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  3. Importieren Sie den neuen SmartDocs-Proxy aus dem smartdocs.zip im Verzeichnis /opt/apigee/apigee-validate/bundles und stellen Sie ihn als neue Überarbeitung bereit. Der neue Proxy sollte in die Organisation importiert werden, in der SmartDocs derzeit konfiguriert ist. Die Bereitstellung des Proxys als neue Überarbeitung erleichtert bei Bedarf das Rollback.

    Hinweis: Prüfen Sie vor der Bereitstellung, ob <VirtualHost> im neuen Proxy mit der <VirtualHost>-Konfiguration übereinstimmt, die derzeit in Ihrer Umgebung festgelegt ist. Wenn nicht, bearbeiten Sie den Proxy vor der Bereitstellung.

  4. Erstellen und aktualisieren Sie in der Edge-Benutzeroberfläche eine KVM mit dem Namen „smartdocs_Whitelist“ (siehe Abbildung unten). Die KVM sollte in der Organisation und Umgebung erstellt werden, in der der SmartDocs-Proxy derzeit bereitgestellt ist.

    Hinweis: Das Kästchen für verschlüsselt darf NICHT angeklickt sein.

    • Fügen Sie einen Schlüssel namens „is_Whitelist_configure“ hinzu, wobei der Wert „JA“ ist.
    • Fügen Sie einen zweiten Schlüssel namens „allowed_hosts“ hinzu. Die Werte sind durch Leerzeichen getrennte Hostnamen oder IP-Adressen, die von SmartDocs aufgerufen werden. Der Wert von „allowed_hosts“ sollte alle Hosts enthalten, die in den OpenAPI-Spezifikationen enthalten sind, die SmartDocs hinzugefügt werden. Wenn Sie beispielsweise eine OpenAPI-Spezifikation haben, die mocktarget.apigee.net aufruft, müssen Sie mocktarget.apigee.net zum Wert „allowed_hosts“ hinzufügen. Wenn ein Host nicht in der KVM enthalten ist, lautet die SmartDocs-Antwort 400 Bad Request mit der Inhaltsnutzlast Bad Request-Hostname not permitted
    KVM-Erstellungsoberfläche Hinweis: Wenn Sie diese KVM nicht hinzufügen und konfigurieren, erzwingt der Proxy keine Zulassungsliste. Dies kann zu einem nicht autorisierten Zugriff auf Ihre Hosts und IP-Adressen führen. Nur die Hostnamen und IP-Adressen von mit SmartDocs dokumentierten API-Endpunkten sollten in den Werten für „allowed_hosts“ enthalten sein.

Unterstützte Software

Keine.

Einstellung von Produkten und Funktionen und Ruhestand

Keine.

Fehlerkorrekturen

In der folgenden Tabelle sind die in dieser Version behobenen Fehler aufgeführt:

Fehler-ID Beschreibung
145340106

Sicherheitslücke in der Apigee SmartDocs API

Der Apigee SmartDocs-Proxy wurde zur Behebung von Sicherheitslücken aktualisiert. Weitere Informationen und erforderliche Schritte findest du unter Aktualisierungsvorgang.