4.17.09 – Versionshinweise zu Edge für Private Cloud

Sie sehen sich die Dokumentation zu Apigee Edge an.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

Seit dem vorherigen Feature Release von Edge für Private Cloud wurden die folgenden Releases und sind in dieser Funktionsversion enthalten:

Siehe Informationen zum Release Nummerierung, um zu erkennen, ob eine bestimmte Cloud-Version in Ihrer Version von Edge für Private Cloud enthalten.

Versionsübersicht

Die wichtigste neue Funktion in dieser Version ist die zusätzliche Unterstützung Assertion Markup Language (SAML) 2.0 als Authentifizierungsmechanismus für Edge, API BaaS und den Developer Services-Portal. Wenn Sie SAML mit Edge verwenden, können Sie SSO für die Edge-Benutzeroberfläche und ‑API sowie für alle anderen von Ihnen bereitgestellten Dienste unterstützen, die ebenfalls SAML unterstützen.

Die SAML-Authentifizierung bietet mehrere Vorteile. Mit SAML können Sie Folgendes tun:

• Vollständige Kontrolle über die Nutzerverwaltung. Wenn Nutzer Ihre Organisation verlassen und deren Bereitstellung zentral aufgehoben wird, wird ihnen der Zugriff auf Edge automatisch verweigert.
• Legen Sie fest, wie sich Nutzer für den Zugriff auf Edge authentifizieren. Du kannst eine andere Authentifizierung auswählen für verschiedene Edge-Organisationen.
• Authentifizierungsrichtlinien steuern. Ihr SAML-Anbieter unterstützt möglicherweise Authentifizierungsrichtlinien, die den Unternehmensstandards entsprechen.
• Sie können Anmeldungen, Abmeldungen, fehlgeschlagene Anmeldeversuche und hochriskante Aktivitäten auf Ihrer Edge-Bereitstellung.
• SAML wird nur für die Authentifizierung verwendet. Autorisierung wird weiterhin von Edge gesteuert Nutzerrollen.

Siehe Unterstützen von SAML in Edge für Private Cloud.

Diese Version enthält eine Reihe weiterer bemerkenswerter Funktionen, darunter:

• Möglichkeit, das Entwicklerdienstportal von Apache/MySQL zu Postgres/Nginx zu migrieren
• Befehl zum Deaktivieren von TLS in der Edge-Benutzeroberfläche
• Neue Eigenschaften zum Konfigurieren der Edge-Installation
• Benennungsregeln für benutzerdefinierte Consumer-Keys und -Secrets
• Unterstützung für Red Hat/CentOS-Version 7.4

Der Rest dieses Themas enthält Details zu allen neuen Funktionen, Updates und Fehlerbehebungen. die in der Veröffentlichung enthalten sind.

Einstellung und Einstellung

Die folgenden Funktionen wurden in dieser Version eingestellt oder eingestellt. Weitere Informationen finden Sie in der Einstellungsrichtlinie für Edge.

Verworfene Produkte/Funktionen

Einstellung des sicheren Apigee-Speichers (Depots)

Apigee Secure auch „Tresor“ genannt, und wird im April 2018 eingestellt. Tresore, die den verschlüsselten Speicher von Schlüssel/Wert-Paaren ermöglichen, werden mit der Management API erstellt und zur Laufzeit mit Funktionen im Node.js-Modul „apigee-access“ darauf zugegriffen.

Verwenden Sie anstelle des sicheren Speichers verschlüsselte Schlüssel/Wert-Zuordnungen (KVMs), wie unter Mit Schlüssel/Wert-Zuordnungen arbeiten Verschlüsselte KVMs sind genauso sicher wie Vaults und bieten mehr Optionen zum Erstellen und Datenabruf. (MGMT-3848)

Einstellung des Hinzufügens von Pfaden auf dem Tab „Leistung“ des API-Proxys

Bis zu dieser Version konnten Sie in der Verwaltungsoberfläche zu einem API-Proxy wechseln, den Tab „Leistung“ aufrufen und verschiedene Pfade für einen diagrammbasierten Vergleich auf dem Tab „Leistung“ des Proxys und im Dashboard „Geschäftstransaktionen“ erstellen. Diese Funktion wurde eingestellt und ist keine nicht mehr verfügbar sind. Eine Alternative zu dieser Funktionalität finden Sie im folgenden Apigee Community-Artikel: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html (EDGEUI-902)

Neue Features und Updates

Im Folgenden sind die neuen Funktionen und Verbesserungen in diesem Release aufgeführt. Zusätzlich zu den folgenden verbessert haben, bietet diese Version auch zahlreiche Benutzerfreundlichkeit, Leistung, Sicherheit und Stabilität Verbesserungen.

Private Cloud

SAML-Unterstützung für Edge, API BaaS und das Entwicklerportal

Edge unterstützt jetzt SAML 2.0 (Security Assertion Markup Language) als Authentifizierungsmechanismus für Edge, API BaaS und das Entwicklerportal. SAML unterstützt eine SSO-Umgebung (Single Sign-On). Wenn Sie SAML verwenden, können Sie die Einmalanmeldung (SSO) für Edge zusätzlich zu allen anderen Diensten unterstützen die SAML unterstützen.

Siehe Unterstützen von SAML in Edge für Private Cloud.

Hinzugefügtes Dienstprogramm apigee-ssoadminapi.sh

Nachdem Sie SAML aktiviert haben, verwenden Sie jetzt das neue apigee-ssoadminapi.sh, um viele administrative Aufgaben auszuführen, z. B. Nutzer und Organisationen zu erstellen.

Weitere Informationen finden Sie unter apigee-ssoadminapi.sh verwenden.

(DOS-5118)

Das Developer Services-Portal kann jetzt von Apache/MySQL/MariaDB zu Nginx/postgres migriert werden.

Bei einer .tar-basierten Installation des Developer Services-Portals werden Apache und MySQL oder MariaDB verwendet. Sie können jetzt Ihre vorhandene Installation des Portals zur Verwendung von Nginx und Postgres migrieren. Dieses -Migration ist erforderlich, wenn Sie auf die Portalversion 4.17.09 aktualisieren möchten.

Weitere Informationen finden Sie unter TAR-basiertes Portal zu einem RPM-basierten Portal

Unterstützung für Red Hat/CentOS Version 7.4 hinzugefügt

Sie können jetzt Edge für die Private Cloud, API BaaS und das Portal für Entwicklerdienste bereitstellen. unter Red Hat/CentOS Version 7.4.

Weitere Informationen finden Sie unter Unterstützte Software und unterstützte Versionen

Eigenschaft hinzugefügt, die dazu führt, dass das Installationsprogramm die CPU- und Speicheranforderungen während der Installation prüft

Die Edge-Installationskonfigurationsdatei unterstützt jetzt die folgende Eigenschaft:

ENABLE_SYSTEM_CHECK=y 

Wenn „y“ angegeben ist, prüft das Installationsprogramm, ob das System die CPU- und Arbeitsspeicheranforderungen für die zu installierende Komponente erfüllt. Siehe Installationsanforderungen für Anforderungen an die einzelnen Komponenten. Der Standardwert ist „n“, um die Prüfung zu deaktivieren.

Siehe Edge Konfigurationsdateireferenz.

(DOS-4772)

Es wurde eine Eigenschaft hinzugefügt, mit der Sie die IP-Adresse auswählen können, die vom Installateur auf einem Server mit mehreren Schnittstellenkarten verwendet wird.

Wenn ein Server mehrere Schnittstellenkarten hat, gibt der „hostname -i“ gibt den Befehl eine Liste der IP-Adressen. Standardmäßig verwendet das Edge-Installationsprogramm die erste zurückgegebene IP-Adresse, die ist möglicherweise nicht in allen Situationen korrekt. Alternativ können Sie die folgende Eigenschaft in der Installationskonfigurationsdatei festlegen:

ENABLE_DYNAMIC_HOSTIP=y

Wenn dieses Attribut auf „y“ festgelegt ist, werden Sie vom Installationsprogramm aufgefordert, die IP-Adresse auszuwählen, die als ein Teil der Installation ist. Der Standardwert ist „n“.

Siehe Edge Konfigurationsdateireferenz.

(DOS-5117)

Neue UI-Optionen und APIs zur TLS-Konfiguration

Die Betaversion der neuen Self-Service-TLS/SSL-Funktion für die Cloud ist jetzt in der Private Cloud als Betafeature. Mit dieser Betaversion haben Sie folgende Möglichkeiten:

• Erstellen, Ändern und Löschen von Schlüsselspeichern und Truststores in der Benutzeroberfläche sowie in der API
• TLS-Zertifikate als PKCS12/PFX hochladen
• Selbst signierte Zertifikate über die Benutzeroberfläche oder API generieren
• Gültigkeit eines Schlüsselspeichers oder Truststores in der Benutzeroberfläche testen

Die Beta-Dokumentation (PDF) zu diesen Funktionen finden Sie unter:

• Verwenden der Edge Cloud-UI zum Erstellen von Schlüsselspeichern und Truststores
• Verwenden der Edge API zum Erstellen von Schlüsselspeichern und Truststores

Ausführliche Informationen finden Sie in der zusätzlichen Dokumentation (PDF):

• Optionen für die TLS-Konfiguration
• TLS-Zugriff auf eine API für die Cloud konfigurieren
• TLS vom Edge zum Backend konfigurieren
• TLS-Zertifikat für die Cloud aktualisieren

(EDGEUI-1058)

Befehl für verschleiertes Passwort hinzugefügt

Es wurde ein Befehl zum Generieren eines verschleierten Passworts hinzugefügt, damit jede Komponente ein verschlüsseltes Passwort generieren kann. Passwort. Sie können ein verschleiertes Passwort mit dem folgenden Befehl in Edge generieren. Verwaltungsserver:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

Geben Sie das neue Passwort ein und bestätigen Sie es auf Aufforderung. Aus Sicherheitsgründen wird der Text des Passworts nicht angezeigt. Dieser Befehl gibt das Passwort in folgendem Format zurück:

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

Weitere Informationen finden Sie unter TLS/SSL für Edge On Premises konfigurieren.

(TBD–250)

Neuer Befehl zum Unkenntlichmachen des neuen Passworts beim Ändern des Passworts eines Nutzers in einer Organisation

Um das Passwort eines Organisationsnutzers zurückzusetzen, verwenden Sie jetzt das Dienstprogramm apigee-service, um apigee-openldap aufzurufen:

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

Sie werden aufgefordert, das Passwort des Systemadministrators und dann das neue Nutzerpasswort einzugeben. Für aus Sicherheitsgründen wird der Text der Passwörter bei der Eingabe nicht angezeigt.

Weitere Informationen finden Sie unter Edge zurücksetzen Passwörter:

(DBS-1733)

Befehl zum Deaktivieren von TLS in der Edge-Benutzeroberfläche hinzufügen

Sie können jetzt den folgenden Befehl verwenden, um TLS in der Edge-Benutzeroberfläche zu deaktivieren:

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

Weitere Informationen finden Sie unter TLS für die Verwaltungsoberfläche konfigurieren.

(EDGEUI-1114)

Property zum Steuern des Zeitstempelformats in Protokollmeldungen hinzugefügt

Standardmäßig hat der Zeitstempel in Logeinträgen, die von der Richtlinie für das Nachrichten-Logging erstellt wurden, den Wert Format:

yyyy-MM-dd'T'HH:mm:ss.sssZ

Beispiel:

2017-05-08T13:33:00.000+0000

Sie können das Format mit der Eigenschaft conf_system_apigee.syslogger.dateFormat im Edge-Nachrichten-Prozessor steuern.

Siehe Richtlinie für Nachrichten-Logging.

(APIRT-4196)

Neuer erforderlicher SMTP-Konfigurationsparameter zur API-BaaS-Installation hinzugefügt

Sie müssen jetzt den Parameter SMTPMAILFROM in der API BaaS-Installationskonfigurationsdatei verwenden. Dieser Parameter gibt die E-Mail-Adresse an, die beim API BaaS verwendet wird sendet automatisierte E-Mails, z. B. wenn ein Nutzer das Zurücksetzen eines Passworts anfordert.

Weitere Informationen finden Sie in der Referenz für BaaS-Konfigurationsdateien.

(APIBAAS-2103)

Unterstützung hinzugefügt, um dem Edge-Router und dem Nginx-Webserver des Portals den Zugriff auf Ports unter 1.000 zu ermöglichen

Sie können jetzt den Router und den Nginx-Webserver für das Portal verwenden, um auf Ports unter 1.000 zuzugreifen. ohne sie als ein anderer Nutzer ausführen zu müssen. in früheren Versionen der Router und Nginx Der Server konnte nicht auf Ports unter 1000 zugreifen, ohne sie als spezieller Nutzer auszuführen.

Änderung der Konfiguration der Protokollierungsebene für die Edge-Benutzeroberfläche

Die Eigenschaften, mit denen die Protokollierungsebene für die Edge-Benutzeroberfläche konfiguriert wird, haben sich geändert. Informationen zu den neuen Eigenschaften und zum Verfahren finden Sie unter Protokollebene für eine Edge-Komponente festlegen.

(EDGEUI-886)

API-Dienste

Benennungsregeln für benutzerdefinierte Consumer-Keys und -Secrets

Benennungsregeln und Validierung wurden für aktualisiert Erstellen eines benutzerdefinierten Consumer-Keys und -Secrets für eine Entwickler-App Consumer-Schlüssel und -Secrets Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten. Andere Sonderzeichen sind nicht zulässig.

Der Prozess zur Erstellung eines benutzerdefinierten Schlüssels/Secrets ist unter Vorhandene Nutzer importieren Schlüssel und Secrets. (MGMT-3916)

Validierung des Namens des Schlüsselspeichers und des Zielservers

Die Namen von Schlüsselspeichern und Zielservern dürfen maximal 255 Zeichen lang sein und Buchstaben, Zahlen, Leerzeichen, Bindestriche, Unterstriche und Punkte enthalten. In Edge wird dies jetzt beim Erstellen geprüft. (MGMT-4098)

Fehlerkorrekturen

Folgende Fehler wurden in diesem Release behoben. Diese Liste ist hauptsächlich für Nutzer gedacht, die prüfen möchten, ob ihre Support-Tickets erfolgreich bearbeitet wurden. Sie enthält keine detaillierten Informationen für allgemeine Nutzer.

Private Cloud 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16 (Benutzeroberfläche)

Cloud 17.08.14 (API-Verwaltung und Laufzeit)

Cloud 17.07.31 (API-Verwaltung)

Cloud 17.07.17 (API-Verwaltung und Laufzeit)

Cloud 17.06.20 (UI)

Cloud 17.06.14 (Benutzeroberfläche)

Cloud 17.05.22.01 (Monetarisierung)

Cloud 17.05.22 (Benutzeroberfläche)

Cloud 17.05.22 (API-Verwaltung)

Cloud 17.05.08 (Benutzeroberfläche)

Cloud 17.04.22 (API-Verwaltung)

Bekannte Probleme

Diese Version weist die folgenden bekannten Probleme auf: