# Windows サーバーで Qlik Data Gateway - 直接アクセス を設定する このトピックでは、Windows サーバーで Qlik Data Gateway - 直接アクセス を設定する方法について説明します。前提条件とインストール手順を提供し、Windows サーバーで Qlik Data Gateway - 直接アクセス を使用する際に注意が必要な制限事項と考慮事項について説明します。 ## Qlik Data Gateway - 直接アクセス を使用するときのベスト プラクティス Qlik Data Gateway - 直接アクセス を適切に使用するには、次のベスト プラクティスに従うことを強くお勧めします。 * 開発、ユーザー受け入れテスト、実稼働に同じ Direct Access gateway を使用しないでください。使用可能なリソースが過負荷になり、システムの安定性に影響を与えるリスクが高まります。ビジネスの観点から見ると、リソース不足と安定性の低下が組み合わさり、実稼働アプリケーション データの更新が遅れる可能性があります。 * 最適なパフォーマンスを得るには、データ ソースにできるだけ近いサーバーに Direct Access gateway をインストールしてください。 * Direct Access gateway は、下記のシステム要件に規定された専用の Window Server にインストールする必要があります。実際のデータベース サーバーへのインストール、または他の Qlik 製品 (Qlik DataTransfer、Qlik Sense Desktop、Qlik Sense Enterpriseなど) との同時インストールはしないでください。 ## システム前提条件 このセクションでは、Windows サーバーで Qlik Data Gateway - 直接アクセス を使用するためのソフトウェア、ポート、ハードウェアの必要条件について説明します。 ### ソフトウェア前提条件 * Direct Access ゲートウェイは、ファイアウォールの内側の Windows Server マシンにインストールする必要があります。サーバーは、データ ソースにアクセスできる必要があります。 サポートされている Windows Server のエディション: * 2016 * 2019 * 2022 * 2025 Windows Server 2025 には Qlik Data Gateway - 直接アクセス 1.7.0 以降が必要です。 * 3 つの異なる .NET バージョンをインストールする必要があります。次の .NET バージョンのみをインストールします。 * .NET 4.8: インストールに必要です。 * .NET 6.0.x Runtime (x64) および ASP.NET Core Runtime 6.0.x (x64) (最新のパッチ) ニュース メモDirect Access gateway 1.6.8から、.NET 6.0.x は必須ではなくなりました。 * .NET 8.0.x Runtime (x64) および ASP.NET Core Runtime 8.0.x (x64) (最新のパッチ) 情報メモ * 8.0.x より新しい .NET ランタイム バージョンのインストールはサポートされていません。 * Direct Access gateway 1.6.6 および 1.6.7 には、.NET および ASP.NET Core Runtimes のバージョン 6.0.x と 8.0.x の両方が必要です。 現在インストール済みの .NET バージョンを検証する方法については、https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed を参照してください。 * Microsoft Visual C++ 2015-2022 再頒布可能パッケージ (x64).Direct Access gateway のセットアップで、再頒布可能パッケージがインストール済みでない場合は、インストールするようプロンプトが表示されます。 #### SAP データ ソースを使用する場合の追加ソフトウェア前提条件 * [Qlik Data Gateway - 直接アクセス用 SAP NetWeaver RFC SDK のインストール](https://help.qlik.com/en-US/cloud-services/Subsystems/SAP_Connectors_Help/Content/Connectors_SAP/Installation/Installing-sap-connectors-for-direct-access-gw.htm) (英語のみ) に説明されているように Qlik Data Gateway - 直接アクセス マシンに SAP NetWeaver RFC SDK をインストールします。 * Qlik Data Gateway - 直接アクセス マシンに Microsoft Visual C++ 2013 再頒布可能パッケージ (x64) をインストールします。 ### 必要なポートとプロトコル 必要なポートとプロトコルについては、[必要なポートとプロトコル](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Ports) を参照してください。 ### 推奨ハードウェア * 8 コア * 32 GB メモリ * 5 GB ストレージ #### 最小ハードウェア 最小ハードウェアは、小規模な専用サーバー展開 (開発、テスト、または運用) を使用し、継続的にデータ量が少なく、同時リロードの数が制限されている特定のシナリオにのみ適しています。 * 4 コア * 8 GB メモリ * 5 GB ストレージ 増大するデータ量の一貫した処理と、より多くの同時リロードに対応するためには、より多くのリソースが必要になる場合があります。パフォーマンスが許容できなくなるポイントは、それぞれの環境におけるユース ケースと構成に応じて異なります。 ### システム暗号化 Qlik Cloud Government は、Windows が FIPS 140-2 承認済み動作モード (FIPS モード) で実行するように構成されている場合にのみ、Qlik Data Gateway - Direct Access の使用をサポートします。FIPS モードをオンにするには、次の Windows ポリシーを有効にします。[システム暗号化: 暗号化、ハッシュ、署名には FIPS に準拠したアルゴリズムを使用します](https://learn.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/system-cryptography-use-fips-compliant-algorithms-for-encryption-hashing-and-signing)。詳細については、「[FIPS 140-2 承認済み動作モードでの Windows の使用](https://learn.microsoft.com/en-us/windows/security/threat-protection/fips-140-validation#using-windows-in-a-fips-140-2-approved-mode-of-operation)」の手順 3 を参照してください。 情報メモ追加のモジュールをインストールする必要はありません 。Qlik Data Gateway - Direct Access は、Windows によって既に提供され、[検証済みモジュールのリスト](https://learn.microsoft.com/en-us/windows/security/threat-protection/fips-140-validation#microsoft-fips-140-2-validated-cryptographic-modules)に含まれているモジュールのみを使用します。Qlik Data Gateway - Direct Access は、.NET ランタイムを通じて、FIPS 検証済み暗号化アルゴリズムのみの使用を強制します。 ## Qlik Data Gateway - 直接アクセス のインストール Direct Access gateway のセットアップには、管理 アクティビティ センターおよび Direct Access gateway サーバーの両方で実行が必要な手順が含まれます。 情報メモ管理 アクティビティ センターで実行が必要なデータ ゲートウェイ手順には、テナント管理者の権限が必要です。 Qlik Data Gateway - 直接アクセス 設定手順 — Windows サーバーへのインストール Qlik Data Gateway - 直接アクセス 設定手順 — Windows サーバーへのインストール Qlik Data Gateway - 直接アクセスQlik Data Gateway - 直接アクセス 設定手順 — WindowsWindows サーバーへのインストール ![Direct Access gateway フロー図 - Windows サーバーでの設定のステップ。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/direct-access-gateway_setup.png) ### ステージ 1: Qlik Data Gateway - 直接アクセス をダウンロードする 1. 管理 アクティビティ センターで、データ ゲートウェイ を選択します。 既存のデータ ゲートウェイがある場合、[各ゲートウェイに関する基本情報を表示するテーブル](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing-console.htm#gateprop)にリストされます。 2. [展開] ツール バー ボタンをクリックします。 [データ ゲートウェイの展開] ダイアログが開きます。 3. データ ゲートウェイ - 直接アクセス (Windows)を選択し、 Qlik 顧客契約に同意して、 [ダウンロード] をクリックします。Direct Access gateway セットアップ ファイル (qlik-data-gateway-direct-access.exe) が、マシンにダウンロードされます。 ### ステージ 2: データ ソースを保護するファイアウォールの背後にあるサーバーに Direct Access gateway をインストールする このステージには Direct Access gateway のインストールが含まれます。Direct Access gateway はインタラクティブまたはサイレントの形式でインストールできます。 情報メモDirect Access gateway をアンインストールしても、構成設定は削除されません。言い換えれば、あるバージョンの Direct Access gateway をアンインストールしてから別のバージョンをインストールすると、新しくインストールされたバージョンはアンインストールされたバージョンと同じ設定を使用します。 情報メモ既定の Windows サービス アカウントを上書きするには、Direct Access gateway 1.7.4 以降が必要です。 #### Direct Access gateway のインタラクティブなインストール 1. ダウンロードが完了したら、セットアップ ファイルをファイアウォールの後ろの Windows Server マシンにコピーします。マシンがデータ ソースと通信していることを確認します。 2. qlik-data-gateway-direct-access.exe ファイルを開き、セットアップ ウィザードを起動します。 情報メモ * Direct Access gateway には Microsoft .NET 6.x および .NET 8.x が必要です。セットアップで前のバージョンがインストールされていることが検出されると、必要なバージョンをインストールするようプロンプト表示されます。.NET のインストールが完了したら、Direct Access gateway マシンを再起動し、Direct Access gateway セットアップを再度実行する必要があります。 * セットアップで現在インストールされていないことが検出されると、Microsoft Visual C++ 2015-2022 再頒布可能パッケージ (x64) をインストールするようプロンプトが表示されます。 情報メモ * セットアップ中に、オプションで次の既定を上書きできます。 * インストール パス (C:\Program Files\Qlik\ConnectorAgent)。 * Direct Access gateway がインストールされる Windows サービス アカウント (LocalSystem)。指定されたサービス アカウントには、Direct Access gateway インストール フォルダーの「サービスとしてログオン」権限および「書き込み」権限の両方が必要です。 3. 設定が完了するまで、[次へ] をクリックし続けます。 #### Direct Access gateway のサイレントなインストール、アップグレード、およびアンインストール 情報メモDirect Access gateway 1.6.4 以降でサポートされています。 例えば、組織全体で複数のマシンに Direct Access gateway をインストールする必要がある場合などには、Direct Access gateway のサイレントなインストールが便利です。必要に応じて、既定の Windows サービス アカウント (LocalSystem) を上書きすることもできます。 前提条件 サイレント インストールを開始する前に、[前提条件のソフトウェア](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software)すべての正しいバージョンをインストールしてください。インタラクティブ インストールとは異なり、サイレント インストール中にこの操作はできないからです。 Direct Access gateway のインストールとアップグレード 管理者として CMD プロンプトを開き、Direct Access gateway 実行可能ファイルが含まれているフォルダーから以下のコマンドを実行します。 qlik-data-gateway-direct-access.exe /S InstallPath="full-path" AcceptEula=yes full-path は、引用符内の実際のインストール パス (例: "C:\TMP\Qlik") と置き換える必要があります。 情報メモAcceptEula パラメーターを「yes」に設定することが必要です。AcceptEula パラメーターを「yes」に設定すると、[Qlik 顧客契約](https://www.qlik.com/us/legal/legal-agreements)の条件に同意したことになります。 既定の Windows サービス アカウントを上書きする 既定では、Direct Access gateway は LocalSystem Windows サービス アカウントにインストールされます。 別のアカウントで Direct Access gateway をインストールするには、コマンドに次のパラメーターを含めます。 * ServiceAccount: サービス アカウント名。 情報メモ指定されたサービス アカウントには、Direct Access gateway インストール フォルダーの「サービスとしてログオン」権限および「書き込み」権限の両方が必要です。 * ServicePassword: 指定されたサービス アカウントのパスワード。 Windows サービス アカウントを上書きするための、パラメーター付きのサンプル コマンド qlik-data-gateway-direct-access.exe /S InstallPath="C:\TMP\Qlik" AcceptEula=yes ServiceAccount="qliktech.com\user" ServicePassword=kZmbkb8m8BGGz91 Direct Access gateway のアンインストール 管理者として CMD プロンプトを開き、Direct Access gateway 実行可能ファイルが含まれているフォルダーから以下のコマンドを実行します。 qlik-data-gateway-direct-access.exe /S /uninstall #### インストールのトラブルシューティング インストール ログ ファイルは、インストールやアップグレードに関する問題のトラブルシューティングに役立ちます。 Direct Access gateway 1.7.7 以降、ログ ファイルへの完全なパスは次のとおりです。 <Direct Access gateway installation folder>\data\logs\Qlik Data Gateway - 直接アクセス\_<Timestamp>.log Direct Access gateway バージョンが 1.7.7 より前の場合、ログ ファイルへの完全なパスは次のとおりです。 C:\Users\<user>\AppData\Local\Temp\Qlik Data Gateway - 直接アクセス\_<Timestamp>.log ### ステージ 3: Direct Access gateway を設定する 詳細な設定手順については、「[ステージ 3: Direct Access gateway のセットアップ](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage3)」を参照してください。 ### ステージ 4: データ ゲートウェイを登録する 次のステップでは、データ ゲートウェイを登録します。 これは、管理 アクティビティ センターから、またはコマンド ラインで実行できます。 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm) #### オプション 1: 管理 アクティビティ センター経由 管理 アクティビティ センターを使用して、ゲートウェイを登録できます。「[オプション 1: 管理 アクティビティセンター経由](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#StageConsole)」を参照してください。 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm) #### オプション 2: コマンド ラインを使用した自動登録 管理 アクティビティ センターを使用せずに、コマンド ラインから Direct Access gateway を自動的に登録することもできます。このメソッドは、OAuth クライアントから生成された有効期間の短いセッション トークンを使用します。 情報メモ自動登録はコマンド ラインからのみサポートされています。ゲートウェイの自動登録用の REST API は、現在利用できません。 前提条件 OAuth クライアントを作成および管理するためのテナント管理者権限を持つ API キー。 [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)自動登録によるゲートウェイの登録 1. Direct Access gateway マシンで JSON Web Key (JWK) を生成します。このコマンドにより、Direct Access gateway マシン上に秘密キーが作成されます。 ConnectorAgent.exe qcs generate\_jwk 2. コマンドによって返された JWK をコピーします。 3. API キーを使用して、テナント管理 API 経由でゲートウェイ用の OAuth クライアントを作成し、前のステップでコピーした JWK を指定します。 curl "https://<tenant-url>/api/v1/oauth-clients" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <api-key>' -d '{"appType":"web","clientName":"<client-name>","description":"","allowedScopes":["admin.direct-access-gateways:register\_gateway","admin.direct-access-gateways:delete\_gateway"],"allowedAuthMethods":["private\_key\_jwt"],"publicKeys":[<jwk>],"allowedGrantTypes":["client\_credentials"]}' 4. 応答で返された client\_id の値をコピーします。 5. OAuth クライアントの同意方法を信頼済みに設定します。 curl "https://<tenant-url>/api/v1/oauth-clients/<client-id>/connection-configs/me" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <api-key>' -d '[{"op":"replace","path":"/consentMethod","value":"trusted"}]' 6. Direct Access gateway マシンで登録アサーションを作成します。 ConnectorAgent.exe qcs generate\_registration\_assertion --tenant\_url <tenant-url> --client-id <client-id> 7. アクセス トークンをリクエストします。これにより、ゲートウェイで使用されるボット ユーザー アカウントの自動作成もトリガーされます。 curl "https://<tenant-url>/oauth/token" -X POST -H 'content-type: application/x-www-form-urlencoded' -d "grant\_type=client\_credentials" -d "client\_id=<client-id>" -d "client\_assertion\_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer" -d "client\_assertion=<assertion>" -d "scope=admin.direct-access-gateways:register\_gateway admin.direct-access-gateways:delete\_gateway" 8. 自動作成されたボット ユーザーを検索します。 curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>' 9. my-bot-client の ID をコピーします。 10. 「DAG Registration」 ロールを作成します。 curl "https://<tenant-url>/api/v1/roles" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer API-key' -d '{"name":"DAG Registration","description":"Role for registering a gateway","assignedScopes":["admin.direct-access-gateways:register\_gateway", "admin.direct-access-gateways:delete\_gateway"]}' 11. ボット ユーザーにテナントレベルのロールを割り当てます。 curl "https://<tenant-url>/api/v1/users/<bot-user-ID>" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d ' [ { "op": "replace", "path": "/assignedRoles", "value": [ { "name": "DAG Registration" } ] } ]' 12. Direct Access Gateway のスペースを取得します。 curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>' 13. Direct Access Gateway のスペース ID をコピーします。 14. ボット ユーザーを [編集可能] 権限でスペースに追加します。 curl "https://<tenant-url>/api/v1/spaces/<DAG-space-ID>/assignments" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d '{"assigneeId": "<Bot-user-ID>","roles": ["consumer","dataconsumer","producer"], "type": "user"}' 15. 既存のアサーションの有効期限が切れている場合は、新しいアサーションを生成してください。 ConnectorAgent.exe qcs generate\_registration\_assertion --tenant\_url <tenant-url> --client-id <client-ID> 16. ゲートウェイを登録します。 ConnectorAgent.exe qcs register\_gateway --tenant\_url <tenant-url> --gateway\_name <gateway-name> --gateway\_description <gateway-description> --space\_name <space-name> --client-id <client-ID> --assertion <assertion> [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)自動登録されたゲートウェイの削除 上記で説明したセッション トークンベースの自動方式を使用して登録されたゲートウェイの登録を解除するには、次のステップを実行します。これらのステップを実行すると、作成された OAuth クライアント、ボットユーザー、ロールも削除されます。 1. [セッション トークンを使用した自動ゲートウェイ登録のステップ 6](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#AutoRegister) の説明に従って、アサーションを生成します。 2. ゲートウェイを削除します: ConnectorAgent.exe qcs delete\_gateway --tenant\_url <tenant-url> --gateway\_name <gateway-name> --client-id <client-ID> --assertion <assertion> 3. JWK を削除します。 ConnectorAgent.exe qcs delete\_jwk 4. ゲートウェイ用に作成されたボット ユーザー アカウントを検索します。 curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>' 5. ボット ID をコピーします。 6. このボット ユーザー アカウントを削除します。 curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>" 7. ゲートウェイ用に作成された「DAG Registration」ロールを検索します。 curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name eq \"DAG Registration\")" -H "Authorization: Bearer <api-key>" 8. ロール ID をコピーします。 9. このロールを削除します。 curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID>" -H "Authorization: Bearer <api-key>" 10. OAuth クライアントを削除します。 curl -X DELETE "https://<tenant-url>/api/v1/oauth-clients/<client-ID>" -H "qlik-confirm-delete: <client-ID>" -H "Authorization: Bearer <api-key>" ### ステージ 5: Direct Access gateway サーバーで Qlik Data Gateway - 直接アクセス サービスを起動する Direct Access ゲートウェイ サーバーで、次のいずれかを実行してサービスを起動します。 * Windows Services コンソールを開いて、Qlik Data Gateway - 直接アクセス サービスを起動します。 * 管理者として、コマンド プロンプトを開いて、ConnectorAgent サブフォルダーの作業ディレクトリ (デフォルト インストールでは C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) を変更します。次に、下記のコマンドを実行します。 connectoragent service start サービスが正常に起動したことを伝える確認メッセージが表示されます。 関連項目: [異なるアカウントでサービスを実行する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Running) ### ステージ 6: データ ソースに接続を追加する 「[ステージ 6: データ ソースに接続を追加する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage6)」を参照してください。 ## サポートされているデータ ソース Windows サーバーのインストールでは、次の ODBC コネクタがサポートされています。 * ODBC ソース。詳細については、「[ODBC データベース - Qlik Cloud](https://help.qlik.com/en-US/cloud-services/Subsystems/ODBC_Connector_help/Content/Connectors_ODBC/Introduction/ODBC-connector.htm) (英語のみ)」を参照してください。 * REST ソース。詳細については、「[REST ソース ‒ Qlik Cloud](https://help.qlik.com/en-US/cloud-services/Subsystems/REST_Connector_help/Content/Connectors_REST/REST-connector.htm) (英語のみ)」を参照してください。 * SAP BW、SAP SQL、および SAP ODP ソース。Direct Access gateway 1.2.0 以降が必要です。 これらのソースへの接続設定方法については、[SAP NetWeaver](https://help.qlik.com/en-US/cloud-services/Subsystems/SAP_Connectors_Help/Content/Connectors_SAP/SAP-SQL-connector.htm) (英語のみ) を参照してください。 ## 詳細を見る * [Qlik Data Gateway - 直接アクセス の設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm) * [コンテナ内で Qlik Data Gateway - 直接アクセス を設定する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm)