VMware Identity Manager Connector の割合制限の設定

VMware Identity Manager サービスにレート制限を設定するのと同様、VMware Identity Manager Connector にレート制限を設定できます。

コネクタでは、1 分あたりに許可されるログイン要求の数に制限を設定できます。制限に達すると、後続の要求は拒否されます。レート制限の設定はシステムのオーバーロードを防止するのに役立ちます。

たとえば、ログイン要求のレート制限を 100 に設定した場合、1 分あたり最初の 100 件のログイン要求が受け付けられますが、101 件目以降の要求は拒否されます。

VMware Identity Manager Connector クラスタの場合、制限はクラスタ内の各ノードに適用されます。たとえば、100 NodeA、NodeB、および NodeC を持つクラスタにログイン要求のレート制限を設定した場合、NodeA は 1 分あたり 100 件のログイン要求を処理し、NodeB は 1 分あたり 100 件のログイン要求を処理し、NodeC は 1 分あたり 100 件のログイン要求を処理します。ノードごとに個別のログイン制限を設定することはできません。

制限に達して要求が拒否されると、エンドユーザーにはエラーメッセージ「

」が表示されます。

デフォルトではレート制限は設定されていません。

レート制限は REST API を使用して設定します。VMware Identity Manager サービスへの呼び出しをする Postman などの REST クライアントを使用します。

変更は約 1 時間後に反映されます。変更をすぐに有効にする場合はコネクタを再起動します。

Linux ベースのコネクタ仮想アプライアンスを再起動するには、仮想アプライアンスにログインして次のコマンドを実行します。

service horizon-workspace restart

Windows コネクタを再起動するには、次のスクリプトを実行します。

install_dir\usr\local\horizon\scripts\horizonService.bat restart

割合の制限の設定

この API を使用すると VMware Identity Manager Connector のレート制限を設定できます。

[エンドポイント：]https://ホスト名/SAAS/jersey/manager/api/system/tuning/resiliency/tenant/orgResiliencyConnectorConfiguration?tenantId=テナント ID

[メソッド：]PUT

[説明：]VMware Identity Manager Connector で 1 分あたりに作成できるログイン要求の最大数を設定します。

[ヘッダー：]

コンテンツタイプ	`application/vnd.vmware.horizon.manager.system.tuning.resiliency.config+json;charset=UTF-8`
許可	`application/vnd.vmware.horizon.manager.system.tuning.resiliency.config+json`
認証	`HZN cookie_value` `cookie_value` を取得するには、VMware Identity Manager サービスにテナント管理者（つまり、VMware Identity Manager を最初にインストールしたときに作成された管理者ユーザー）としてログインし、ブラウザの cookie キャッシュから HZN cookie の値を取得します。

[パスのパラメータ：]

`hostname`	VMware Identity Manager サービスまたはロードバランサの完全修飾ドメイン名。
`tenantId`	VMware Identity Manager サービスのテナント ID。テナント ID は VMware Identity Manager コンソールの右上隅に表示されるテナント名です。

[要求本文：]

{
"config": {
         "rateLimitingDisabled": false,
         "rateLimits": {
             "login": {
                 "requestsPerMinute": n
             }
     }
 }
 }

[要求本文のパラメータ]

1 分あたりのログイン要求数

1 分あたりに許可されるログイン要求の最大数を指定します。

注：ログイン要求を完了するのに複数の API 要求が必要となること、各 API 呼び出しがレート制限までカウントされることを考慮します。たとえば、パスワード認証には 2 つの API 呼び出しが関与します。1 番目はログインページのレンダリング用、2 番目は認証情報の送信用です。

レート制限の表示

この API を使用すると VMware Identity Manager Connector に現在設定されているレート制限を表示できます。

[エンドポイント：]https://ホスト名/SAAS/jersey/manager/api/system/tuning/resiliency/tenant/orgResiliencyConnectorConfiguration?tenantId=テナント ID

[メソッド：]GET

[説明：]VMware Identity Manager Connector のログイン要求に現在設定されているレート制限を取得します。

[ヘッダー：]

認証	`HZN cookie_value` `cookie_value` を取得するには、VMware Identity Manager サービスにテナント管理者（つまり、VMware Identity Manager を最初にインストールしたときに作成された管理者ユーザー）としてログインし、ブラウザの cookie キャッシュから HZN cookie の値を取得します。

[パスのパラメータ：]

`ホスト名`	VMware Identity Manager サービスまたはロードバランサの完全修飾ドメイン名。
`テナント id`	VMware Identity Manager サービスのテナント ID。テナント ID は VMware Identity Manager コンソールの右上隅に表示されるテナント名です。

[出力例：]

{
"config": {
         "rateLimitingDisabled": false,
         "rateLimits": {
             "login": {
                 "requestsPerMinute": 100
             }
     }
 }
 }

1 分あたりのログイン要求数

1 分あたりに許可されるログイン要求の最大数。