20.04.06 – Versionshinweise zu Apigee Edge for Public Cloud

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen info

An den folgenden Tagen haben wir mit der Veröffentlichung von Komponentenupdates für Apigee Edge for Public Cloud begonnen:

• Message Processor: Freitag, 1. Mai 2020
• API-Verwaltung: Montag, 20. April 2020
• Monetarisierungsmanagement: Montag, 20. April 2020
• Patch-Release für API Management: Montag, 22. Juni 2020
• Patch-Release für die Monetarisierungsverwaltung: Montag, 6. Juli 2020
• Sicherheitsupdate für Management Server: Montag, 24. August 2020
• Patch-Release für den Message Processor mit Fehlerkorrekturen: Donnerstag, 24. September 2020
• Patch-Release für den Message Processor mit Fehlerkorrekturen: Montag, 26. Oktober 2020
• Patch-Release für den Message Processor mit Fehlerkorrekturen: Montag, 1. Februar 2021

Neue Features und Updates

Im Folgenden sind die neuen Features und Aktualisierungen in diesem Release aufgeführt:

JWT-Richtlinien

• JWT-Verschlüsselung

  Mit den JWT-Richtlinien können Sie verschlüsselte Tokens generieren, überprüfen und decodieren. Neue Elemente in Richtlinien:

  • <Type>: Hiermit können Sie festlegen, ob die Tokens signiert oder verschlüsselt werden.
  • <EncryptionAlgorithms>: Hiermit können Sie die Verschlüsselungsalgorithmen <Key> und <Content> festlegen.

  (67165581)

• Unterstützung für PSS-Algorithmen in signierten Tokens

  Die Richtlinien zum Generieren und Überprüfen von JWT und JWS unterstützen jetzt die Algorithmen PS256, PS384 und PS512, wie in IETF RFC 7518 beschrieben. (119856499)

• Relativer Beginn für Token mit GenerateJWT

  Wenn Sie ein JWT mit der GenerateJWT-Richtlinie generieren, können Sie mit dem Element <NotBefore> eine relative Zeit zwischen dem Zeitpunkt, zu dem ein Token generiert wird, und dem Zeitpunkt, zu dem es gültig wird, angeben. Ein <NotBefore>-Wert von 2 Stunden bedeutet beispielsweise, dass ein Token erst 2 Stunden nach der Generierung gültig ist. Sie können <NotBefore> in Millisekunden (ms), Sekunden (s), Minuten (m), Stunden (h), Tagen (d) oder Wochen (w) angeben. (126261970)

• PublicKey/Certificate in VerifyJWT referenzieren

  In der VerifyJWT-Richtlinie können Sie mit dem Element <PublicKey> / <Certificate> auf das PEM-formatierte Zertifikat verweisen, mit dem eingehende JWT-Signaturen überprüft werden sollen. Beispiel:

  <PublicKey>
    <Certificate ref='public.certificate_pem'/>
  </PublicKey>

  (132918033)

Funktionen für Nachrichtenvorlagen

Mit diesem Release sind die folgenden neuen Nachrichtenvorlagenfunktionen verfügbar:

• firstnonull: Gibt den Wert des ersten (ganz links stehenden) Arguments zurück, das nicht NULL ist. (139698514)
• xpath: Mit dieser Funktion können Sie einen XML-Pfad-Ausdruck (XPath) anwenden, um XML-Variablen zu parsen. (123246424)

AssignMessage-Richtlinie: Mit AssignVariable können Sie auf eine Nachrichtenvorlage verweisen

In der AssignMessage-Richtlinie ermöglicht das Element <AssignVariable> / <Template> ein ref-Attribut, mit dem Sie zur Laufzeit eine vordefinierte Vorlage einfügen können, die sich ändern kann, ohne dass die Richtlinie geändert werden muss. (118396082)

Mehrere Zertifikatsaliase

Wenn Sie TLS konfigurieren und mehrere Zertifikate in einem Schlüsselspeicher verwenden, die jeweils einen anderen Alias haben, können Sie in Ihrer <SSLInfo><KeyAlias>-Konfiguration auf bestimmte Zertifikatsaliase verweisen. Um dieses aktualisierte Verhalten zu aktivieren, legen Sie in der Datei „http.properties“ auf Message-Prozessoren das neue Attribut HTTPClient.choose.alias.by.keyalias auf „true“ fest. Edge for Public Cloud-Nutzer müssen sich an den Support wenden, um dieses Attribut hinzuzufügen. (142141620)

JSONtoXML-Richtlinie: XML-Deklaration weglassen, Ausgabe einrücken

Mit zwei neuen booleschen Optionen in der JSONtoXML-Richtlinie haben Sie mehr Kontrolle über die XML-Ausgabe.

• <Options> <OmitXmlDeclaration>: Wenn auf „true“ gesetzt (Standardeinstellung ist „false“), wird im <OmitXmlDeclaration>-Element die von der Richtlinie generierte Standard-XML-Deklaration <?xml version="1.0" encoding="UTF-8"?> weggelassen.

• <Options> <Indent>: Wenn auf „true“ gesetzt (Standard ist „false“), rückt das Element <Indent> die XML-Ausgabe ein. Anstelle dieser Ausgabe:

  <Array><n>1</n><n>2</n><n>3</n></Array>

  Das Einzugselement erzeugt Folgendes:

  <Array>
   <n>1</n>
   <n>2</n>
   <n>3</n>
  </Array>

(65142394)

Antworten für das Scannen virtueller Hosts

Wenn eine Anfrage an die IP-Adresse eines Apigee-Endpunkts gesendet wurde (kein virtueller Host angegeben), gab Edge eine HTTP 200-Antwort und ein leeres HTML-Dokument vom standardmäßigen virtuellen Apigee-Host zurück, der dieser IP-Adresse zugeordnet ist. Um den falschen Eindruck zu vermeiden, dass eine solche Antwort eine potenzielle Sicherheitslücke darstellen könnte, die ausgenutzt werden könnte, wird die Verbindung getrennt und keine Antwort zurückgegeben. (140005396)

Eigenschaften des Zielservers in Trace zur Unterstützung bei der Fehlerbehebung

Die folgenden neuen Trace-Attribute helfen bei der Fehlerbehebung von Problemen mit der Zielverbindung, indem sie zeigen, ob der HTTPClient für den Zielserver im Cache gespeichert wurde: isHttpClientCached und isFromClientPool. (140574604)

MessageLogging-Richtlinie: Syslog-Meldung

In der MessageLogging-Richtlinie können Sie mit dem neuen Element <Syslog> / <PayloadOnly> (boolescher Wert) festlegen, ob dem von Ihnen definierten <Message> automatisch etwas vorangestellt werden soll. Wenn Sie <PayloadOnly> auf „true“ setzen, wird Ihrer Nachrichtendefinition nichts vorangestellt (unabhängig von der Einstellung für <FormatMessage>). Bei Einstellung auf „false“ (Standardwert) wird durch die Einstellung <FormatMessage> festgelegt, was dem Logeintrag vorangestellt wird. (68722102)

Ablauf von Cache-Richtlinien

Ein neues Ablaufdatum-Element <TimeoutInSeconds> in der ResponseCache-Richtlinie und der PopulateCache-Richtlinie verhält sich so, wie das vorhandene <TimeoutInSecs>-Element ursprünglich vorgesehen war. Verwenden Sie das neue Element. Das veraltete <TimeoutInSecs>-Element ist aus Gründen der Abwärtskompatibilität weiterhin vorhanden. Wenn sowohl das Element <TimeoutInSecs> als auch das Element <TimeoutInSeconds> konfiguriert sind, verwendet Edge <TimeoutInSeconds>. (119172893)

Ablaufvariable „virtualhost.aliases.values“

Eine neue schreibgeschützte virtualhost.aliases.values-Nachrichtenflussvariable gibt ein JSON-formatiertes Array aller Aliase zurück, die dem virtuellen Host zugewiesen sind, der in der eingehenden Anfrage aufgerufen wurde. (128453178)

Neuer Parameter zum Löschen von Proxy-Versionen

Der neue Suchparameter force wurde der API-Proxy-Überarbeitung löschen hinzugefügt. In Fällen, in denen die Überarbeitung in der List API Proxies API aufgeführt ist, aber nicht abgefragt werden kann, sorgt dieser Parameter dafür, dass die Proxy-Überarbeitung gelöscht wird. (111691721)

Beispiel:

DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true

Neue Ablaufvariable für Aliaswerte von Virtualhosts

Eine neue schreibgeschützte virtualhost.aliases.values-Nachrichtenflussvariable gibt ein JSON-formatiertes Array aller Aliase zurück, die dem virtuellen Host zugewiesen sind, der in der eingehenden Anfrage aufgerufen wurde. (128453178)

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.