19.01.03 – Versionshinweise zu Edge für Private Cloud

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

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

Aktualisierungsprozedur

Führen Sie die folgenden Schritte auf den Edge-Knoten aus, um die Installation zu aktualisieren:

1. Auf allen Edge-Knoten:

   1. Bereinigen Sie die Yum-Repositories:

      sudo yum clean all

   2. Laden Sie die neueste bootstrap_4.19.01.sh-Datei für Edge 4.19.01 auf /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 Dienstprogramm apigee-service für Edge 4.19.01 und die Abhängigkeiten:

      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 pWord weglassen, werden Sie aufgefordert, ihn einzugeben.

   4. Aktualisieren Sie das apigee-setup-Dienstprogramm:

      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   5. Verwenden Sie den Befehl source, um das Skript apigee-service.sh auszuführen:

      source /etc/profile.d/apigee-service.sh

2. Aktualisieren Sie das apigee validate-Dienstprogramm:

   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 Version vereinfacht bei Bedarf ein Rollback.

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

4. Erstellen und aktualisieren Sie über die Edge-Benutzeroberfläche eine KVM mit dem Namen „smartdocs_whitelist“, wie in der Abbildung unten dargestellt. 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 den Schlüssel „is_whitelist_configured“ mit dem Wert „YES“ hinzu.
   • Fügen Sie einen zweiten Schlüssel namens „allowed_hosts“ hinzu, wobei die Werte durch Leerzeichen getrennte Hostnamen oder IP-Adressen sind, die aus SmartDocs aufgerufen werden. Der Wert „allowed_hosts“ sollte alle Hosts enthalten, die in OpenAPI-Spezifikationen enthalten sind und SmartDocs hinzugefügt wurden. Wenn Sie beispielsweise eine OpenAPI-Spezifikation haben, die mocktarget.apigee.net aufruft, müssen Sie mocktarget.apigee.net dem Wert „allowed_hosts“ hinzufügen. Wenn ein Host nicht in der KVM enthalten ist, ist die SmartDocs-Antwort 400 Bad Request mit einer Inhaltsnutzlast von Bad Request-Hostname not permitted.
   Hinweis: Wenn Sie diese KVM nicht hinzufügen und konfigurieren, erzwingt der Proxy keine Zulassungsliste. Dies kann zu unbefugtem Zugriff auf Ihre Hosts und IP-Adressen führen. Die Werte für „allowed_hosts“ sollten nur Hostnamen und IP-Adressen von API-Endpunkten enthalten, die mit SmartDocs dokumentiert sind.

Unterstützte Software

Keine.

Einstellung und Einstellung

Keine.

Fehlerkorrekturen

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

Problem-ID	Beschreibung
145340106	Sicherheitslücke in der Apigee SmartDocs API Apigee SmartDocs-Proxy wurde aktualisiert, um Sicherheitslücken zu schließen. Weitere Informationen und erforderliche Schritte finden Sie unter Aktualisierungsverfahren.