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

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。 info

2016 年 3 月 24 日（木）、Apigee Edge for Private Cloud の新バージョンをリリースしました。

前回の Edge for Private Cloud 四半期リリース（4.15.07.00）以降、次のリリースが行われ、この機能リリースに含まれています。

• Cloud: 15.07.08、15.07.22、15.08.05、Nginx 移行、15.09.02、15.09.30、16.01.20
• Private Cloud: 4.15.07.01、4.15.07.03

特定のクラウド リリースが Edge for Private Cloud のバージョンに含まれているかどうかを確認する方法については、リリース番号についてをご覧ください。

サポートの終了

Private Cloud 4.15.07.03

curl http:// <qpid_IP>:8083/v1/servers/self/queues

分析: 複数のレポートのカスタム レポート ダッシュボード ビュー（Cloud 15.09.30）

最大 4 つのカスタム レポートのビューを提供する特定のカスタム レポート ダッシュボード機能は、非推奨となり、今後のリリースで削除される予定です。（MGMT-2673）。カスタム レポートのその他の機能は引き続きご利用いただけます。

プライベート クラウドで組織名の長さをオーバーライドできない

次の設定を行っても、組織名の長さが 20 文字を超えることはなくなりました。

• APIGEE_ORG_NAME_LENGTH=25

• APIGEE_ENV_NAME_LENGTH=25

新機能と拡張機能

このリリースにおける新機能と改善点は次のとおりです。このリリースには、次の機能強化に加えて、ユーザビリティ、パフォーマンス、セキュリティ、安定性の強化も含まれています。

プライベート クラウド

RedHat、CentOS、Oracle 6.7 ～ 7.2 のサポートを追加

このリリースでは、RedHat Enterprise Linux、CentOS、Oracle Linux のバージョン 6.7 ～ 7.2 のサポートが追加されました。

システム要件の一覧については、サポートされているソフトウェアとそのバージョンをご覧ください。

RPM ベースのインストール

このリリースの Edge では、RPM ベースのインストール メカニズムが使用されており、インストールと移行の手順が大幅に簡素化されています。

新しいベース ディレクトリ

Edge 4.16.01 のディレクトリ構造が変更されました。以前のリリースの Edge では、Edge をベース ディレクトリにインストールしました。

/<install-dir>/apigee4

install-dir は任意の場所に配置できます。デフォルトは /opt です。次に例を示します。

/opt/apigee4

バージョン 4.16.01 の場合は、Edge を次のディレクトリにインストールする必要があります。

/opt/apigee

apigee4 ディレクトリが apigee に変更されていることにも注意してください。

データ ディレクトリの場所は影響を受けません。/opt/apigee の下にある場合もあれば、別の場所にある場合もあります。

新しい仮想ホストの要件

Edge 移行スクリプトは、既存の Netty ルーターを Nginx に移行するために必要なタスクのほとんどを処理します。ただし、アップグレードの一環として、移行前にすべての仮想ホスト定義にホスト エイリアスが含まれていることを確認する必要があります。

既存の仮想ホストにホスト エイリアスを追加する方法については、Apigee の ftp サイト ftp://ftp.apigee.com/ で入手できる、Edge のインストール ガイド をご覧ください。

構成を含むコード

Edge バージョン 4.16.01 では、/<install-dir>/apigee4/conf ディレクトリの .properties ファイルを使用して Edge コンポーネントを構成することはなくなりました。4.16.01 以降では、.properties ファイルを使用して Edge コンポーネントを構成しますが、これらのファイルは次のディレクトリにあります。

/opt/apigee/customer/application

ノードにインストールされている Edge コンポーネントごとに、このディレクトリに .properties ファイルがあります。コンポーネントを構成するには、対応する .properties ファイルを編集して、既存のプロパティの値を変更するか、新しいプロパティと値を追加します。ファイルが存在しない場合は、作成できます。

以前のバージョンの Edge とは異なり、Edge 4.16.01 の .properties ファイルには、コンポーネントのすべてのプロパティが含まれていません。このリリースの変更点の 1 つは、.properties ファイルにデフォルトのプロパティ値のオーバーライドのみが含まれることです。

このアーキテクチャの利点は、Edge の新しいバージョンに移行しても、Edge インストーラが /opt/apigee/customer/application のファイルを上書きしないことです。これにより、Edge が誤って設定を上書きする可能性がなくなります。

移行時に、Edge インストーラは既存の .properties ファイルを調べ、デフォルトのプロパティ値に対する変更を /opt/apigee/token ディレクトリにコピーします。したがって、移行後に編集する必要はありません。

詳しくは、Apigee の ftp サイト ftp://ftp.apigee.com/ で入手できる、Apigee Edge の運用ガイドをご覧ください。

Edge 構成スクリプトが置き換えられました

以前の Edge リリースで使用した構成スクリプトは削除され、次のいずれかに置き換えられました。

• apigee-service、apigee-all、apigee-setup、apiee-provision、apigee-migrate などの Apigee ユーティリティを使用して実行するコマンド。
  たとえば、all-start.sh スクリプトと all-stop.sh スクリプトは、次のコマンドに置き換えられました。
  > /opt/apigee/apigee-service/bin/apigee-all start
  > /opt/apigee/apigee-service/bin/apigee-all stop
• Edge コンポーネントで直接実行するコマンド。たとえば、以前のリリースでは、OpenLDAP パスワードの変更に使用される chpasswd-openldap.sh スクリプトを使用していました。このスクリプトは、apigee-openldap コンポーネントで実行する次のコマンドに置き換えられました。
  > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

コマンドを使用して構成を行う方法については、Apigee の ftp サイト ftp://ftp.apigee.com/ で入手できる、Apigee Edge の運用ガイドをご覧ください。

新しいエッジルーター

このリリースの Edge for Private Cloud には、Nginx Router に基づく新しいルーター アーキテクチャが含まれています。Nginx Router は、4.16.01 より前の Edge リリースで使用されていた Netty Router に代わるものです。

Nginx Router のハードウェアとポートの要件は Netty Router と同じであるため、既存のノードを変更する必要はありません。

詳細については、Apigee の ftp サイト ftp://ftp.apigee.com/ で入手できる、Edge のインストール ガイド の付録 A: Nginx Router についてをご覧ください。

BaaS ロードバランサが削除されました

内部ロードバランサが API BaaS ポータルから削除されました。API BaaS Portal と 3 つの API BaaS Stack ノードの間で独自のロードバランサを使用する必要があります。

ロードバランサの代替として、ラウンドロビン DNS を使用できます。このシナリオでは、BaaS スタックの IP アドレスに対応する複数の A レコードを含む DNS エントリを作成します。DNS ルックアップ中に、DNS サーバーは A レコードの値をラウンドロビン方式で自動的に返します。

Cassandra ノードと ZooKeeper ノードを追加する方法、およびデータセンターを既存のデータセンターに追加する方法について説明する新しいドキュメント

Apigee ftp サイトのドキュメント ZIP ファイルに、Cassandra ノードと ZooKeeper ノードを追加する方法と、既存のデータセンターにデータセンターを追加する方法を説明する「Scaling Edge for Private Cloud」が含まれるようになりました。

Orgtool が削除されました

orgtool は、Edge インストールをクエリして、組織に関する情報を取得できます。このツールは現在削除されています。Edge UI または API 呼び出しを使用して、組織に関する情報を取得します。

4.16.01 でタスクを実行する方法

次の表に、4.15.07.03 でタスクを実行する方法と、4.16.01 でタスクを実行する方法を示します。詳しくは、Apigee の ftp サイト ftp://ftp.apigee.com/ で入手できる、Edge の運用ガイドをご覧ください。

モニタリング ツールとダッシュボードのアルファ版リリース

このリリースには、Edge 向けの新しいモニタリング ツールとダッシュボードのアルファ版が含まれています。このツールを使用すると、デプロイ内のさまざまな組織や環境のさまざまなコンポーネント（ルーター、Message Processor、ZooKeeper、Cassandra）の健全性と HTTP エラーコードを把握できます。ダッシュボード データのスナップショットを作成して Apigee と共有し、サポート インシデントの解決に役立てることもできます。

インストール手順などのドキュメントは、Apigee の ftp サイト（ftp://ftp.apigee.com/）で入手できる Edge 4.16.01 ドキュメントの ZIP ファイルに含まれています。

ただし、ダッシュボードをインストールして使用する前に、ドキュメントの ZIP ファイルに含まれている Apigee 評価版利用契約に必要事項を記入し、Apigee にメールで送付する必要があります。送付先は orders@apigee.com です。

エッジ プラットフォーム

管理 UI のスタイル変更（Cloud 15.09.30）

管理 UI の複数のページのデザインが更新されました。（MGMT-2627）

API サービス

API プロキシ ウィザードを再設計（Cloud 16.01.20）

API プロキシ ウィザードのデザインが新しくなりました。管理 UI の [API Proxies] ページで [+ API Proxy] をクリックすると、新しいウィザードが API プロキシの作成プロセスをガイドします。以前の API プロキシ ウィザードと同じ設定がすべて使用できます。（MGMT-1376）

OpenAPI（Swagger）ドキュメントを使用して API プロキシを作成する（Cloud 16.01.20）

新しい API プロキシ ウィザードの再設計の一環として、OpenAPI（Swagger）ドキュメントから API プロキシを作成できるようになりました。API プロキシ ウィザードの最初のページで、[Reverse Proxy]、[Node.js App]、または [No Target] を選択したときに、[Use OpenAPI] をクリックします。表示されたフィールドに、OpenAPI ドキュメントの URL を入力します。詳細については、シンプルな API プロキシの構築をご覧ください。（MGMT-1376）

SOAP プロキシの WSDL 1.2 サポート（Cloud 16.01.20）

Apigee Edge は、SOAP サービスを呼び出す API プロキシの作成で WSDL 1.2 をサポートしています。（MGMT-2835）

TargetEndpoint 構成の SSLInfo 変数（Cloud 16.01.20）

API プロキシの TargetEndpoint で、SSL/TLS の詳細を動的に設定して、ランタイム要件を柔軟にサポートできます。次の例は、TargetEndpoint 構成で SSLInfo を設定する方法を示しています。Java Callout、JavaScript ポリシー、Assign Message ポリシーなどを使用して、実行時に値を指定できます。設定する値を含むメッセージ変数を使用します。

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

この機能については、次のドキュメントで説明しています。

• API プロキシ構成のリファレンス
• 変数リファレンスを使用した TargetEndpoint の動的 SSLInfo

（APIRT-1475）

SAML アサーション ポリシーの RSA_SHA256 アルゴリズムのサポート（Cloud 16.01.20）

SAML アサーション ポリシーで、RSA_SHA1 に加えて RSA_SHA256 アルゴリズムがサポートされるようになりました。（APIRT-1779）

証明書のアップロード時の検証（Cloud 16.01.20）

期限切れまたは無効な証明書がキーストアとトラストストアにアップロードされるのを防ぐため、管理 API はアップロード時に証明書を検証します。証明書は、ファイルのサイズが 50 KB を超えていないこと、形式が PEM または DER であることを確認するために検証されます。証明書の有効期限も検証されます。デフォルトの有効期限検証をオーバーライドする（アップロード時に証明書の有効期限を検証しない）には、次のクエリ パラメータを使用します。?ignoreExpiryValidation=true

詳細については、 キーストアに JAR ファイルをアップロードすると トラストストアに証明書をアップロードするをご覧ください。（SECENG-516）および（APIRT-2213）

Node.js ログページの自動ポーリング（Cloud 16.01.20）

プロキシ エディタから Node.js ログを表示すると、Node.js ログページが定期的に自動更新され、使用可能な新しいログが一覧表示されます。[自動更新を停止] をクリックして、自動更新をオフにします。（MGMT-1692）

X-Forwarded-For HTTP ヘッダー（Cloud 15.09.30）

セキュリティを強化するため、Edge はデフォルトで、1 つ以上の IP アドレスが含まれる可能性がある X-Forwarded-For HTTP リクエスト ヘッダーを削除します。新しいデフォルトの動作では、Edge が受信するクライアント IP アドレスは、アクセス制御ポリシーをバイパスするためにスプーフィングされる可能性のあるアドレスではなく、最後の外部 TCP handshake で受信した IP アドレスになります。

このデフォルトの動作を変更して、X-Forwarded-For アドレスが API プロキシに到達できるようにするには、組織で feature.enableMultipleXForwardCheckForACL=true プロパティを設定する必要があります。

ポリシー プロパティへの JavaScript アクセス（Cloud 15.07.08）

API プロキシフローで JavaScript を使用する場合、JavaScript ポリシーで定義されたプロパティにアクセスできます。これは、JavaScript コードでよく知られている変数を使用する場合に特に便利です。たとえば、JavaScript ポリシーに次のプロパティ定義が含まれているとします。

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

JavaScript では、次のように 'source' プロパティへの参照を使用してメッセージ レスポンスにアクセスできます。
var source = properties.get('source'); // returns: response.content
または
var source = properties.source
または
var source = properties['source']

詳細については、JavaScript ポリシーをご覧ください。（APIRT-1460）

組織レベルの監査（Cloud 15.07.08）

組織管理者は、組織レベルで実行されたアクションの履歴を監査できます。管理 UI で、[Admin] > [Organization History] を選択します。詳細については、監査: API、プロダクト、組織の履歴をご覧ください。（MGMT-2232）

組織管理者がロールから自分自身を削除する（Cloud 15.07.08）

組織管理者は、管理 UI で [管理] > [組織ユーザー] に移動し、自分の名前の横にある [削除] をクリックすることで、組織管理者ロールから自分自身を削除できます。（MGMT-934）

API プロキシ バンドルのインポートの進行状況インジケータ（Cloud 15.07.08）

管理 UI で大きな API プロキシ バンドルをアップロードすると、インポートがまだ進行中であることを示す「動作中」のアニメーションが表示されます。これにより、インポートが完了するまで管理 UI を操作できなくなります。（MGMT-1285）

キャッシュの動作と構成（Cloud 15.07.22）

インメモリ キャッシュの管理と使用率を向上させるため、Edge クラウド リリース 15.06.10 以降、環境キャッシュ リソースの「Maximum Elements in Memory」設定は非推奨になりました。Edge Cloud リリース 15.07.22 では、この設定は Apigee Edge 管理 UI の環境構成部分にある [キャッシュの作成] UI から削除されました。

すべてのキャッシュ リソース（デフォルトのキャッシュを含む）に存在する要素の合計数は、キャッシュに割り当てられた合計メモリによって異なります。デフォルトでは、特定の Message Processor のインメモリ キャッシュに割り当てられる合計メモリは、使用可能な合計メモリの 40% です。要素は、キャッシュ メモリが不足している場合、または要素の有効期限が切れた場合にのみ、メモリ内キャッシュから削除されます。（MGMT-2413、APIRT-1140）

管理 UI のターゲット サーバー構成（Cloud 15.07.22）

管理 UI の [APIs] > [Environment Configuration] ページで、ターゲット サーバーの追加、編集、削除ができるようになりました。

また、新しいページに移動するのではなく、キャッシュをインラインで作成、追加、削除できるように、ページが再設計されました。「Maximum Elements in Memory」などのいくつかのキャッシュ プロパティは、UI で使用できなくなりました。これらのプロパティを設定しても、ランタイム キャッシュの動作に影響しなくなったためです。（MGMT-280）

syslog へのメッセージ ロギングを使用した SSL（Cloud 15.07.22）

メッセージ ロギング ポリシーは、SSL/TLS 経由でサードパーティのログ管理プロバイダに Syslog を送信することをサポートしています。ポリシー構成で、親要素の直接の子として次を使用します。

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

詳細については、メッセージ ロギング ポリシーをご覧ください。（APIRT-942）

管理 UI（Cloud 15.07.22）

Apigee エンジニアリングは、管理 UI でさまざまな細かいバグを修正し、ユーザビリティを強化しました。

Trace の cURL（Cloud 15.09.02）

ターゲット サーバーにリクエストを行う API プロキシ呼び出しをトレースするときに、ターゲット サーバーへのリクエストを cURL コマンドとして表示できます。[Transaction Map] の図で [Request sent to target server] ステージを選択し、[Phase Details] ペインの [Request sent to target server] 列の [Show Curl] ボタンをクリックします。（MGMT-2589）

データ マスキングの特殊文字（Cloud 15.09.02）

データ マスキングを使用して JSON ペイロードの機密データをマスクする場合、$, *, { などの特殊文字をマスクできるようになりました。（APIRT-1727）

管理 UI の Key-Value マップ（Cloud 15.09.30）

Edge 管理 UI で、環境スコープの Key-Value マップ（KVM）を作成して管理できるようになりました。環境スコープの KVM には、テスト環境や本番環境などの環境内のすべての API プロキシからアクセスできる Key-Value ペアが含まれています。管理 UI のメニューで、[APIs] > [Environment Configuration] > 目的の環境を選択 > [Key Value Maps] タブに移動します。詳細については、環境 Key-Value マップの作成と編集をご覧ください。（MGMT-1393）

管理 UI の PopulateCache ポリシーのデフォルトの有効期限（Cloud 15.09.30）

API プロキシ エディタで PopulateCache ポリシーを追加すると、キャッシュの有効期限の <TimeoutInSec> 要素に 3, 600 秒（1 時間）の値が事前入力されます。以前のデフォルトは 300 秒（5 分）でした。（MGMT-2622）

デベロッパー サービス

API プロダクト ページのパフォーマンス、デベロッパー アプリが一覧表示されない（Cloud 16.01.20）

管理 UI で API プロダクトを表示すると、そのプロダクトに関連付けられているデベロッパー アプリが一覧表示されます。UI のパフォーマンスを向上させるため、API プロダクトの編集時にデベロッパー アプリのリストは表示されません。（MGMT-2869）

[Developer Apps] ページの [Key] 列（Cloud 15.08.05）

デベロッパー アプリが多数（数千）ある組織では、[デベロッパー アプリ] ページに [キー] 列を表示すると（アプリあたりのキー数が表示される）、表示パフォーマンスが低下する可能性があります。このような状況で表示パフォーマンスを改善するには、Apigee サポートに連絡して、組織レベルのプロパティ features.appsNoCredentialsEnabled = true を設定してください。このプロパティは Key 列を削除します。ただし、[Key] 列を削除すると、コンシューマー キーとシークレットで検索する機能も削除されます。（MGMT-2486）

デベロッパーの詳細ページの進行状況スピナー（Cloud 15.09.30）

管理 UI で [Developer Details] ページが読み込まれると、アプリがまだ読み込まれている場合は、ページの [Apps] セクションに進行状況スピナーが表示されます。これにより、アプリの読み込み中に [アプリ] セクションが空で表示されるという以前の動作が改善されます。（MGMT-2667）

収益化

API パッケージ名を編集する（Cloud 16.01.20）

API パッケージに公開済みの料金プランが含まれている場合でも、収益化ライフサイクルの任意の時点で API パッケージの名前を更新できます。（DEVRT-2177）

カスタム属性で小数を使用可能（Cloud 16.01.20）

「カスタム属性付きレートカード」プランを使用する場合、トランザクションの乗数として使用されるメッセージ ヘッダーのカスタム属性は、小数点以下 4 桁までの 10 進数値にできるようになりました。このタイプのプランの詳細については、レートカードのカスタム属性の詳細を指定する（DEVRT-2191）をご覧ください。

サマリー レポートの料金プラン名と ID（Cloud 15.09.02）

Management API で収益の概要レポートを生成する際に、レポートに「料金プラン」の名前と料金「プラン ID」の列を追加できます。これを行うには、レポートを作成するの説明に沿って、API 呼び出しに groupBy 属性として「RATEPLAN」を追加します。（この機能は収益化レポートの UI ではまだご利用いただけません）。詳細レポートでは、既存のレートプランの名前と ID の列が、他のグループ化列とともにレポートの先頭付近に表示されるようになりました。（DEVRT-1740）

分析サービス

応答時間指標の sum() 関数（Cloud 16.01.20）

分析のカスタム レポートと API 呼び出しで、ターゲット レスポンス時間、合計レスポンス時間、end_point_response_time に「合計」集計関数を使用できるようになりました。たとえば、/stats API（http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0）で、?select=sum(total_response_time) という「select」クエリ パラメータを使用できるようになりました。（AXAPP-2006）

レイテンシ分析レポート: API プロキシ名が並べ替えられる（Cloud 16.01.20）

レイテンシ分析レポートの UI（Apigee Edge Enterprise プランのみ）では、API プロキシは [Proxy] プルダウン リストにアルファベット順で表示されます。（MGMT-2858）

ダッシュボードに表示されるデベロッパー アプリの表示名（Cloud 16.01.20）

管理 UI のダッシュボードの [Developer Apps] 棒グラフには、内部名ではなく表示名でデベロッパー アプリが一覧表示されます。（MGMT-2853）

カスタム レポートの新しい日付/時刻ウィジェット（Cloud 16.01.20）

管理 UI のカスタム レポート ページの [日付/時刻選択ツール] ウィジェットが強化されました。（MGMT-2881）

GeoMap での都市のドリルダウン（Cloud 15.07.22）

アナリティクスの GeoMap には、米国とカナダの [都市] ドリルダウンが含まれています。地図上の州または県をクリックすると、通話の発信元となった都市の一覧が表示されます。（MGMT-2282）

アナリティクスのカスタム レポートでの |（パイプ）文字と = 文字（Cloud 15.09.02）

アナリティクスのカスタム レポートの定義では、|（パイプ）と = 記号を使用できます。以前は、これらの記号には %7C と %3D のエンコードを使用する必要がありました。（MGMT-2504）

プロキシパス接尾辞ディメンション（Cloud 15.09.30）

アナリティクスのカスタム レポートと API 呼び出しで、新しいプロキシパス接尾辞（proxy_pathsuffix）ディメンションを使用できるようになりました。プロキシパスの接尾辞は、ベースパスの後に続く API プロキシ URL の一部です。たとえば、条件付きフロー用に作成されたパスなどです。（AXAPP-1902）

レポートに表示名ではなくデベロッパー ID が表示される（Cloud 15.09.30）

デベロッパーを返す /stats API を使用して Edge 分析 API 呼び出しを行うと、デベロッパー ID とともにデベロッパーの表示名が返されます。以前は、デベロッパー ID のみが返されていました。（AXAPP-1759）

修正済みのバグ

このリリースでは以下のバグが修正されています。

Private Cloud 4.16.01

次の表に、Edge for Private Cloud 4.16.01 リリース以降に修正されたバグを示します。これらの修正を取得するには、Apigee Edge 4.16.01.x を最新の 4.16.01 リリースに更新するの説明に従って、4.16.01 インストールを最新の RPM とサポート ファイルに更新します。

Cloud 16.01.20

Cloud 15.07.08

Cloud 15.07.22

Cloud 15.08.05

Cloud 15.09.02

Cloud 15.09.30

Private Cloud 4.15.07.03

Private Cloud 4.15.07.01

既知の問題

このリリースには、次の既知の問題があります。

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart