4.17.09 - Edge for Private Cloud リリースノート

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメント。 詳細

以前の Edge for Private Cloud の機能リリース以降、次のリリースに 本機能リリースに含まれる機能は次のとおりです。

特定のクラウド リリースが Edge for Private Cloud のバージョンに含まれているかどうかを確認する方法については、リリース番号についてをご覧ください。

リリースの概要

このリリースの最も重要な新機能は、Edge、API BaaS、Developer Services ポータルの認証メカニズムとして Security Assertion Markup Language（SAML）2.0 のサポートが追加されたことです。Edge で SAML を使用することで、Edge UI と API で SSO をサポートできます。 SAML をサポートする他のサービスにも使用できます。

SAML 認証には、いくつかの利点があります。SAML を使用すると、次のことが可能になります。

• ユーザー管理を完全に制御できます。ユーザーが退職し、 Edge へのアクセスが自動的に拒否されます。
• Edge にアクセスするユーザーの認証方法を制御します。別の認証オプションを選択でき、 Google Cloud リソースにアクセスできます。
• 認証ポリシーを制御できます。SAML プロバイダのほうが、企業の標準とより一致した認証ポリシーをサポートしている場合もあります。
• Google Workspace でのログイン、ログアウト、失敗したログイン試行、高リスク アクティビティをモニタリングできます。 デプロイできます。
• SAML は認証にのみ使用されることに注意してください。認可は引き続き Edge によって制御される できます。

詳しくは、SAML のサポート をご覧ください。

このリリースには、次のようなその他の注目すべき機能が含まれています。

• Developer Services ポータルを Apache/MySQL から Postgres/Nginx に移行可能
• Edge UI で TLS を無効にするコマンド
• Edge インストールを構成するための新しいプロパティ
• コンシューマ キーとシークレットのカスタム命名規則
• Red Hat/CentOS バージョン 7.4 のサポート

このトピックの残りの部分では、すべての新機能、アップデート、バグ修正について詳しく説明します。 含まれています。

非推奨と廃止

このリリースでは、次の機能が非推奨または廃止されました。詳しくは、Edge のサポート終了に関するポリシーをご覧ください。

サポートの終了

Apigee セキュアストア（Vault）の非推奨

Apigee のセキュリティは 「Vault」とも呼ばれています。はサポートを終了し、2018 年 4 月に廃止される予定です。 Key-Value ペアの暗号化ストレージを提供する Vault は、Management API を使用して作成されます。 apigee-access Node.js モジュールの関数を使用して実行時にアクセスできます。

Key-Value マップの操作で説明されているように、セキュアストアではなく、暗号化された Key-Value マップ（KVM）を使用します。暗号化された KVM は Vault と同じくらい安全であり、作成や管理の選択肢も増えます 使用します。（MGMT-3848）

API プロキシの [パフォーマンス] タブでのパス追加機能のサポート終了

このリリースまでは、管理 UI で API プロキシに移動し、[パフォーマンス] タブに移動して、プロキシの [パフォーマンス] タブと [ビジネス取引] ダッシュボードでグラフベースの比較を行うための異なるパスを作成できました。この機能は廃止され、UI では使用できなくなりました。この機能の代わりに、次の Apigee を参照してください。 コミュニティ記事: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html （EDGEUI-902）

新機能とアップデート

このリリースにおける新機能と機能強化は次のとおりです。その他の推奨事項 機能強化です。このリリースには、複数のユーザビリティ、パフォーマンス、セキュリティ、安定性 強化できます。

プライベート クラウド

Edge、API BaaS、Developer Services ポータルに SAML サポートを追加

Edge では、Edge、API BaaS、デベロッパー サービス ポータルの認証メカニズムとして Security Assertion Markup Language（SAML）2.0 がサポートされるようになりました。SAML ではシングル サインオンがサポートされている 認証します。SAML を使用することで、その他のサービスに加えて Edge でも SSO をサポート可能 SAML にも対応しています。

Edge for Private Cloud で SAML をサポートするをご覧ください。

apigee-ssoadminapi.sh ユーティリティを追加しました

SAML を有効にしたら、新しい apigee-ssoadminapi.sh を使用して、ユーザーや組織の作成などの多くの管理タスクを実行します。

apigee-ssoadminapi.sh の使用をご覧ください。

（DOS-5118）

Developer Services ポータルを Apache / MySQL / MariaDB から Nginx / postgres に移行できるようになりました

Developer Services ポータルの .tar ベースのインストールでは、Apache と MySQL、または MariaDB を使用します。 これで、既存のポータルのインストールを移行して、Nginx と Postgres を使用できるようになりました。ポータル バージョン 4.17.09 にアップデートする場合は、この移行が必要です。

tar ベースのポータルを RPM ベースのポータルに変換するをご覧ください。

Red Hat / CentOS バージョン 7.4 のサポートを追加しました

Edge for Private Cloud、API BaaS、Developer Services ポータルをデプロイできるようになりました Red Hat/CentOS バージョン 7.4 で使用できます。

サポートされているソフトウェアとそのバージョンをご覧ください。

インストール時にインストーラが CPU とメモリの要件を確認するプロパティを追加しました

Edge のインストール構成ファイルで、次のプロパティがサポートされるようになりました。

ENABLE_SYSTEM_CHECK=y 

「y」の場合、システムの CPU とメモリの要件を満たしているか、 表示されます。詳しくは、インストール要件をご覧ください。 要件があります。デフォルト値は n で、このチェックは行われません。

Edge の 構成ファイルのリファレンスをご覧ください。

（DOS-4772）

サーバーに複数のインターフェース カードがある場合に、インストーラが使用する IP アドレスを選択できるようにプロパティを追加しました。

サーバーに複数のインターフェース カードがある場合、「hostname -i」スペースで区切られた IP アドレスのリスト。デフォルトでは、Edge インストーラは返ってきたリストの最初の IP アドレスを使用しますが、これが正しい IP アドレスでない場合があります。この代替手段として、インストール構成ファイルで次のプロパティを設定できます。

ENABLE_DYNAMIC_HOSTIP=y

このプロパティを「y」に設定すると、アプリケーションとして使用する IP アドレスを選択するよう求められます。 自動的に行われます。デフォルト値は「n」です。

Edge 構成ファイル リファレンスをご覧ください。

（DOS-5117）

TLS の構成に使用できる新しい UI オプションと API

クラウド向けの新しいセルフサービス TLS/SSL 機能のベータ版リリースは、 ベータ版の機能です。このベータ版を使用すると、次のことができます。

• UI および API でキーストアとトラストストアを作成、変更、削除する
• TLS 証明書を PKCS12/PFX としてアップロードする
• UI または API から自己署名証明書を生成する
• UI でキーストアまたはトラストストアの有効性をテストする

これらの機能のベータ版ドキュメント（PDF）は、次の場所で入手できます。

• Edge Cloud UI を使用してキーストアとトラストストアを作成する
• Edge API を使用してキーストアとトラストストアを作成する

詳細については、以下のドキュメント（PDF）をご覧ください。

• TLS の構成オプション
• Cloud 用 API への TLS アクセスの構成
• Edge からバックエンドへの TLS の構成
• Cloud の TLS 証明書を更新する

（EDGEUI-1058）

難読化されたパスワード コマンドを追加しました

難読化されたパスワードを生成するコマンドを追加しました。これにより、任意のコンポーネントが暗号化されたパスワードを生成できるようになりました。難読化されたパスワードを生成するには、Edge Management Server で次のコマンドを使用します。

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

新しいパスワードを入力し、プロンプトで確認します。セキュリティ上の理由から、パスワードのテキストは表示されません。このコマンドは、パスワードを次の形式で返します。

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

TLS/SSL の構成 をご覧ください。

（TBD-250）

組織ユーザーの ID を変更する際に新しいパスワードを難読化する新しいコマンドを追加 パスワード

組織ユーザーのパスワードを再設定するために、apigee-service ユーティリティを使用して apigee-openldap を呼び出します。

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

システム管理者のパスワードを入力してから、新しいユーザー パスワードの入力を求められます。対象 セキュリティ上の理由から、入力したパスワードのテキストは表示されません。

Edge のリセット パスワード。

（DBS-1733）。

Edge UI で TLS を無効にするコマンドを追加

これで、Edge UI で次のコマンドを使用して TLS を無効にできるようになりました。

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

管理 UI の TLS の構成をご覧ください。

（EDGEUI-1114）。

ログメッセージのタイムスタンプの形式を制御するプロパティを追加

デフォルトでは、Message Logging ポリシーによって作成されたログメッセージのタイムスタンプの形式は次のとおりです。

yyyy-MM-dd'T'HH:mm:ss.sssZ

例:

2017-05-08T13:33:00.000+0000

conf_system_apigee.syslogger.dateFormat を使用して、 プロパティを使用して、その形式を制御します。

メッセージ ロギング に関するポリシーに準拠する必要があります。

（APIRT-4196）

API BaaS のインストールに、新しい必須の SMTP 構成パラメータを追加しました

API BaaS インストール構成ファイルで SMTPMAILFROM パラメータを使用する必要があります。このパラメータは、API BaaS の実行時に使用されるメールアドレスを指定します。 ユーザーがパスワードの再設定をリクエストしたときなどに、自動メールを送信します。

BaaS 構成ファイル リファレンスをご覧ください。

（APIBAAS-2103）

ポータルの Edge Router と Nginx ウェブサーバーがポートにアクセスできるようにするサポートを追加しました。 1,000 未満

ポータルで Router と Nginx ウェブサーバーを使用して、別のユーザーとして実行しなくても 1000 未満のポートにアクセスできるようになりました。以前のリリースでは、Router と Nginx ウェブサーバーは、特別なユーザーとして実行しないと 1000 未満のポートにアクセスできませんでした。

Edge UI のロギングレベルの構成方法を変更しました

Edge UI のロギングレベルの構成に使用するプロパティが変更されました。新しいプロパティと手順については、Edge コンポーネントのログレベルの設定をご覧ください。

（EDGEUI-886）

API サービス

コンシューマ キーとシークレットのカスタム命名規則

の命名規則と検証が更新されました デベロッパー アプリ用のカスタム コンシューマ キーとシークレットを作成するをご覧ください。コンシューマ キーとシークレットは 英数字、アンダースコア、ハイフンのみ使用できます。その他の特殊文字は使用できません。

カスタム鍵 / シークレットの作成プロセスについては、既存のコンシューマキーとシークレットのインポートをご覧ください。（MGMT-3916）

キーストアとターゲット サーバーの検証

キーストアとターゲット サーバーの名は最大 255 文字で、英字、数字、スペース、ハイフン、アンダースコア、ピリオドを使用できます。Edge では、作成時にこの点が検証されるようになりました。 （MGMT-4098）

修正済みのバグ

このリリースでは以下のバグが修正されています。このリストは、サポート チケットの修正状況を確認するユーザーを対象としています。すべてのユーザーに詳細情報を提供することを目的としたものではありません。

プライベート クラウド 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16（UI）

Cloud 17.08.14（API 管理および ランタイム）

Cloud 17.07.31（API 管理）

Cloud 17.07.17（API 管理および ランタイム）

Cloud 17.06.20（UI）

Cloud 17.06.14（UI）

Cloud 17.05.22.01（収益化）

Cloud 17.05.22（UI）

Cloud 17.05.22（API 管理）

Cloud 17.05.08（UI）

Cloud 17.04.22（API 管理）

既知の問題

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