> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/ras-admin-guide/v22-ja-jp/ras-connection-broker/enabling-connection-broker-api.md). # コネクションブローカー API の有効化 Parallels RAS では、RAS コネクションブローカーを使用せずにセッションを管理することが可能です。これは、サードパーティ製の手法を用いてセッションを管理したい組織にとって便利です。これをオンにする手順は以下の通りです。 以下のステップに加え、API による構成が必要です。この API については、[ここに](https://download.parallels.com/ras/v21/en_US/Parallels-RAS-Connecting-Using-Connection-Broker-API.pdf)ドキュメントがあります。 **「Farm**」＞「**Site**」＞「**Connection Brokers**」に移動し、以下の手順に従ってください： 1. \[**タスク**] > **\[サイトのデフォルト設定]** を選択します（または、特定のコネクションブローカーに割り当てる場合は、そのコネクションブローカーのプロパティを選択します）。 2. \[**API]** タブを選択してください 3. **\[APIを有効にする]** を選択します（個別のコネクションブローカーで設定する場合は、\[**デフォルト設定を継承する]** のチェックを外す必要があります）。 ### **SSL/TLS** 1. 「**APIポート**」オプションを選択し、安全なAPIコミュニケーション用のポート番号を指定してください 2. \[**許可される SSL バージョン]** ドロップダウン リストから、必要な SSL/TLS バージョンを選択してください。 3. \[**暗号強度]** 入力フィールドで、希望する暗号強度を選択してください。 4. 「**暗号強度**」フィールドで「カスタム」を選択した場合は、「**暗号**」フィールドで暗号を指定してください。暗号の強度が強いほど、暗号化も強固になり、解読に必要な作業量が増大します。 5. 「ネットワーク **サーバーの設定に従って暗号方式を使用する**」オプションは、既定ではオンになっています。このオプションをオフにすることで、クライアント コンピューターのユーザー設定を使用することができます。 6. \[**セキュリティ証明書]** ドロップダウンリストから、目的のセキュリティ証明書を選択してください。新しいセキュリティ証明書を作成し、このリストに表示させる使い方については、「[**SSL 証明書の管理」**](/landing/ras-admin-guide/v22-ja-jp/ssl-no.md)の章を参照してください。 ### **APIトークン** APIトークンを使用するには、APIリクエストを行う際にHTTPのAuthorizationヘッダーの値を設定してください。 「**APIを有効にする**」オプションを選択すると、**APIトークン文字列**が生成されます。「\*\*再書き込みする」\*\*を選択すると、新しいAPIトークン文字列が発行されます。 ### **データ暗号化証明書** 選択された暗号化セキュリティ証明書は、バックエンドコンポーネント間で実行時データを生成する際、Connection Broker API によって使用されます。 これを設定するには、「**Farm**」＞「**Site**」＞「**Connection Brokers**」の順に移動し、「**API**」Tabを選択します（このTabが表示されていない場合は、\*\*「Enable API」\*\*が選択されていないことを示しています）。 \*\*「自動」\*\*が選択されている場合、サイト証明書のデフォルトの使用方法が適用されます。このリストには、選択されたプロパティ`Third-Party Encryption`で提供される証明書が表示されます。 新しい SSL 証明書を作成し、このリストに表示させる方法については、「[**SSL 証明書の管理」**](/landing/ras-admin-guide/v22-ja-jp/ssl-no.md)のチャプターを参照してください。 ### **接続制限** 接続制限は、過度なリクエストや乱用の結果引き起こされるリソースの枯渇から、コネクションブローカーを保護します。制限がなければ、コネクションブローカーは、悪意のあるものや偶発的なものを問わず、大量のリクエストを受け入れてしまう可能性があります。その結果、CPU、メモリ、スレッドが過剰に実行され、コネクションブローカーが応答しなくなる恐れがあります。 接続制限は、全体として有効または無効に設定できるほか、以下の各接続の種類ごとに個別に設定することも可能です。 制限値を設定すると、そのタイプに対する強制適用が無効`0`になります。特定のタイプの新しい接続が設定された制限値を超える場合、コネクションブローカーはその接続を拒否しますが、既存の接続には影響しません。
接続の種類説明
接続ブローカー APIコネクションブローカーへの外部APIセッションリクエスト — 認証、セッション列挙、およびトンネリングネゴシエーション。
バックエンドConnection Broker とその他 RAS インフラストラクチャ サービス間の内部コンポーネント間通信。クライアント向けではない。
All Connections両方の接続の種類を合わせた全体の上限。
クライアント コンピューター IP ごとに1つのクライアントIPアドレスから許可される最大接続数。
タイムアウト。制限を超えたクライアントが、再度接続を許可されるまでのブロック時間（分単位）。デフォルトは30分です。
#### **適用除外** 「クライアントごとのIP」によって決してブロックされないようにすべきクライアントのIP アドレスまたはIP 範囲（CIDR表記に対応）のリストを管理できます。例えば、Secure GatewayやConnection Brokerなどの他のParallels RASコンポーネント、監視システム、または内部のロードバランサーなどがこれにあたります。 除外されたIP アドレスはファイアウォールによってブロックされることはありませんが、接続の種類および「すべての接続」の制限数にはカウントされます。 #### **前提条件** クライアントごとのIPブロックを行うには、コネクションブローカーをホストするサーバーでWindowsファイアウォールが有効になっている必要があります。Windowsファイアウォールが無効になっている場合、RASは警告を記録し、クライアントをブロックする代わりに、余分な接続を単に切断します。 各タイプごとの現在のアクティブな接続数を確認するには、Parallels RAS コンソールで \[**情報]** > **\[サイト]** に移動してください。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.parallels.com/landing/ras-admin-guide/v22-ja-jp/ras-connection-broker/enabling-connection-broker-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.