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

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細

2015 年 9 月 8 日（火曜日）、Apigee Edge for Private のメジャー機能リリースをリリースしました。 説明します。

以前の Edge for Private Cloud 四半期リリース（4.15.04.00）以降、 次の四半期リリースに含まれています。

• Cloud: 15.04.15、 15.04.29、15.05.27、15.06.10、15.06.24
• プライベート クラウド: 4.15.04.01

アップグレードできる Edge のバージョン 4.15.07.00

Edge の現在のバージョンに応じて、次のいずれかを行います。

• 4.15.07.00 に直接アップグレードする
• 段階的なアップグレード。つまり、現在のバージョンから別のバージョンにアップグレードする必要がある 4.15.07.00 にアップグレードします。

詳細については、「どの Edge for Private Cloud バージョンにアップグレードできるか」を参照してください。 4.15.07.00.

バージョン 4.15.01.x または以前のバージョンからアップグレードする前に

1. Cassandra SSTable のバージョンを確認します。 <ph type="x-smartling-placeholder">
   </ph>
   1. ディレクトリを /&lt;install-root&gt;/apigee4/data/cassandra/data に変更します。
   2. 検索コマンドを実行します。
      &gt;-name *-ic-*
      Cassandra 1.2 SSTable を実行している場合は、一連の .db ファイルが返されます。
   3. 次の検索コマンドを実行します。
      &gt;-name *-hf-*
      結果は空になります。つまり、hf 形式の .db ファイルは存在しません。[ hf 形式の場合、 4.15.07.00 にアップグレードできます。
      
      hf 形式は、 Cassandra 1.0 の SSTable。hf 形式の *.db ファイルがある場合は、 この手順の残りの部分で説明するように、SSTable をアップグレードします。
2. hf 形式の *.db ファイルが見つかった場合は、SSTable をアップグレードします。 すべての Cassandra ノードで次のコマンドを実行することにより、すべての Cassandra ノードをアップグレードできます。 ノード:
   &gt; /<インストール ルート>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradestables -a
3. ステップ 1 を繰り返して、すべての *.db ファイルが Cassandra 1.2 の ic 形式であることを確認します。 できます。
4. Edge インストール環境のすべての Cassandra ノードで手順 1 から 3 を繰り返します。
5. Edge 4.15.07.00 にアップグレードします。
6. 4.15.07.00 のアップグレード後、*.db ファイルをチェックして、すべてがアップグレードされていることを確認します。 C* 2.0 安定版（安定版）に変更します。
   &gt;cd /&lt;install-root&gt;/apigee4/data/cassandra/data
   &gt;-name *-jb-*
   Cassandra 2.0 を実行している場合、このコマンドは一連の .db ファイルを返します。

新機能と拡張機能

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

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

選択的なコンポーネントのアップグレードとアンインストール

apigee-upgrade.sh および apigee-uninstall.sh スクリプトを使用して、Edge コンポーネントを選択できるようになりました。 アップグレードまたはアンインストールが必要です。以前は、ノード上のすべてのコンポーネントがアップグレードまたはアンインストールされていました。 （OPDK-1377、OPDK-1175）

アップグレードのロールバック

アップグレード中に apigee-upgrade.sh が失敗した場合は、apigee-rollback.sh を使用 スクリプトを使用してアップグレードをロールバックします。アップグレードの問題を解決したら、アップグレードを再試行できます。 （OPDK-1275）

インストーラ スクリプト オプションの短縮

インストール スクリプトに --help などの長い形式のオプションが含まれなくなりました。現在は -h などの 1 文字のオプションを使用できます。（OPDK-1356）

SmartDocs のインストール

setup-smartdocs.sh スクリプトを使用して SmartDocs をインストールすると、 これにより、SmartDocs が確実に環境にインストールされ、 予測します。以前は、これらの値はスクリプトにハードコードされていました。（OPDK-1310）

プロンプトなしで update-cass-pwd-in-config.sh を実行する

ENABLE_CASS_AUTH、CASS_USERNAME、CASS_PASSWORD 環境変数。（OPDK-1309）

エッジ プラットフォーム

このリリースに含まれる新しい Edge プラットフォーム機能は次のとおりです。

Edge Private Cloud でサポートされている OpenJDK 1.7

このリリースの Edge は、Oracle JDK 1.7 および OpenJDK 7 をサポートし、JDK 1.6 のサポートを削除しました。 （OPDK-1187）

OS サポート

Apigee Edge for Private Cloud では、オペレーティング システムのサポートが Red Hat を含むようになりました。 Enterprise Linux 6.6、7.0（64 ビット）、CentOS 6.5、6.6、7.0（64 ビット）、Oracle Linux 6.5.

OPDK 15.07 に含まれる Cassandra 2.0.15

このリリースでは、Cassandra 2.0.15 がインストールされます。以前のリリースにアップグレードする場合は、 更新されます。（OPDK-1197）

OAuth トークンのハッシュに対する SHA2 サポート

データベース セキュリティ侵害が発生した場合の OAuth トークンの保護を強化するために、Edge では SHA2 がサポートされています。 OAuth トークンをハッシュ化するアルゴリズム（SHA1 に加えて）を使用します。新しい組織レベルの 新しいトークンのハッシュを有効にして構成し、以前のハッシュを維持できます。 この新機能の前に存在していたすべてのトークンに 適用されます以前の Edge for Private Cloud では、 （API の keymanagement.properties ファイル）で hash.oauth.tokens.enabled というプロパティを Management Server と Message Processor など）で OAuth トークンの自動 SHA1 ハッシュが有効になりました。この プロパティのサポートは終了しました。

以前に hash.oauth.tokens.enabled プロパティを使用して SHA1 ハッシュを有効にしていた場合、 このリリースのアップグレード スクリプトは、新しい組織レベルのプロパティを自動的に生成します。宛先 アップグレード後に検証するには、この API を使用してシステム管理者として GET を実行します。 https://{host}:{port}/v1/o/{your_org}.

• 新しいプロパティを使用して組織でトークンのハッシュ化を有効にする方法については、以下をご覧ください。 "データベース内でトークンをハッシュする"アクセス トークンのリクエストの 説明します。
• 既存のトークンの一括ハッシュの詳細については、Edge for Private Cloud オペレーション ガイドをご覧ください。（APIRT-1389）

ログファイルのフラットなディレクトリ構造

Edge でログファイルをフラットなディレクトリ構造に保存するように Edge を構成するには、 message-logging.properties の enable.flat.directory.structure プロパティを true に設定します。 表示されます。詳細については、Message Logging ポリシーをご覧ください。 （APIRT-1394）

環境キャッシュのパフォーマンス

メモリ内キャッシュの管理と使用率を改善するには、「メモリ内の最大要素数」 環境キャッシュ リソースの設定のサポートが終了しました。ここに表示されている要素の総数は すべてのキャッシュ リソース（デフォルト キャッシュを含む）は、アプリケーションに割り当てられた 作成します。デフォルトでは、特定の Message Processor のメモリ内キャッシュに割り当てられた合計メモリ は使用可能なメモリの 40% です。これはメッセージのキャッシュ プロパティの設定によって決まります 追加してください。メモリ内キャッシュから要素が強制排除されるのは、 キャッシュメモリの不足や 要素の期限切れなど

「メモリ内の最大要素数」を使用する従来の動作に戻すにはプロパティ キャッシュ管理では、プロパティ overrideMaxElementsInCacheResource=false を cache.properties ファイルを開きます。（APIRT-1140）

API サービス

このリリースに含まれる新しい API サービス機能は次のとおりです。

新しいプロキシ エディタをデフォルトに設定

新しい API プロキシ エディタは、管理 UI ではデフォルトで有効になっています。新しいエディタには以下が含まれます 条件フローのより包括的なビューと、より包括的な 概要ページのすべての設定、「開発」ページのすべての設定、 条件付きフロー、エンドポイント、ポリシー、小さなスニペットではなく、より完全な XML ビュー ファイル名やテキストをクロールする検索機能などです（MGMT-2279）

新しい Delete OAuth v2.0 Info ポリシー

新しい「Delete OAuth v2.0 Info」ポリシーを使用すると、OAuth v2 アクセス トークンと あります。このポリシーは、これまで管理 API で提供されていた機能に代わるものです。詳細 詳しくは、 OAuthV2 Info ポリシーをご覧ください。（MGMT-2257）

新しい Delete OAuth v1.0 Info ポリシー

新しい「Delete OAuth v1.0 Info」ポリシーを使用すると、OAuth v1.0 リクエスト トークンの削除、 検証コードなどがあります。このポリシーは、 管理 API を使用できます。詳細については、Delete OAuth V1 Info ポリシーをご覧ください。 （APIRT-1351）

アクセス制御ポリシー

アクセス制御ポリシーが強化され、IP アドレスをより細かく評価できるようになりました ファイアウォール ルールに IP アドレスが含まれている場合の X-FORWARDED-FOR HTTP ヘッダー。

ヘッダーで複数の IP アドレスのチェックが有効になっている（サポートに連絡して feature.enableMultipleXForwardCheckForACL）、 ポリシーの新しい <ValidateBasedOn> 要素を使用すると、 ヘッダーの最初の IP、最後の IP、またはすべての IP を指定できます。詳細については、アクセス制御ポリシーをご覧ください。

Access Entity ポリシーの新しいエンティティ

Access Entity ポリシーでは、consumerkey-scopes、 認証コード、リクエストトークン、ベリファイアです。詳細については、Access Entity ポリシーをご覧ください。

Statistics Collector ポリシー: 統計情報名を小文字に自動変換する

API プロキシ エディタでカスタム分析コレクションを作成する場合（[開発] ページ > [ツール]） &gt;カスタム アナリティクス コレクションなど）、コレクタ変数（統計情報）の「名前」小文字のみを使用できます。 大文字で名前を入力すると、統計情報名が自動的に変換されます。 Statistics Collector ポリシーでは小文字にします。（MGMT-740）

API プロキシ エディタでの従来のトレースの削除

API プロキシ エディタの Trace 機能の最新バージョンがベータ版から 一般提供。「クラシック トレース」へのアクセス「Access the Classic version of trace」と リンクはご利用いただけなくなりました。

管理 UI の [ヘルプ] メニューから Apigee コミュニティにアクセスする

Apigee コミュニティには、管理 UI の [ヘルプ] メニューからアクセスできます。

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

管理 UI でのエラー メッセージの機能強化は次のとおりです。

• 全体的なすべてのエラー メッセージをグループ化して UI に表示するために使用する管理 UI ログイン セッションを記録します。今回のアップデートにより、エラー メッセージは アラートが発生したページから移動すると自動的に表示されます。（MGMT-2254）
• 管理 UI で、重複するエラー メッセージが抑制されなくなりました。（MGMT-2242）

UI パフォーマンスとエラーの強化

ページ表示など、管理 UI のさまざまな領域に全般的な機能強化を行いました パフォーマンスとエラーメッセージを クリーンアップします

管理 UI の [組織ユーザー] ページにあるロールのハイパーリンク

管理 UI の [Organization Users] ページ（[Admin] > [Organization Users]）で、ロール 名前がハイパーリンク化され、ロールページにすばやく移動できるようになりました。（MGMT-1055）

メッセージ フローの新しいターゲット変数

メッセージ フローの新しい変数により、より完全な URL 情報をターゲット エンドポイントと ターゲット サーバー:

• TargetEndpoint: target.basepath.with.query が request.url に置き換えられました。
• TargetServer: targetserver.name を loadbalancing.targetserver に置き換え。 また、target.basepath は、次の場合にのみ入力されます。 <Path> 要素は、TargetEndpoint の HTTPTargetConnection <LoadBalancer> 要素。

Server Name Indication（SNI）のサポート

Edge では、Server Name Indication サウスバウンド（Message Processor からターゲット できます。SNI を使用する場合は、Apigee サポートにお問い合わせください。

Java 1.7 が必要です。

TLS/SSL の拡張機能である SNI を使用すると、複数の HTTPS ターゲットを同じネットワーク内で提供できます。 すべてのターゲットで同じ証明書を使用しなくてもかまいません。

Edge 固有の構成は必要ありません。環境がサウスバウンド用に構成されている場合 SNI（デフォルトでは Edge クラウド）であり、Edge でサポートされています。

Edge はリクエスト URL からホスト名を自動的に抽出し、 SSL handshake リクエストに追加します。たとえば、ターゲット ホストが https://example.com/request/path の場合: 次に示すように、Edge によって server_name 拡張機能が追加されます。 下にあります。

SNI の詳細については、http://en.wikipedia.org/wiki/Server_Name_Indication をご覧ください。

"署名アルゴリズム"SSL 証明書の詳細を

新しい「署名アルゴリズム」フィールドが SSL 証明書の詳細に追加され、 管理 UI（[管理] > [SSL 証明書]）と管理 API（ キーストアまたはトラストストアからの証明書の詳細をご覧ください）。このフィールドには、「sha1WithRSAEncryption」または または「sha256WithRSAEncryption」を指定します。 あります。

有効期限が近づいている SSL 証明書を表示しています

管理 UI の [SSL Certificates] ページ（[Admin] > [SSL Certificates]）に、 SSL 証明書の有効期限は、 新しい有効期限プルダウンフィールドがあります

脅威対策のエラー構成

デフォルトでは、Edge は HTTP 500 Internal Server Error（内部サーバーエラー）ステータス コードと ExecutionFailed をスローします。 メッセージが JSON または XML Threat Protection ポリシーを通過しなかった場合に返されるエラーです。このエラー動作を変更するには、新しい組織レベルのプロパティを使用します。組織の設定時 プロパティ features.isPolicyHttpStatusEnabled を true に設定すると、 次の動作が発生します。

• リクエスト: リクエスト フローに脅威保護ポリシーが接続されていると、無効なメッセージが表示される 400 ステータス コードと、対応するポリシーのエラー メッセージを返す。
• レスポンス: レスポンス フローに脅威保護ポリシーが適用されていると、無効なメッセージ 500 ステータス コードが返され、対応するポリシー エラー メッセージがスローされる （ExecutionFailed ではなく）。

Cloud のお客様は、Apigee サポートに連絡して、 組織プロパティです。この機能は、今後 Edge Private Cloud のお客様にご利用いただけるようになる予定です。 Private Cloud の四半期リリース。

エンドポイント、プロキシ、その他のエンティティのスキーマの更新

TargetEndpoint、 ProxyEndpoint、APIProxy、その他多数https://github.com/apigee/api-platform-samples/tree/master/schemas をご覧ください。 （APIRT-1249）

デベロッパー サービス

このリリースに含まれるデベロッパー サービスの新機能は次のとおりです。

SmartDocs の一般提供

SmartDocs は、ベータ版から一般提供に移行されます。アップデートと新機能 含める:

• Swagger 2.0 のサポート（ファイルまたは URL によるインポート、以下のサポートを含む） オブジェクトを宣言します。
• SmartDocs を生成するテンプレートのビジュアル デザインが改善されました。
• デベロッパー ポータルのユーザビリティとワークフローの機能強化（コンテンツを通して利用可能） &gt;Drupal の SmartDocs メニュー。
• 「カスタム トークン」「API キー」という名称に変わりました。
• 認証「セキュリティ」定義されたオブジェクトが含まれます。
• テンプレート レベルでのクライアント認証の構成。新しいリビジョンはリセットされなくなりました 任意の事前構成済み SmartDocs クライアント認証情報。

機能の説明については、こちらのブログをご覧ください 投稿をご覧ください。

SmartDocs のドキュメントについては、SmartDocs を使用したドキュメントの API。

管理 UI に表示されるデベロッパー アプリ名

Edge のデベロッパー アプリには、変更されない内部名と表示名が両方とも表示される 変更できます。管理 UI の [Developer App] ページ（[Publish] > [Developer Apps] > （アプリ名）を含め、アプリの内部の「名前」は「表示名」とともに表示されるため、 トラブルシューティングや API 管理のために、アプリを内部名で視覚的に識別できます。

分析サービス

このリリースに含まれるアナリティクス サービスの新機能は次のとおりです。

保持データの時間制限

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

管理 UI から従来のバージョンのカスタム レポートを削除

カスタム アナリティクス レポートのオプションの従来のバージョンは、 できます。

Developer Engagement ウィジェットのパフォーマンス

メインの分析ダッシュボード（[デベロッパー エンゲージメント] セクション）のファネル ウィジェットを強化しました パフォーマンスが向上します

収益化

このリリースに含まれる新しい収益化機能は次のとおりです。

料金プランに関するメール通知

新しい料金プランのメール通知タイプを使用すると、一定のレベルに達したときにデベロッパーに通知できます。 購入済みのボリューム バンド料金プランまたはバンドル料金プランでのトランザクションやドルの上限。対象 詳しくは、 通知テンプレートを使用した通知。

定期料金および集計ベース期間の同期

料金プランでは、次の 2 つの異なる期間が適用される可能性があります。

• 料金プランの [料金] タブで設定される定期料金期間で、 定期的に料金を請求されました
• ボリューム バンドまたはバンドル プランのレート表で定義される集計ベース期間。 デベロッパーによるバンドルの使用がリセットされた時点を特定します。

これら 2 つの期間が同期されました。ゼロ以外の定期的な料金が発生すると同時に、 バンドルのレート表が料金プランに存在する場合、その両方の期間に定期的な請求期間が使用されます。たとえば 毎月の定期的な料金が発生する場合、レート表バンドルも毎月リセットされます（デフォルトでは、 。

定期的な料金が存在しない場合、バンドルは、 料金表。たとえば、あるデベロッパーがその月の 19 日にレート表の使用を開始し、 集計ベースが毎月の場合、バンドルの使用は 19 日後にリセットされます。

集計ベースはサポートが終了し、今後収益化の対象外となります なります。詳しくは、レート表プランの指定 をご覧ください。

収益概要レポートのカスタム属性

Transaction Recording ポリシーを使用すると、必要に応じてカスタム属性データを カスタム トランザクション属性を収益の概要に含めることができるようになりました できます。MINT.SUMMARY_CUSTOM_ATTRIBUTES プロパティを組織に追加すると、次のことが可能になります。 レポートで使用するためにデータベース テーブルに追加されるカスタム属性を示します。

Apigee Edge for Private Cloud のお客様は、次の API 呼び出しを使用してフラグを設定できます。 システム管理者の認証情報。

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

API 呼び出しのカスタム属性の配列は URL エンコードされていることに注意してください。

SmartDocs のアップグレード プロセス

ベータ版期間中に SmartDocs をすでに使用している場合、 一般提供バージョンでは、デベロッパーで SmartDocs をアップグレードする必要があります。 登録できます

デベロッパー ポータルですでに公開されている SmartDocs ページは、引き続き使用可能です。 更新プロセスに従う必要がありますが、既存のソフトウェア バージョンに加えた変更を 表示されなくなります。

デベロッパー ポータル内で SmartDocs をレンダリングして公開することは可能ですが、 SmartDocs は、Apigee の Edge API 管理内に存在する API モデルから生成されます 。Edge で API モデルに加えた変更は、すべての Pantheon で同じになります。 （開発者が Pantheon 環境全体でどのように存在するかに似ています）

SmartDocs ベータ版から一般提供にアップグレードするには

1. 15.05.27 リリースを更新してテストし、 Google Cloud 上の dev 環境または test 環境 Pantheon。
2. 新しいモデルを作成して、使用している既存の API モデルを置き換える。
   • Swagger ドキュメントや WADL ドキュメントをインポートしていた場合は、新しい できます。
   • SmartDocs モジュールを介して API モデルを維持している場合は、 SmartDocs JSON を入力し、ファイル添付を使用して新しいモデルにインポートします。
3. モデルのリビジョンのセキュリティ プロパティを設定します。[コンテンツ > SmartDocs >モデルページで、[セキュリティ設定] を選択します。
   
4. モデル設定ページ（[コンテンツ] > SmartDocs）で [設定]）に移動し、 選択します。
   
5. CSS アセットと JavaScript アセットのバージョン 6 を使用するようにカスタム テンプレートを更新し、変更を反映させる authSchemes や apiSchema などの新しいオブジェクト名も含まれます。SmartDocs の更新については、 詳細は SmartDocs から API をドキュメント化できます。
6. モデル リビジョンを再レンダリングして公開します。
7. 新しいドキュメントを検証したら、 本番環境ポータルを 15.05.27 リリースにアップグレードします。

Edge Enterprise をご利用で、アップグレードについて質問や懸念がある場合 marsh@apigee.com および cnovak@apigee.com までメールでお問い合わせください。それ以外の場合は、 Apigee コミュニティをご覧ください。 レスポンスが返されます。

今後の機能変更と機能強化

このセクションでは、今後予定されている機能変更と機能強化についてご紹介します。

次に変更: ResponseCache ポリシーの動作

今後のリリース（未定）のデフォルトの動作は、 &lt;ExcludeErrorResponse&gt;要素が変更されます。

現在の動作: 要素 <ExcludeErrorResponse>の レスポンスキャッシュポリシーは デフォルトでは false ですつまりデフォルトでは、メッセージに 可能な HTTP ステータス コード（3xx を含む）が、ResponseCache ポリシーによってキャッシュに保存される

今後の動作: <ExcludeErrorResponse> 要素の ResponseCache ポリシーはデフォルトで true に設定されます。つまり、デフォルトでは、HTTP レスポンスの ステータス コード 200 ～ 205 がキャッシュに保存されます。この動作をオーバーライドして、すべてのレスポンスをキャッシュに保存するには、 ステータス コードを確認するには、<ExcludeErrorResponse> 要素から true を返します。

現在の回避策: Private Cloud 4.15.07.00 以前のリリースで、 ステータス コードが 200 ～ 205 のレスポンスのみをキャッシュに保存するには、 要素 <ExcludeErrorResponse>true に設定します。

修正済みのバグ

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

既知の問題

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

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart