# Настройка Шлюз данных Qlik — прямой доступ на сервере Windows В этом разделе описано, как настроить Шлюз данных Qlik — прямой доступ на сервере Windows. В нем приведены необходимые условия и инструкции по установке, а также описаны ограничения и соображения, которые следует учитывать при работе с Шлюз данных Qlik — прямой доступ на сервере Windows. ## Рекомендации по использованию Шлюз данных Qlik — прямой доступ Для успешной работы с Шлюз данных Qlik — прямой доступ настоятельно рекомендуется придерживаться следующих рекомендаций: * Не используйте один и тот же шлюз Direct Access Gateway для разработки, тестирования принятия пользователями и для производственной среды, так как это увеличивает риск перегрузки доступных ресурсов и ставит под угрозу стабильность системы. С точки зрения деятельности предприятия, недостаточные ресурсы вкупе со снижением стабильности могут привести к задержке обновлений производственных данных приложения. * Чтобы обеспечить оптимальную производительность, установите шлюз Direct Access Gateway на сервер, расположенный ближе всего к источнику данных. * Direct Access Gateway следует установить на выделенном сервере Windows, как описано в системных требованиях ниже. Не устанавливайте ПО шлюза на действующем сервере базы данных или на одном компьютере с другими продуктами Qlik, включая, помимо прочего, Qlik DataTransfer, Qlik Sense Desktop и Qlik Sense Enterprise. ## Предварительные требования к системе В этом разделе описаны требования к программному обеспечению, портам и аппаратному обеспечению для использования Шлюз данных Qlik — прямой доступ на сервере Windows. ### Предварительные требования к программному обеспечению * Шлюз прямого доступа должен быть установлен в системе Windows Server, защищенной брандмауэром. Этот сервер должен иметь доступ к источнику данных. Поддерживаемые версии Windows Server: * 2016 * 2019 * 2022 * 2025 Для Windows Server 2025 требуется Шлюз данных Qlik — прямой доступ 1.7.0 или более поздняя версия. * Необходимо установить три разные версии .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) (последнее исправление) Примечание к информации * Установка более поздних версий среды выполнения .NET, чем 8.0.x, не поддерживается. * Для работы Direct Access Gateway 1.6.6 требуются обе версии сред выполнения .NET Core Runtime и ASP.NET Core Runtime: 6.0.x и 8.0.x. Для получения инструкций по проверке установленной версии .NET см. [https://docs.microsoft.com/ru-ru/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed](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 * Установите SAP NetWeaver RFC SDK на компьютере Шлюз данных Qlik — прямой доступ, как описано в документе [Установка SAP NetWeaver RFC SDK для службы Qlik Data Gateway ― Direct Access](https://help.qlik.com/en-US/cloud-services/Subsystems/SAP_Connectors_Help/Content/Connectors_SAP/Installation/Installing-sap-connectors-for-direct-access-gw.htm) (только английский язык). * Установите Microsoft Visual C++ 2013 Redistributable (x64) на компьютере Шлюз данных Qlik — прямой доступ. ### Необходимые порты и протоколы Сведения о необходимых портах и протоколах см. в [Необходимые порты и протоколы](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Ports). ### Рекомендуемое оборудование * 8 ядер * 32 ГБ ОЗУ * 5 ГБ ПЗУ #### Минимальное оборудование Минимальное оборудование подходит только для определенных сценариев с развертыванием небольших выделенных серверов (разработка, тестирование и производство), используемых для постоянных небольших объемов данных с ограниченным количеством одновременных перезагрузок. * 4 ядра * 8 ГБ ОЗУ * 5 ГБ ПЗУ Может потребоваться больше ресурсов для последовательной обработки растущих объемов данных и большего количества одновременных перезагрузок. Точка, в которой производительность становится неприемлемой, зависит от конкретного случая использования и конфигурации в каждой уникальной среде. ### Криптография системы Qlik Cloud для правительства поддерживает использование Qlik Data Gateway - Direct Access, только когда настроено выполнение Windows в режиме работы, утвержденном FIPS 140-2 (режим FIPS). Чтобы включить режим FIPS, включите политику Windows. [Криптография системы. Используйте совместимые с FIPS алгоритмы для шифрования, хэширования или подпиcывания](https://learn.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/system-cryptography-use-fips-compliant-algorithms-for-encryption-hashing-and-signing). Для получения дополнительной информации см. шаг 3 процедуры [Использование Windows в режиме работы, утвержденном FIPS 140-2](https://learn.microsoft.com/en-us/windows/security/threat-protection/fips-140-validation#using-windows-in-a-fips-140-2-approved-mode-of-operation). Примечание к информацииУстановка дополнительных модулей не требуется. 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 обеспечивают использование только проверенных FIPS криптографических алгоритмов через среду выполнения .NET Runtime. ## Установка Шлюз данных Qlik — прямой доступ Настройка Direct Access Gateway подразумевает процедуры, которые необходимо выполнить как в центре активности Администрирование, так и на сервере Direct Access Gateway. Примечание к информацииДля процедур шлюза данных, которые необходимо выполнить в центре активности Администрирование, требуются права администратора клиента. Шаги по настройке Шлюз данных Qlik — прямой доступ — установка на сервер Windows Шаги по настройке Шлюз данных Qlik — прямой доступ — установка на сервер Windows Шаги по настройке Шлюз данных Qlik — прямой доступШлюз данных Qlik — прямой доступ — установка на сервер WindowsWindows ![Блок-схема шагов настройки шлюза прямого доступа для установки на сервере Windows.](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/direct-access-gateway_setup.png) ### Этап 1. Загрузка Шлюз данных Qlik — прямой доступ 1. В центре активности Администрирование выберите Шлюзы данных. Все существующие шлюзы данных будут перечислены в [таблице, где отображается базовая информация о каждом шлюзе](https://help.qlik.com/ru-RU/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 Redistributable (x64), если обнаружит, что он еще не установлен. Примечание к информации * Во время настройки можно при необходимости изменить следующие стандартные настройки: * Путь установки(C:\Program Files\Qlik\ConnectorAgent). * Учетная запись службы Windows, в которой будет установлен шлюз Direct Access Gateway (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/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software) до запуска установки без взаимодействия с пользователем, так как в отличие от интерактивной установки, это не удастся сделать в процессе установки. Установка и обновление Direct Access Gateway Откройте командную строку от лица администратора и выполните следующую команду из папки, содержащей исполняемый файл Direct Access Gateway: qlik-data-gateway-direct-access.exe /S InstallPath="full-path" AcceptEula=yes Где full-path следует заменить на фактический путь установки в кавычках, например "C:\TMP\Qlik". Примечание к информацииНеобходимо задать параметру AcceptEula значение «да». Выбирая значение «да» для параметра AcceptEula, вы принимаете условия и положения [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 Откройте командную строку от лица администратора и выполните следующую команду из папки, содержащей исполняемый файл Direct Access Gateway: qlik-data-gateway-direct-access.exe /S /uninstall #### Устранение неполадок в процессе установки Файлы журнала установки могут быть полезны для устранения неполадок с установкой или обновлением: Начиная с Direct Access Gateway 1.7.7, полный путь к файлам журнала: <Direct Access Gateway папка установки>\data\logs\Шлюз данных Qlik — прямой доступ\_<МеткаВремени>.log Если ваша Direct Access Gateway версия старше 1.7.7, полный путь к файлам журнала: C:\Users\<user>\AppData\Local\Temp\Шлюз данных Qlik — прямой доступ\_<Timestamp>.log ### Этап 3: Настройка Direct Access Gateway Подробные инструкции по настройке см. в [Этап 3: настройка Direct Access Gateway](https://help.qlik.com/ru-RU/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/ru-RU/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 для автоматической регистрации шлюза в настоящее время недоступен. Предварительные требования Ключ API с правами администратора клиента для создания клиентов OAuth и управления ими. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)Регистрация шлюза с помощью автоматической регистрации 1. Сгенерируйте ключ JSON Web Key (JWK) на машине Direct Access Gateway. Эта команда создает закрытые ключи на машине Direct Access Gateway: ConnectorAgent.exe qcs generate\_jwk 2. Скопируйте возвращенный командой ключ JWK. 3. Используя ключ API, создайте OAuth-клиент для шлюза через API администратора клиента, указав 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. 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. Получить пространство Шлюза прямого доступа. curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>' 13. Скопируйте идентификатор пространства Direct Access Gateway. 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/ru-RU/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. Скопируйте идентификатор бота. 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. Скопируйте идентификатор роли. 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. Запуск службы Шлюз данных Qlik — прямой доступ на сервере Direct Access Gateway На сервере шлюза прямого доступа выполните одно из следующих действий, чтобы запустить службу. * Откройте консоль «Службы Windows» и Запустите сервис Шлюз данных Qlik — прямой доступ. * Откройте командную строку от имени администратора и измените рабочий каталог на вложенную папку ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent при установке по умолчанию). Затем выполните следующую команду: connectoragent service start Появится подтверждение, что служба запущена успешно. См. также: [Запуск службы с использованием другой учетной записи](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Running) ### Этап 6. Добавление подключения к источнику данных См. [Этап 6. Добавление подключения к источнику данных](https://help.qlik.com/ru-RU/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 — прямой доступ](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm) * [Настройка Шлюз данных Qlik — прямой доступ в контейнере](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm)