ここに表示されているのは Apigee Edge のドキュメントです。
Go to the
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 - インストールと アップグレード
OpenLDAP は、新規インストールとアップグレード インストールで Edge がサポートする唯一の LDAP サーバーになりました。
API サービス
Edge API サービスの新機能と改善点は次のとおりです。
WebSockets
ウェブ クライアントとサーバー間のリアルタイム ウェブ通信を有効にするため、Edge は WebSocket プロトコルをサポートしています。Edge は、WebSocket 通信でクライアントまたはサーバーの役割を果たすことができます。Edge で WebSocket を設定して使用する方法については、 Apigee Edge for Private Cloud Using WebSockets ガイドをご覧ください。
API 管理の外部認証プロバイダのサポート
Edge は、API 管理ユーザーを含む Active Directory やその他の外部認証プロバイダ/LDAP システムと 統合されます。詳細については、 Edge for Private Cloud External Authentication Configuration ガイドをご覧ください。
管理 UI での共同ブランディング
Apigee ロゴの横に表示される独自のカスタムロゴを使用して、Edge 管理 UI を共同ブランディングできます。詳細については、Apigee Edge for Private Cloud Operations Guide の「Adding a custom logo to the Apigee UI menu」 をご覧ください。
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 Operations Guide をご覧ください。
特定のメール ドメインへのシステム管理者アクセスを制限する
システム管理者ロールまたはシステム管理者読み取り専用ロールのメンバーシップを、特定の メール ドメインのユーザーに制限できます。この機能を有効にするには、 _Apigee Edge for Private Cloud Operations Guide_ の説明に従って、許可されたドメインを 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 の [Organization Users] ページで、[Delete] ボタンが [Remove] ボタンに置き換えられました。 これは、組織からユーザーを削除しても、そのユーザーの Apigee アカウントは有効なままであることを明確にするためです。
http://apigee.com/docs/api-services/content/managing-organization-usersをご覧ください。
管理 UI のフィルタ オプション
管理 UI の [API Proxies]、[Products]、[Developers]、[Apps] ページで、検索に新しいフィルタ オプションを使用できます。
Offline Trace ツール
Offline Trace ツールを使用すると、以前に保存されたトレース セッションを表示および分析できます。保存されているトレース セッションは、基本的にトレース セッションの「記録」であり、トラブルシューティングや詳細な分析が必要な場合に役立ちます。Offline Trace ツールの UI は 、「ライブ」Trace ツールと似ています。
詳細については、Using Offline Trace ツールを使用するをご覧ください。
[User Settings] に表示されるユーザーロール
管理 UI の [User Settings] ページ（username > [User Settings]）に、ユーザーのロール が表示されるようになりました。
Edge 管理 UI の機能強化
このリリースでは、Edge 管理 UI の使いやすさと一貫性を向上させるための小さな改善が多数行われています。
分析サービス
Edge 分析サービスの新機能と改善点は次のとおりです。
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 - 失敗した 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、デベロッパー、プロダクト、デベロッパー アプリのパフォーマンス チャートが移動しました。以前は、これらのエンティティのメインページの下部に表示されていました。各ページの上部にある [Analytics] タブを選択して、グラフにアクセスできるようになりました。
- このリリースには、既存のダッシュボードまたは新しいダッシュボードに対する大幅な変更が含まれています。
- Apigee Dashboard （改訂）: プロキシ トラフィック、デベロッパー エンゲージメント、デベロッパー アプリの 3 つの指標グラフが含まれています。各グラフには、各指標をドリルダウンできる [詳細] ビューがあります。Apigee ダッシュボードをご覧ください。
- Proxy Performance （新規）: API プロキシのトラフィック パターン と処理時間を表示します。[API Proxy Performance] ダッシュボードに代わるものです。API プロキシ パフォーマンスをご覧ください。
- トラフィック構成（改訂）：ダッシュボードのデザインとコンテンツが完全に改訂されました。API プログラム全体に対する上位の API、アプリ、 デベロッパー、プロダクトの影響を相対的に測定します。トラフィック構成をご覧ください。
- エラー分析 （改訂）: デザインとコンテンツが完全に改訂されました。API プロキシとターゲットのエラー率を表示します。Error Code Analysis Dashboardをご覧ください。
-
既存のダッシュボードの名前が変更されました。
- Endpoint Performance が Target Performance に変更されました。API プロキシ バックエンド ターゲットのトラフィック パターンとパフォーマンス指標を表示します。ターゲット パフォーマンスをご覧ください。
- Partner Engagement が Developer Engagement に変更されました。最も多くの API トラフィックを生成している登録済みのアプリ デベロッパーが表示されます。最も多くの API トラフィックと最も多くのエラーを生成しているデベロッパーをそれぞれ探すことができます。デベロッパー エンゲージメントをご覧ください。
デベロッパー サービス
Edge デベロッパー サービスの新機能と改善点は次のとおりです。
SmartDocs の Swagger 2.0 のサポート
SmartDocs は Swagger 2.0 仕様ドキュメントのインポートをサポートし、Swagger 1.2 との下位互換性 を維持しています。セキュリティ スキーマ オブジェクトと集中型スキーマのサポートは、今後のリリースで提供される予定です。
収益化
Edge 収益化の新機能と改善点は次のとおりです。収益化の詳細については、「既知の問題」 セクションもご覧ください。
企業とデベロッパーの個別の処理
企業とデベロッパーが個別に処理されるようになり、デベロッパーに複数の企業を追加したり、企業に複数のデベロッパーを追加したりする際の柔軟性が向上しました。 管理 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 | .acn の TLD を持つメールアドレスのユーザーを追加できない |
| MGMT-1362 | [パスワードをお忘れの場合] メールは、メールアドレスに「_」が含まれている場合機能しません アンダースコアを含むメールアドレスで Private Cloud のパスワードの再設定ができない問題を修正しました。 |
| CORERT-613 | 「unrecognized_name」が原因で SSL handshake が失敗する |
| APIRT-1346 | OAuth2.0 - hash.oauth.tokens.enabled が true の場合、ハッシュ値がアクセス トークン レスポンスで返される |
このリリースには、次のリリースからのバグ修正も含まれています。
| Edge Cloud | Edge for Private Cloud |
|---|---|
既知の問題
このリリースには、次の既知の問題があります。
| 問題 ID | 説明 |
|---|---|
| なし |
インストーラが 収益化 のインストールまたはアップグレードで使用する 2 つの Cassandra スクリプトが、リリースに含まれていません。 この問題を回避するには、Cassandra のインストールまたは アップグレード後に次のコマンドを実行して、収益化のインストール/アップグレードを完了します。
|
| CORERT-318 | ペイロードが大きい（数百 KB）API 呼び出しがハングすることがあります。この問題を回避するには、router.properties ファイルで次のプロパティ値を設定します。HTTPServer.streaming.buffer.limit=0（デフォルト設定は 10） |