Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動。 情報
2015 年 5 月 19 日（火）、Apigee Edge for Private Cloud の四半期版をリリースしました。
以前のプロダクト名「Apigee Edge On-premises」または「OPDK」は、「Apigee Edge for Private Cloud」に変更されました。
ご不明な点がございましたら、Apigee カスタマー サポートにお問い合わせください。
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 メニューにカスタム ロゴを追加する」をご覧ください。
トレース内の 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> - 障害の理由。例: トークンが期限切れ
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 ツールと似ています。
詳細については、オフライン トレースツールの使用をご覧ください。
ユーザー設定に表示されるユーザーロール
管理 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（新規）: API プロキシのトラフィック パターンと処理時間が示されます。API Proxy Performance ダッシュボードに代わるものです。API プロキシのパフォーマンスをご覧ください。
- Traffic Composition（改訂版）: ダッシュボードの外観とコンテンツが完全に改訂されました。API プログラム全体に対する上位の API、アプリ、デベロッパー、プロダクトの影響を相対的に測定します。トラフィック構成をご覧ください。
- エラー分析（改訂版）: 外観と内容を完全に改訂しました。API プロキシとターゲットのエラー率が表示されます。Error Code Analysis ダッシュボードをご覧ください。
-
既存のダッシュボードの名前が変更されました。
- [Endpoint Performance] の名前が [Target Performance] に変更されました。API プロキシ バックエンド ターゲットのトラフィック パターンとパフォーマンス指標が表示されます。ターゲット パフォーマンスをご覧ください。
- [パートナー エンゲージメント] の名前が [デベロッパー エンゲージメント] に変更されました。登録済みのアプリ デベロッパーのうち、最も多くの API トラフィックを生成しているデベロッパーが表示されます。デベロッパーごとに、最も多くの API トラフィックと最も多くのエラーを生成しているユーザーを探すことができます。デベロッパー エンゲージメントをご覧ください。
デベロッパー サービス
Edge Developer Services の新機能と改善点は次のとおりです。
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 | Get an OAuth 2.0 authorization code API が間違ったステータスを返す |
| MGMT-1962 | 強力なパスワードで管理 UI にログインするとエラーになる パーセント記号などの特定の特殊文字を使用して UI にログインしても、エラーは発生しなくなりました。 |
| MGMT-1894 | [Developer Apps] ページのデベロッパー列の読み込みが完了しない |
| MGMT-1872 | カスタム レポートをダウンロードできない |
| MGMT-1777 | TLD が .acn のメールアドレスを持つユーザーを追加できない |
| MGMT-1362 | メールアドレスに「_」が含まれている場合に、[パスワードをお忘れの場合] メールが機能しない メールアドレスにアンダースコアが含まれているプライベート クラウドでのパスワードの再設定の問題を修正しました。 |
| 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） |