4.17.05 - Edge for Private Cloud リリースノート

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細

以前の Edge for Private Cloud の機能リリース以降、次のリリースに 本機能リリースに含まれる機能は次のとおりです。

リリースについて 番号付けを使用して、特定のクラウド リリースが 含まれている必要があります。

リリースの概要

このリリースには、セキュリティ テレメトリーの制御とセキュリティの強化に役立つ注目すべき機能が多数含まれています。 以下を含む API:

• 共有フローは、ゼロ ダウンタイムのデプロイをサポートしています。
• 組織の収益化データの削除がサポートされるようになりました。
• その他の新機能は以下のとおりです。

Vault は非推奨となりました。

このトピックの残りの部分では、すべての新機能、アップデート、バグ修正について詳しく説明します。 含まれています。

非推奨と廃止

このリリースでは、次の機能が非推奨または廃止されました。詳細については、Edge の非推奨ポリシーをご覧ください。

提供終了: 追加中 API プロキシの [Performance] タブのパス

このリリースまでは、管理 UI で API プロキシに移動して [Performance] タブで、別のパスを作成して、プロキシの [Performance] タブと Business Transactions ダッシュボードに表示されます。この機能は廃止され UI で利用できなくなります。この機能の代わりに、次の Apigee を参照してください。 コミュニティ記事: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html （EDGEUI-902）

廃止済み: Developer Services ポータルの buildInfo URL

以前のバージョンのポータルでは、 ブラウザでの URL:

http://yourportal.com/buildInfo

4.17.05 で、このリンクは削除されています。バージョンを確認するには、[レポート > Drupal のステータス レポートのメニュー エントリ。ポータルのバージョンが行のテーブルに表示されます。 プロファイルをインストールという名前にします。

Apigee のサポート終了 セキュアストア（Vault）

Apigee のセキュリティは 「Vault」とも呼ばれています。はサポートを終了し サポート終了のお知らせ日が表示されます 非推奨と 退職ページをご覧ください。Key-Value ペアの暗号化ストレージを提供する Vault が作成されます。 apigee-access の関数を使用して実行時にアクセスします。 Node.js モジュール。

セキュアストアを使用する代わりに、暗号化された Key-Value マップ（KVM）を使用してください。 Key-Value マップの使用 暗号化された KVM は Vault と同じくらい安全であり、作成や管理の選択肢も増えます 使用します。（MGMT-3848）

新機能とアップデート

このリリースにおける新機能と機能強化は次のとおりです。その他の推奨事項 機能強化です。このリリースには、複数のユーザビリティ、パフォーマンス、セキュリティ、安定性 強化できます。

プライベート クラウド

新しい必須 SMTP 構成パラメータをインストールに追加

今後は、SMTPMailFROM パラメータを使用して、 インストールします。このパラメータには、メールアドレスを指定します。 ユーザーがパスワードの再設定を要求したときなど、Edge が自動メールを送信するときに使用されます。詳しくは、 環境に Edge コンポーネントを ノードをご覧ください。

（EDGEUI-1020）

Edge UI が Edge API 管理呼び出しに使用するタイムアウトを設定できるようになりました

Edge UI で使用される API タイムアウト時間を指定して、UI のタイムアウト時間を制御できるようになりました。 API 管理呼び出しが返されるのを待ちます。次のプロパティはタイムアウトを定義します。

• conf_apigee_apigee.feature.apitimeout セット バックエンドへの呼び出しの戻りを UI が待機する時間（秒単位）。 アクティビティを記録します。その時間内に呼び出しが完了しない場合、UI はタイムアウト エラーをスローします。「 デフォルト値は 180 秒（3 分）です。
• conf_apigee_play.ws.timeout.idle は、 サーバー上のアクティビティを UI が待機する時間（ミリ秒単位）。同じ値に設定できます。 conf_apigee_apigee_apitimeout または 選択しますこれより大きい値を設定しても効果はありません。デフォルトは 180,000 です。 ミリ秒（3 分）。
• conf_apigee_play.ws.timeout.connection は、 接続が確立されるまでの UI の待機時間です同じ値に設定できます。 conf_apigee_apigee_apitimeout または 選択しますこれより大きい値を設定しても効果はありません。デフォルトは 120,000 です。 ミリ秒（2 分）。

詳しくは、タイムアウトの設定 Edge UI で使用される Edge API 管理呼び出しをご覧ください。

（EDGEUI-816）

Router に Message Processor の再試行タイムアウトを追加

Router が Message Processor へのリクエストの再試行を停止して エラー メッセージが表示されます。

詳細については、構成 Message Processor への接続を再試行します。

（APIRT-2912）

デフォルトのシステム管理者を変更する手順を追加しました

デフォルトのシステム管理者を変更するためのドキュメントが追加されました。

詳細については、 ユーザー、ロール、権限をご覧ください。

（DOS-4895）

Edge のインストール タスクを root ユーザーと非 root ユーザーの分離に関するドキュメントを追加

新しいドキュメントでは、Edge のインストール タスクを root と 非 root ユーザー。

詳細は、Edge のインストール 概要をご覧ください。

（DOS-4573）

生成されたメール内のリンクのホスト名を設定するプロパティを追加

Edge は、ユーザーがウェブサイトに追加されたときなど、特定のイベントに応答してメールを自動送信します 組織です。このようなメールの多くにはリンクが記載されています。たとえば、スペースに新しいユーザーが追加された場合、 次の形式のログイン URL を含むメールが Edge UI からユーザーに送信されます。

https://domain/login

ドメインは Edge によって自動的に決定され、通常は組織に適切です。 ただし、Edge UI がロードバランサの背後にある場合、自動的に 生成されたドメイン名が正しくありません。その場合は、conf_apigee_apigee.emails.hosturl プロパティを使用して、 明示的に設定します。

詳細については、 生成されたメール内のリンクのホスト名をご覧ください。

（EDGEUI-1044）。

Edge UI に表示される API プロキシのベース URL の設定

Edge UI には、仮想ホストの設定に基づいて API プロキシの URL が表示されます。 対応するプロキシがデプロイされている場所に対応します。このディスプレイには、Cloud Router の Router ポート番号も 作成されます。

ほとんどの場合、Edge UI に表示される URL は、外部 IP アドレスを追加するのに適した URL です。 リクエストをプロキシに送信します。ただし、一部の設定では、表示される URL が正しくありません。 たとえば、次のいずれかの設定を行うと、表示される URL が は、プロキシに対する外部リクエストを行うために使用される実際の URL に対応しています。

• ロードバランサで SSL を終端する
• ロードバランサと Apigee ルーターの間でポート マッピングが行われる
• パスの書き換えが構成されたロードバランサ

Edge for Private Cloud 4.17.05 以降では、 &lt;BaseUrl&gt; で Edge UI に表示される URL をオーバーライドできます。次の例に、Cloud Storage バケットと 新しい &lt;BaseURL&gt; 属性です。この例では、値は「http://myCo.com」です。が Edge UI に表示されます。

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias> 
   </HostAliases> 
   <BaseUrl>http://myCo.com</BaseUrl>     
   <Interfaces/>
   <Port>9005</Port> 
</VirtualHost>

&lt;BaseUrl&gt; が設定されていない場合は、 設定すると、Edge UI に表示されるデフォルトの URL は「http://DNS_name_or_IP:9005/」のようになります。 実際のホスト エイリアスの設定は「http://myCo.com」です。

VHOST_BASEURL プロパティを使用して、組織の作成時にベース URL を設定することもできます。 apigee-provision ユーティリティです

詳細については、TLS の構成 API へのアクセスをご覧ください。

（EDGEUI-5008）。

デバッグ ロギングの有効化に関するドキュメントを追加しました

Edge のデバッグ ロギングを有効または無効にする方法を説明したドキュメントを追加 説明します。

デバッグ ロギングの有効化をご覧ください。 をご覧ください。

（APIRT-4018）

apigee-analytics-collector ユーティリティの新しいインストーラとコマンド構文

Edge for Private Cloud のすべてのお客様は、API に関する統計情報を Apigee に送信する必要があります。 apigee-analytics-collector コマンドラインのベータ版リリースを使用したプロキシ トラフィック ユーティリティですこのユーティリティは、API 呼び出し量レポートを Apigee に返します。

この Edge リリースには、新しいインストール手順とコマンド構文が含まれています。 apigee-analytics-collector ユーティリティですこのリリースでは、apigee-service を使用して apigee-analytics-collector ユーティリティ、 npm ではなく、使用して apigee-analytics-collector ユーティリティを呼び出します。 apigee-service を 使用できます。

アップロード API をご覧ください 「Traffic Data to Apigee - Beta Release」をご覧ください。

Developer Services ポータルの更新後の新しいデフォルトのインストール ディレクトリ Nginx/Postgres 4.17.01 を新たにインストールした場合

Nginx/Postgres を使用する 4.17.01 の新規インストールを更新すると、ルート ディレクトリ 変更前:

/opt/apigee/apigee-drupal

これを、次のように変更します。

/opt/apigee/apigee-drupal/wwwroot

API サービス

エンティティの入力検証の厳格化

より厳格な入力検証が、Apigee Edge 組織のすべてのエンティティに適用されています。 使用できる文字は、通常はアルファベット（すべて大文字）、数字、アンダースコアです。

影響を受けるエンティティは次のとおりです。

• 組織
• 環境
• API プロキシ
• API プロキシ リビジョン
• API プロキシのポリシー名
• デバッグ トレースマスク構成 ID
• リソース名（Java コールアウト、XSL、すべてのリソース）
• キーストア
• CRLstores
• リソース参照
• ターゲット サーバー

（MGMT-3840）

共有フローのゼロ ダウンタイム デプロイ

共有フローをデプロイし、受信トラフィックがほとんどまたはまったく拒否されないようにする場合 ゼロ ダウンタイムのデプロイ管理 API を使用できるようになりました。このプロセスは 管理 API を使用した API プロキシのゼロ ダウンタイムのデプロイとほぼ同じです。唯一の 違いは管理 API リソースです。

次の呼び出しでは、URI で示されている共有フロー リビジョンがデプロイされ、そのリビジョンがデプロイ解除されます。 以前にデプロイされたリビジョン（これは override=true クエリ パラメータで有効になります）:

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

（MGMT-3485）

収益化

組織の収益化データを削除する

次のような状況では、組織の収益化データを削除することをおすすめします。

• 組織を削除する。この場合、事前に収益化データを削除してから、 組織を削除できます。
• 再利用したいテスト組織から収益化データを消去します。この 収益化データを削除した後に Apigee Edge データを同期する必要があります。

詳しくは、収益化データを削除する 必要ありません。（DEVRT-2581）。

組織の収益化を有効にする API を追加

API を使用して組織の収益化を有効にできるようになりました。

有効にする 組織の収益化をご覧ください。

（DEVRT-2383）。

修正済みのバグ

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

プライベート クラウド 4.17.05

Cloud 17.04.12（UI）

Cloud 17.04.05（UI）

Cloud 17.03.29（UI）

Cloud 17.03.15.01（UI）

Cloud 17.03.15（UI）

Cloud 17.03.13.02（収益化）

Cloud 17.03.13.01（収益化）

Cloud 17.03.13（API 管理）

Cloud 17.03.1（UI）

Cloud 17.02.15（UI）

Cloud 17.02.13（API ランタイム）

Cloud 17.02.13（API 管理）

Cloud 17.01.18（UI）

Cloud 17.01.16（API 管理）

Cloud 17.01.16（収益化）