Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。 info
2015 年 5 月 19 日（火）、Apigee Edge for Private Cloud の四半期リリース版をリリースしました。
以前のプロダクト名「Apigee Edge On-premises」または「OPDK」は、「Apigee Edge for Private Cloud」になりました。
ご不明な点がございましたら、Apigee Edge サポートにお問い合わせください。
Apigee Edge のすべてのリリースノートの一覧については、Apigee リリースノートをご覧ください。
新機能と拡張機能
このリリースにおける新機能と改善点は次のとおりです。
OpenLDAP - インストールとアップグレード
新規インストールとアップグレード インストールで Edge がサポートする LDAP サーバーは OpenLDAP のみになりました。
API サービス
Edge API サービスの新しい機能と機能強化は次のとおりです。
WebSocket
Edge は、ウェブ クライアントとサーバー間のリアルタイム ウェブ通信を有効にするために、WebSocket プロトコルをサポートしています。Edge は、WebSocket 通信でクライアントまたはサーバーのいずれかの役割を果たすことができます。Edge での WebSocket の設定と使用については、Apigee Edge for Private Cloud での WebSocket の使用ガイドをご覧ください。
API 管理のための外部認証プロバイダのサポート
Edge は、API 管理ユーザーを含む Active Directory やその他の外部認証プロバイダ/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-onpremise.conf ファイルのいずれかで apigee.feature.disableNodeJSLogs="false" を設定します。Node.js ログの詳細については、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（読み取り専用）ロールのメンバーシップを特定のメール ドメインのユーザーに制限できます。この機能を有効にするには、Apigee Edge for Private Cloud オペレーション ガイドの説明に従って、許可されたドメインを apigee4/conf/apigee/management-server/security.properties ファイルに追加します。
管理 UI のエラー メッセージ
管理 UI に表示されるエラー メッセージが、画面領域をより効率的に使用するように再設計されました。
新しい OAuthV2 障害変数
これらの新しい障害関連の変数は、OAuthV2 ポリシーによって設定されます。
- oauthV2.<policy-name>.failed - ポリシーが失敗した場合に true に設定されます。
- oauthv2.<policy_name>.<fault_name> - 障害の名前。（例: invalid_request）
- oauthv2.<policy_name>.<fault_cause> - 障害の理由。例: Token Expired
http://apigee.com/docs/api-services/content/oauthv2-policy をご覧ください。
商品の作成
新しい商品を作成する際に、表示名に加えて商品名を指定できるようになりました。
http://apigee.com/docs/developer-services/content/creating-api-products をご覧ください。
組織からユーザーを削除するための UI
UI の [組織ユーザー] ページで、[削除] ボタンが [削除] ボタンに置き換えられました。これは、組織からユーザーを削除しても、そのユーザーの Apigee アカウントは有効なままであることを明確にするためです。
http://apigee.com/docs/api-services/content/managing-organization-users をご覧ください。
管理 UI のフィルタ オプション
管理 UI の [API プロキシ]、[プロダクト]、[デベロッパー]、[アプリ] の各ページで、検索用の新しいフィルタ オプションが使用できるようになりました。
Offline Trace ツール
Offline Trace ツールを使用すると、以前に保存されたトレース セッションを表示および分析できます。保存されているトレース セッションは、基本的にトレース セッションの「記録」であり、トラブルシューティングや詳細な分析が必要な場合に役立ちます。Offline Trace ツールの UI は、「ライブ」の Trace ツールと似ています。
詳細については、オフライン Trace ツールの使用をご覧ください。
ユーザー設定に表示されるユーザーロール
管理 UI の [ユーザー設定] ページ（[ユーザー名] > [ユーザー設定]）に、ユーザーのロールが表示されるようになりました。
Edge 管理 UI の機能強化
このリリースには、Edge 管理 UI のユーザビリティと一貫性を改善するいくつかの小さな変更が含まれています。
分析サービス
Edge Analytics Services の新機能と機能強化は次のとおりです。
6 か月分のデータを利用可能
管理 UI または API で分析レポートを生成する場合、デフォルトでは、現在の日付から 6 か月以上経過しているデータはアクセスできません。6 か月以上前のデータにアクセスする必要がある場合は、Apigee Edge サポートにお問い合わせください。
分析に追加された変数
次の新しい変数が Edge 分析に渡され、API プロキシ トレース ウィンドウの AX ステージに表示されます。
- apigee.edge.execution.is_target_error - API エラーがターゲット側のエラー（値「1」）か、失敗した HTTP レスポンスのターゲット以外のエラー（値「0」）かを識別できます。HTTP レスポンスが成功した場合、値は null になります。
-
apigee.edge.execution.is_policy_error - ポリシーが失敗した（値「1」）か、失敗した HTTP レスポンスで失敗したポリシーがない（値「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 ダッシュボードをご覧ください。
- プロキシ パフォーマンス（新規）: API プロキシのトラフィック パターンと処理時間が表示されます。API プロキシ パフォーマンス ダッシュボードに代わるものです。API プロキシのパフォーマンスをご覧ください。
- トラフィックの構成（改訂）: ダッシュボードのルック アンド フィールとコンテンツを全面的に改訂しました。API プログラム全体に対する上位の API、アプリ、デベロッパー、プロダクトの影響を相対的に測定します。トラフィックの構成をご覧ください。
- エラー分析（改訂）: 外観と内容を全面的に改訂しました。API プロキシとターゲットのエラー率が表示されます。Error Code Analysis ダッシュボードをご覧ください。
-
既存のダッシュボードの名前が変更されました。
- [Endpoint Performance] が [Target Performance] に名前変更されました。API プロキシ バックエンド ターゲットのトラフィック パターンとパフォーマンス指標が表示されます。目標達成度をご覧ください。
- [Partner Engagement] が [Developer Engagement] に名称変更されました。登録済みのアプリ デベロッパーのうち、最も多くの API トラフィックを生成しているデベロッパーが表示されます。最も多くの API トラフィックと最も多くのエラーを生成しているデベロッパーをそれぞれ探すことができます。デベロッパー エンゲージメントをご覧ください。
デベロッパー サービス
Edge Developer Services の新機能と機能強化は次のとおりです。
SmartDocs の Swagger 2.0 のサポート
SmartDocs は Swagger 2.0 仕様ドキュメントのインポートをサポートし、Swagger 1.2 との下位互換性を維持します。セキュリティ スキーマ オブジェクトと一元化されたスキーマのサポートは、今後のリリースで提供される予定です。
収益化
Edge の収益化の新機能と機能強化は次のとおりです。収益化の詳細については、「既知の問題」セクションもご覧ください。
企業とデベロッパーの個別対応
会社とデベロッパーが別々に処理されるようになり、1 人のデベロッパーに複数の会社を、1 つの会社に複数のデベロッパーを追加できるようになりました。管理 UI に、[会社] と [デベロッパー] の別々のウィンドウが用意されました（[公開] メニューからアクセスできます）。
企業とデベロッパーを管理するをご覧ください。
収益化レポートでは、フィルタのラベルが [デベロッパー] から [企業] に変更されましたが、企業は引き続きメインのフィルタとして使用できます。
修正済みのバグ
このリリースでは以下のバグが修正されています。
| 問題 ID | 説明 |
|---|---|
| OPDK-954 | 4.15.01 Cassandra スキーマがアップグレードされない |
| MGMT-1986 | デベロッパーの追加中に UI エラーが発生する |
| MGMT-1983 | OAuth 2.0 認証コードを取得する API が間違ったステータスを返す |
| MGMT-1962 | 強力なパスワードで管理 UI にログインするとエラーが発生する パーセント記号などの特定の特殊文字を使用して UI にログインしても、エラーが発生しなくなりました。 |
| MGMT-1894 | [Developer Apps] ページの [Developer] 列の読み込みが完了しない |
| MGMT-1872 | カスタム レポートをダウンロードできない |
| MGMT-1777 | TLD が .acn のメールアドレスを持つユーザーを追加できない |
| MGMT-1362 | メールアドレスに「_」が含まれている場合、[パスワードをお忘れの場合] のメールが機能しない アンダースコアを含むメールアドレスで Private Cloud のパスワード再設定の問題を修正します。 |
| CORERT-613 | 「unrecognized_name」が原因で SSL handshake が失敗する |
| APIRT-1346 | OAuth2.0 - hash.oauth.tokens.enabled が true の場合、ハッシュ値がアクセス トークン レスポンスで返される |
今回のリリースでは、次のリリースのバグの修正も行いました。
| エッジクラウド | Edge for Private Cloud |
|---|---|
既知の問題
このリリースには、次の既知の問題があります。
| 問題 ID | 説明 |
|---|---|
| なし |
インストーラが 収益化のインストールまたはアップグレードで使用する 2 つの Cassandra スクリプトが、リリースに含まれていませんでした。 この問題を回避するには、Cassandra のインストールまたはアップグレード後に次のコマンドを実行して、収益化のインストールまたはアップグレードを完了します。
|
| CORERT-318 | ペイロードが大きい（数百 KB）API 呼び出しがハングすることがあります。この問題を回避するには、router.properties ファイルで次のプロパティ値を設定します。HTTPServer.streaming.buffer.limit=0（デフォルト設定は 10） |