4.15.04.00 - Apigee Edge for Private Cloud リリースノート

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください
情報

2015 年 5 月 19 日(火)、Apigee Edge for Private Cloud の四半期バージョンをリリースしました。

以前のプロダクト名「Apigee Edge On-Prem」または「OPDK」は、現在「Apigee Edge for Private Cloud」になりました。

ご不明な点がございましたら、Apigee カスタマー サポートまでお問い合わせください。

Apigee Edge リリースノートの一覧については、Apigee リリースノートをご覧ください。

新機能と拡張機能

このリリースでの新機能と機能強化は次のとおりです。

OpenLDAP - インストールとアップグレード

現在、OpenLDAP は、Edge で新規およびアップグレードのインストール用にサポートされている唯一の LDAP サーバーです。

API サービス

Edge API サービスの新機能と機能強化は次のとおりです。

WebSockets

ウェブ クライアントとサーバー間でのリアルタイムのウェブ通信を可能にするために、Edge では WebSocket プロトコルをサポートしています。Edge は、WebSocket 通信でクライアントまたはサーバーの役割を果たすことができます。Edge で WebSocket を設定して使用する方法については、WebSockets を使用した Apigee Edge for Private Cloud のガイドをご覧ください。

API 管理に対する外部認証プロバイダのサポート

Edge は、Active Directory や、API 管理ユーザーを含む他の外部認証プロバイダ/LDAP システムと統合されます。詳細については、Edge for Private Cloud の外部認証構成ガイドをご覧ください。

管理 UI でのブランド提携

Edge 管理 UI は、Apigee ロゴの横に表示される独自のカスタムロゴでブランド提携できます。詳細については、Apigee Edge for Private Cloud 運用ガイドの「Apigee UI メニューへのカスタムロゴの追加」をご覧ください。

Trace の Node.js ログ

Node.js API プロキシをデバッグするときに、API プロキシ エディタの [Trace] ビューで Node.js ログ機能を有効にできます。この機能を有効にするには、インストール環境の apigee-base.conf ファイルまたは apigee-onprem.conf ファイルに apigee.feature.disableNodeJSLogs="false" を設定します。Node.js Log の詳細については、Node.js プロキシのデバッグとトラブルシューティングをご覧ください。

パスワードの有効期限

Edge 4.15.01.x では、Edge のパスワードは 30 日後に自動的に期限切れになりました。これは、有効期限が切れる前にパスワードを変更しない限り、ユーザーはロックアウトされたことを意味します。ただし、システム管理者のパスワードが期限切れになり、システム管理者が Edge からロックアウトされました。

4.15.04.00 にアップグレードすると、パスワードが期限切れにならないようにデフォルトが変更されます。必要に応じて、/opt/apigee4/bin/apigee-enable-pwlockout.sh スクリプトを使用して Edge パスワードが期限切れになるように構成できます。詳細については、Apigee Edge for Private Cloud 運用ガイドをご覧ください。

sysadmin アクセスを特定のメールドメインに制限する

読み取り専用 sysadmin ロールまたは sysadmin ロールのメンバーを、特定のメールドメインのユーザーに制限できます。この機能を有効にするには、許可されたドメインを apigee4/conf/apigee/management-server/security.properties ファイルに追加します。詳細については、Apigee Edge for Private Cloud 運用ガイドをご覧ください。

管理 UI のエラー メッセージ

管理 UI のエラー メッセージ表示が、画面領域をより効率的に使用するように再設計されました。

新しい OAuthV2 障害変数

以下の新しい障害関連変数は、OAuthV2 ポリシーによって設定されます。

  • oauthV2.<policy-name>.failed - ポリシーが失敗した場合は true に設定します。
  • oauthv2.<policy_name>.<fault_name> - 障害の名前。例: invalid_request
  • oauthv2.<policy_name>.<fault_cause> - 障害の理由。例: トークンの期限が切れています

http://apigee.com/docs/api-services/content/oauthv2-policy をご覧ください。

商品の作成

新しいアイテムを作成するときに、表示名に加えてプロダクト名を指定できるようになりました。

http://apigee.com/docs/developer-services/content/creating-api-products をご覧ください。

組織からユーザーを削除するための UI

UI の [Organization Users] ページで、[削除] ボタンが [削除] ボタンに置き換えられました。 これは、組織からユーザーを削除しても、そのユーザーの Apigee アカウントはアクティブのままであることを明確にするためです。

http://apigee.com/docs/api-services/content/managing-organization-users をご覧ください。

管理 UI のフィルタ オプション

管理 UI の [API プロキシ]、[プロダクト]、[デベロッパー]、[アプリ] の各ページでは、検索用の新しいフィルタリング オプションを使用できます。

Offline Trace ツール

Offline Trace ツールを使用すると、以前に保存したトレース セッションを表示して分析できます。保存されているトレース セッションは、基本的にトレース セッションの「記録」であり、トラブルシューティングや詳細な分析が必要な場合に役立ちます。Offline Trace ツールの UI は、ライブの Trace ツールに似ています。

詳細については、Offline Trace ツールの使用をご覧ください。

[ユーザー設定] に表示されたユーザー役割

管理 UI の [ユーザー設定] ページ([ユーザー名] > [ユーザー設定])に、ユーザーのロールが表示されます。

Edge 管理 UI の機能強化

このリリースには、Edge 管理 UI のユーザビリティと整合性に関する小規模な改善が多数含まれています。

分析サービス

Edge Analytics Services の新機能と機能強化は次のとおりです。

6 か月分のデータを利用可能

管理 UI または API を使用して分析レポートを生成する場合、デフォルトでは、現在の日付から 6 か月以上経過したデータにアクセスできません。6 か月以上前のデータにアクセスする場合は、Apigee サポートにお問い合わせください。

変数がアナリティクスに追加される

次の新しい変数が Edge Analytics に渡され、API プロキシ トレース ウィンドウの AX ステージに表示されます。

  • apigee.edge.execution.is_target_error - API エラーがターゲット側のエラー(値「1」)か、失敗した HTTP レスポンスのターゲット以外のエラー(値「0」)かを識別できます。HTTP レスポンスが成功した場合、値は null です。
  • apigee.edge.execution.is_policy_error - HTTP レスポンスの失敗でポリシーが失敗した(値 1)か、失敗したポリシーがない(値 0)かを識別できます。HTTP レスポンスが成功した場合、値は null です。
    次の関連変数は、最初に失敗したポリシーの詳細を提供します。失敗したポリシーがない場合、値は null になります。
    • apigee.edge.execution.fault_policy_name - 失敗したポリシーの名前。
    • apigee.edge.execution.fault_flow_name - 失敗したポリシーのフローの名前(PreFlow、PostFlow、ユーザー定義フローなど)。
    • apigee.edge.execution.fault_flow_state - フロー内でポリシーが接続された場所。有効な値: PROXY_REQ_FLOW、TARGET_REQ_FLOW、TARGET_RESP_FLOW、PROXY_RESP_FLOW。

ダッシュボード

  • API、デベロッパー、プロダクト、デベロッパー アプリのパフォーマンス グラフは移動しました。以前は、これらのエンティティのメインページの下部に表示されていました。ここでは、各ページの上部にある [分析] タブを選択して、グラフにアクセスします。
  • このリリースには、以下の既存または新しいダッシュボードに関する主要な作業が含まれています。
    • Apigee ダッシュボード(改訂): プロキシ トラフィック、デベロッパー エンゲージメント、デベロッパー アプリの 3 つの指標グラフが含まれます。各グラフには「詳細」ビューがあり、各指標を掘り下げることができます。Apigee ダッシュボードをご覧ください。
    • Proxy Performance(New): API プロキシのトラフィック パターンと処理時間を表示します。API プロキシ パフォーマンス ダッシュボードに代わるものです。API プロキシ パフォーマンスをご覧ください。
    • トラフィック構成(改訂): ダッシュボードのデザインとコンテンツを完全に改訂しました。API プログラム全体に対する上位の API、アプリ、デベロッパー、プロダクトの相対的な貢献度を測定します。トラフィック構成をご覧ください。
    • Error Analysis(改訂): デザインと内容を完全に改訂しました。API プロキシとターゲットのエラー率を表示します。エラーコード分析ダッシュボードをご覧ください。
  • 以下の既存のダッシュボードの名前が変更されました。
    • [エンドポイント パフォーマンス] が [ターゲットのパフォーマンス] に名前変更されました。API プロキシ バックエンド ターゲットのトラフィック パターンとパフォーマンス指標が表示されます。ターゲットのパフォーマンスをご覧ください。
    • [パートナー エンゲージメント] を [デベロッパー エンゲージメント] に名称変更: 最も多くの API トラフィックを生成している登録済みアプリ デベロッパーが表示されます。デベロッパーごとに、最も多くの API トラフィックと最も多くのエラーを生成している要素を確認できます。デベロッパー エンゲージメントをご覧ください。

デベロッパー サービス

Edge Developer Services の新機能と機能強化を以下に示します。

SmartDocs に対する Swagger 2.0 のサポート

SmartDocs では、Swagger 2.0 仕様ドキュメントのインポートがサポートされ、Swagger 1.2 との下位互換性が維持されます。セキュリティ スキーム オブジェクトと一元化されたスキーマのサポートは、今後のリリースで利用できるようになる予定です。

収益化

Edge 収益化の新機能と機能強化は次のとおりです。収益化の詳細については、「既知の問題」セクションをご覧ください。

会社とデベロッパーの扱いを分ける

会社とデベロッパーが別々に処理できるようになったため、複数の会社をデベロッパーに、複数のデベロッパーを会社に追加する際の柔軟性が高まりました。管理 UI で、[Companies] と [Developers] の個別のウィンドウを利用できるようになりました([Publish] メニューからアクセスできます)。

会社とデベロッパーを管理するをご覧ください。

収益化レポートでは、フィルタラベルが「デベロッパー」から「会社」に変更されましたが、会社は依然としてメインのフィルタです。

修正済みのバグ

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

問題 ID 説明
OPDK-954 4.15.01 Cassandra スキーマがアップグレードされない
MGMT-1986 デベロッパーの追加中に UI エラーが発生する
MGMT-1983 OAuth 2.0 認証コード API が誤ったステータスを返す
MGMT-1962 安全なパスワードを使用した管理 UI へのログインエラー
パーセント記号などの特定の特殊文字を使用して UI にログインした場合、エラーがなくなりました。
MGMT-1894 デベロッパー アプリ ページの読み込みがデベロッパー列で完了しない
MGMT-1872 カスタム レポートをダウンロードできない
MGMT-1777 TLD が .acn のメールアドレスのユーザーを追加できません
MGMT-1362 メールアドレスに「_」が含まれている場合、パスワードをお忘れの場合が機能しない
アンダースコアを含むメールアドレスでの Private Cloud でのパスワードの再設定に関する問題を修正しました。
CORERT-613 「unRecognize_name」による SSL handshake の失敗
APIRT-1346 OAuth2.0 - hash.oauth.tokens.enabled が true の場合、アクセス トークンのレスポンスでハッシュ値が返されます。

このリリースには、以下のリリースのバグ修正も含まれています。

エッジクラウド Edge for Private Cloud

既知の問題

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

問題 ID 説明
なし

インストーラが Monetization のインストールまたはアップグレードで使用する 2 つの Cassandra スクリプトがリリースに含まれていませんでした。

この問題を回避するには、Cassandra のインストールまたはアップグレード後に次のコマンドを実行して、収益化のインストールまたはアップグレードを完了します。

  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt
  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
CORERT-318 大きなペイロード(数百 KB)を含む API 呼び出しはハングする場合があります。この問題を回避するには、router.properties ファイルで次のプロパティ値を設定します。
HTTPServer.streaming.buffer.limit=0(デフォルトの設定は 10)