4.15.01.00 - Apigee Edge オンプレミス リリースノート

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します
info

2015 年 1 月 27 日(火)に、Apigee Edge オンプレミスの四半期バージョンをリリースしました。

バージョン 4.15.01.00 には多数の新機能が含まれています。その多くは、 最新のホリデー シーズンと以前のクラウド リリースで対応されたものです。新機能の分野 には、管理 UI フレームワーク、LDAP、インストールとアップグレード、分析、レスポンス エラーの構成と圧縮などがあります。以下に全リストを示します。

ご不明な点がございましたら、Apigee Edge サポートにお問い合わせください。

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

新機能と拡張機能

このリリースにおける新機能と改善点は次のとおりです。

  • OpenLDAP が ApacheDS に置き換わる
    Edge は、API 管理環境でユーザーを認証するために OpenLDAP を提供するようになりました。OpenLDAP のメリットの 1 つは、パスワード ポリシーです。このポリシーを使用すると、さまざまなパスワード認証方法のオプションを構成できます。たとえば、連続して何回ログインに失敗すると、ディレクトリに対するユーザーの認証にそのパスワードを使用できなくなるようにするかなどです。詳細については、Edge OPDK オペレーション ガイドをご覧ください。

    OpenLDAP は、新規インストールで Edge がサポートする唯一の LDAP サーバーになりました。4.15.01.00 にアップグレードする Edge の既存の インストールでは、引き続き ApacheDS を使用できますが、4.15.01.00 の新規 インストールではすべて OpenLDAP が使用されます。

    4.15.01.00 のインストール手順の一部として OpenLDAP にアップグレードすることを選択した場合、ApacheDS のすべてのデータが OpenLDAP に移行されます。アップグレードの詳細については、既知の問題 セクションをご覧ください。
  • セキュリティの強化
    このリリースのセキュリティの改善では、パス インジェクションとトラバーサルの脆弱性、 ロールベースのアクセス権、クロスサイト リクエスト フォージェリの脆弱性、認証バイパス Edge 管理 UI での認証バイパス、外部エンティティの脆弱性に対処しています。
  • Apache Cassandra のパフォーマンスと安定性の向上
    このリリースでは、Edge プロダクトが NoSQL Cassandra データベースにアクセスする方法のパフォーマンスが向上しています。また、Cassandra 自体もバージョン 1.2.11 から 1.2.19 にアップグレードされ、改善されています。
  • トークン管理の改善
    OAuth トークンの返却とデータベースでのクリーンアップに関する機能強化に加えて、エンドユーザー ID、アプリ ID、またはその両方で OAuth 2.0 アクセス トークンを取得して取り消すことができるようになりました。詳しくは以下をご覧ください。
  • 分析の強化
    このリリースには、次のような分析の強化が多数含まれています。
  • ランタイムの復元力の向上
    このリリースには、Cassandra の障害時のポリシーの可用性、Netty ルーターの安定性、SSL スレッドの安定性など、ランタイムの復元力の向上が多数含まれています。
  • Node.js の機能強化
    このリリースには、次の Node.js の機能強化が含まれています。
    • 新しい Get Cached Node.js Logs API。これにより、Node.js スクリプトから最後の数百件のログ レコードを取得できます。
    • 「trireme-support」モジュール(Java で記述された Node.js モジュール)のサポート。詳細については、https://www.npmjs.com/package/trireme-support をご覧ください。
    • 仮想パスから組織名と環境名を削除し、 変数に移動しました。
    • Java 7 にアップグレードしました。
    • Trireme 0.8.4 にアップグレードしました。これにより、HTTP リクエストの解析と UTF-8 以外の文字セットの処理に関する問題が解決されます。
  • Play Framework が 2.0 にアップグレード
    収益化を含む Edge で使用される Play Framework が Play 2.0 にアップグレードされました。
  • JMX モニタリング統計情報でパスワードを要求するように構成可能に
    Management Server、Router、Message Processor、QPID、Postgres のモニタリング プロセスでは JMX が使用されます。JMX はデフォルトで有効になっており、リモート JMX アクセスにはパスワードは必要ありません。 ただし、JMX 統計情報にパスワード保護を適用して、アクセスを制御できるようになりました。詳細については、 Edge オペレーション ガイドをご覧ください。
  • API プロキシ リソースのワイルドカード
    API プロキシ リソースを定義するときに、ワイルドカード文字(アスタリスク *)を使用できます。たとえば、 /developers/*/apps や /developers/** などです。API プロキシ リソースの詳細については、バックエンド API リソースへの条件付きフローのマッピング をご覧ください
  • プロダクトの「/」リソースAPIRT-667
    API プロダクトに単一のスラッシュ「/」としてリソースを追加すると、デフォルトで Apigee は「/**」と同じように処理します。これにより、デベロッパーはベースパスの下にあるすべての URI にアクセスできます。新しい組織レベルの features.isSingleForwardSlashBlockingEnabled プロパティを使用すると、「/」のデフォルトの動作を変更できます。プロパティを「true」に変更すると(クラウドのお客様は Apigee サポートにお問い合わせください)、デベロッパーはリソースとしてベースパスにのみアクセスできます。

    詳細については、リソースパスの動作を構成するをご覧ください。
  • Quota と Spike Arrest の HTTP レスポンス エラー構成APIRT-664
    Apigee Edge 組織で、Quota ポリシーまたは Spike Arrest ポリシーで設定されたレート制限を超えたすべてのリクエストに対して、HTTP ステータス コード 429(リクエストが多すぎます)を返すように構成できるようになりました。デフォルトの構成では、HTTP ステータス コード 500(内部サーバーエラー)が返されます。

    Quota と Spike Arrest の違反で HTTP ステータス コード 429 を返すようにする組織で、features.isHTTPStatusTooManyRequestEnabled プロパティを true に設定するには、Apigee サポートにお問い合わせください。
  • HealthMonitor が SSL をサポート
    ロードバランサに割り当てられた HealthMonitor が SSL をサポートするようになりました。詳細については、バックエンド サーバー間の負荷分散 をご覧ください。
  • Edge Monetization インストーラが自動インストールをサポート
    Monetization で自動インストール(無人インストール)がサポートされるようになりました。詳細については、 Edge インストールと構成ガイドをご覧ください。
  • API レスポンスの gzip 圧縮MGMT-1127
    管理 API に対する呼び出しでは、Content-Length が 1024 バイト以上のレスポンスでの gzip 圧縮がサポートされています。使用方法:
    'Accept-Encoding: gzip, deflate'

修正済みのバグ

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

トピック 問題 ID 説明
メモリ使用率が高い CORERT-362 メモリ使用率が高いのは、メッセージ プロセッサによるプロセスの完了前にトリガーされる停止シェル スクリプトが原因でした。この問題は 解決されました。
SOAP WSDL プロキシの作成 MGMT-1526 管理 UI で SOAP ベースの API プロキシを作成すると、ブラウザがハングしていました。 この問題は解決されました。
名前にピリオドが含まれるデベロッパー アプリ MGMT-1236 管理 UI で、デベロッパー アプリの名前にピリオドが含まれている場合、アプリを更新できませんでした。この問題は解決されました。
MP の CPU とレイテンシの増加 CORERT-384 ターゲット レスポンスに「Connection: close」ヘッダーが含まれている場合、メッセージ プロセッサの CPU とレスポンスのレイテンシが増加していました。この問題は解決されました。
HTTP リクエストとレスポンスの統計情報 CORERT-364 累積 HTTP リクエストとレスポンスの統計情報が正しくありませんでした。この問題は 解決されました。
割り当てポリシーの適用 APIRT-909 カレンダーベースの割り当てポリシーで、割り当て期間の開始前に実行された API 呼び出しが誤って拒否されていました。この問題は解決されました。

このリリースには、次のリリースからのバグ修正も含まれています。詳細については、個々のリリース ノートをご覧ください。

Edge Cloud Edge オンプレミス

既知の問題

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

トピック 問題 ID 説明
LDAP のアップグレード DOC-1262

リリース 4.14.07 から 4.15.01 にアップグレードし、ApacheDS から OpenLDAP にアップグレードすると、名前にスペースが含まれるロール(「Read Only」など)が OpenLDAP で正しく再作成されません。

アップグレードする前に、名前にスペースが含まれるロールを削除して再作成してください。

すでにアップグレードしている場合は、次のコマンドを実行して OpenLDAP で問題のあるロールを削除します。

ldapdelete -H ldap://localhost:10389 -D 'cn=manager,dc=apigee,dc=com' -r -W 'cn=<role>,ou=userroles,o=<org>,ou=organizations,dc=apigee,dc=com'

次に、ロールを再作成します。

SMTP メールが失敗する OPDK-900 SMTP メール検証エラーが発生した場合は、apigee4/conf/ui/apigee.conf の次の プロパティの値が同じ値に設定されていることを確認してください。 apigee.mgmt.mailFrom and mail.smtp.user。または、SMTP メール 検証を無効にします。