20.04.06 - Apigee Edge for Public Cloud リリースノート

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動します。 情報

次の日付で、Apigee Edge for Public Cloud のコンポーネントの更新のリリースを開始しました。

• Message Processor: 2020 年 5 月 1 日（金）
• API 管理: 2020 年 4 月 20 日（月）
• 収益化の管理: 2020 年 4 月 20 日（月）
• API Management パッチ リリース: 2020 年 6 月 22 日（月）
• 収益化管理のパッチ リリース: 2020 年 7 月 6 日（月）
• Management Server のセキュリティ アップデート: 2020 年 8 月 24 日（月）
• バグ修正を含む Message Processor パッチ リリース: 2020 年 9 月 24 日（木）
• バグ修正を含む Message Processor のパッチ リリース: 2020 年 10 月 26 日（月）
• バグ修正を含む Message Processor パッチ リリース: 2021 年 2 月 1 日（月）

新機能とアップデート

このリリースにおける新機能とアップデートは次のとおりです。

JWT ポリシー

• JWT 暗号化

  JWT ポリシーを使用すると、暗号化されたトークンを生成、検証、デコードできます。ポリシーの新しい要素は次のとおりです。

  • <Type> - トークンに署名するか暗号化するかを設定できます。
  • <EncryptionAlgorithms> - <Key> と <Content> の暗号化アルゴリズムを設定できます。

  （67165581）

• 署名付きトークンでの PSS アルゴリズムのサポート

  JWT と JWS の生成と検証のポリシーで、IETF RFC 7518 で説明されている PS256、PS384、PS512 アルゴリズムがサポートされるようになりました。（119856499）

• トークンの GenerateJWT 相対開始時間

  GenerateJWT ポリシーで JWT を生成する場合、<NotBefore> 要素を使用すると、トークンが生成されてから有効になるまでの相対時間を指定できます。たとえば、<NotBefore> 値が 2h の場合、トークンは生成されてから 2 時間後まで有効になりません。<NotBefore> の時間は、ミリ秒（ms）、秒（s）、分（m）、時間（h）、日（d）、週（w）で設定できます。（126261970）

• VerifyJWT で PublicKey/Certificate を参照する

  VerifyJWT ポリシーでは、<PublicKey> / <Certificate> 要素を使用して、受信 JWT 署名の検証に使用する PEM 形式の証明書を参照できます。次に例を示します。

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

  （132918033）。

メッセージ テンプレート関数

このリリースで利用できる新しい メッセージ テンプレート関数は次のとおりです。

• firstnonull - 最初の（左端の）NULL 以外の引数の値を返します。（139698514）。
• xpath - XML Path（XPath）式を適用して XML 変数を解析できます。（123246424）

AssignMessage ポリシー: AssignVariable でメッセージ テンプレートを参照できる

AssignMessage ポリシーでは、<AssignVariable> / <Template> 要素で ref 属性を使用できます。これにより、ポリシーを変更せずに変更できる、事前定義されたテンプレートを実行時に挿入できます。（118396082）。

複数の証明書のエイリアス

TLS を構成し、キーストアで複数の証明書（それぞれ異なるエイリアスを持つ）を使用する場合、Edge では <SSLInfo><KeyAlias> 構成で特定の証明書エイリアスを参照できます。この更新された動作を有効にするには、Message Processor の http.properties ファイルで新しい HTTPClient.choose.alias.by.keyalias プロパティを true に設定します。Edge for Public Cloud のユーザーがこのプロパティを追加するには、 サポートに問い合わせる必要があります。（142141620）

JSONtoXML ポリシー: XML 宣言を省略し、出力をインデントする

JSONtoXML ポリシーに 2 つの新しいブール値オプションが追加され、XML 出力をより詳細に制御できるようになりました。

• <Options> <OmitXmlDeclaration> - true に設定すると（デフォルトは false）、<OmitXmlDeclaration> 要素は、ポリシーによって生成されたデフォルトの <?xml version="1.0" encoding="UTF-8"?> XML 宣言を省略します。

• <Options> <Indent> - true に設定すると（デフォルトは false）、<Indent> 要素は XML 出力をインデントします。たとえば、次のような出力ではなく、

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

  Indent 要素は次のように出力します。

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

（65142394）

仮想ホスト スキャンに対するレスポンス

Apigee エンドポイントの IP アドレスにリクエストが送信された場合（仮想ホストが指定されていない場合）、Edge は HTTP 200 レスポンスと、その IP アドレスに関連付けられたデフォルトの Apigee 仮想ホストから空白の HTML ドキュメントを返しました。このようなレスポンスが、悪用される可能性のある脆弱性を表しているという誤った印象を与えないように、接続は切断され、レスポンスは返されません。（140005396）

トラブルシューティングに役立つ Trace のターゲット サーバーのプロパティ

次の新しいトレース プロパティは、ターゲット サーバーの HTTPClient がキャッシュに保存されているかどうかを示すことで、ターゲット接続の問題のトラブルシューティングに役立ちます。isHttpClientCached と isFromClientPool。（140574604）。

MessageLogging ポリシー: Syslog メッセージ

MessageLogging ポリシーで、新しい <Syslog> / <PayloadOnly> 要素（ブール値）を使用すると、定義した <Message> に自動的にプレフィックスが付加されるかどうかを判断できます。<PayloadOnly> を true に設定すると、<FormatMessage> の設定に関係なく、メッセージ定義に何も付加されません。false（デフォルト）に設定すると、<FormatMessage> 設定によってログメッセージに付加される内容が決まります。（68722102）

キャッシュ ポリシーの有効期限

ResponseCache ポリシーと PopulateCache ポリシーの新しい <TimeoutInSeconds> 有効期限要素は、既存の <TimeoutInSecs> 要素が本来意図していたとおりに動作します。新しい要素を使用してください。非推奨の <TimeoutInSecs> 要素は、下位互換性のために引き続き存在します。<TimeoutInSecs> 要素と <TimeoutInSeconds> 要素の両方が構成されている場合、Edge は <TimeoutInSeconds> を使用します。（119172893）。

virtualhost.aliases.values フロー変数

新しい読み取り専用の virtualhost.aliases.values メッセージ フロー変数により、インバウンド リクエストで呼び出された仮想ホストに割り当てられたすべてのエイリアスの JSON 形式の配列が返されます。（128453178）。

プロキシ リビジョンの削除を確実に行うための新しいパラメータ

API プロキシ リビジョンの削除に新しい force クエリ パラメータが追加されました。リビジョンが List API Proxies API にリストされているが、実際にはクエリできない場合、このパラメータにより、プロキシ リビジョンが削除されます。（111691721）

次に例を示します。

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

仮想ホスト エイリアス値の新しいフロー変数

新しい読み取り専用の virtualhost.aliases.values メッセージ フロー変数により、インバウンド リクエストで呼び出された仮想ホストに割り当てられたすべてのエイリアスの JSON 形式の配列が返されます。（128453178）

修正済みのバグ

このリリースでは以下のバグが修正されています。このリストは、サポート チケットの修正状況を確認するユーザーを対象としています。すべてのユーザーに詳細情報を提供することを目的としたものではありません。