# Настройка Шлюз данных Qlik — прямой доступ

Вы можете настроить Шлюз данных Qlik — прямой доступ либо на сервере Windows, либо в контейнеризированной среде. Для успешной настройки убедитесь, что вы ознакомились с предварительными требованиями, инструкциями по установке, ограничениями и особенностями вашего конкретного сценария настройки.

Примечание к информации

Информацию о шаблоне AWS PrivateLink для Шлюз данных Qlik — прямой доступ см. в [Настройка AWS PrivateLink для Шлюз данных Qlik — прямой доступ](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-aws-privatelink.htm). Этот шаблон не заменяет стандартные предварительные требования и требования к сети, описанные в этом разделе.

## Настройка рабочих процессов

Выберите один из следующих рабочих процессов:

* [Настройка Шлюз данных Qlik — прямой доступ на сервере Windows](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)
* [Настройка Шлюз данных Qlik — прямой доступ в контейнере](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm)

## Предварительные требования к системе

### Требования к программному обеспечению

См. один из следующих разделов в зависимости от способа настройки:

* WindowsСервер[Предварительные требования к программному обеспечению](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software):

* Контейнеризировано: [Требования к программному обеспечению](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#SoftwareReq)

### Общие требования

Эти требования применимы как к серверным установкам Windows, так и к контейнеризированным установкам.

#### Необходимые порты и протоколы

В следующем разделе перечислены необходимые порты.

#### Исходящие порты

HTTPS/TCP-443 необходимо открыть для исходящей связи с <tenant-id>.<region>.qlikcloud.com.

#### Внутренние порты

Ниже приводится список портов, используемых для связи внутренними процессами шлюза данных. Если какие-либо порты используются другим приложением, измените конфигурацию другого приложения или удалите его.

Общие порты

* 5050 (коннектор Agent REST API)
* 9027 (DCAAS REST API)

Порты ODBC

* 3005 (коннектор ODBC REST API)
* 50260 (коннектор ODBC gRPC)

Порты SAP

* 3015 (API-интерфейс REST коннектора SAP BW)

* 50270 (gRPC коннектора SAP BW)

* 3025 (API-интерфейс REST коннектора SAP SQL)

* 50280 (gRPC коннектора SAP SQL)

* 3035 (API-интерфейс REST коннектора SAP ODP)

* 50290 (gRPC коннектора SAP ODP)

* 3035 (API-интерфейс REST коннектора SAP Package)

* 50290 (gRPC коннектора SAP Package)

Порты REST

* 3055 (API REST коннектора REST)
* 50310 (gRPC коннектора REST)

Порты коннектора File

* 3045 (API REST коннектора File)
* 50300 (gRPC коннектора File)

#### Протокол WSS

Помимо HTTPS шлюз прямого доступа также использует протокол WSS (WebSocket Secure). Поэтому в настройках брандмауэра и прокси-сервера (если планируется его использовать) необходимо разрешить исходящие соединения WSS.

### Рекомендованное оборудование

См. один из следующих разделов в зависимости от способа настройки:

* WindowsСервер[Рекомендуемое оборудование](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#RecHardware):

* Контейнеризировано: [Рекомендуемое оборудование](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#RecHardware)

### Системная криптография (только для установки сервера Windows)

См. [Криптография системы](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#System).

## Установка Шлюз данных Qlik — прямой доступ

### Этап 1: Скачать Шлюз данных Qlik — прямой доступ

См. один из следующих разделов в зависимости от способа настройки:

* WindowsСервер[Этап 1. Загрузка Шлюз данных Qlik — прямой доступ](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage5):

* Контейнеризировано: [Этап 1. Загрузка Шлюз данных Qlik — прямой доступ](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage1)

### Этап два: установить или развернуть Direct Access Gateway

См. один из следующих разделов в зависимости от способа настройки:

* WindowsСервер[Этап 2. Установка Direct Access Gateway на сервер за брандмауэром, защищающим источники данных](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage4):

* Контейнеризировано: [Этап 2: запустите развертывание, запустив файл Docker Compose](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage2)

### Этап 3: настройка Direct Access Gateway

На этом этапе выполняется настройка URL-адреса клиента Qlik Cloud и, при необходимости, настройка прокси-сервера, а также создание регистрационного ключа. Потребуется скопировать ключ в настройки шлюза данных в центре активности Администрирование (на этапе 3 ниже). Ключ используется для установки подключения между шлюзом прямого доступа и клиентом Qlik Cloud с проверкой подлинности.

Примечание к информации

Подключение к Qlik анонимному клиенту (регион Швеция) не поддерживается.

Начиная с Direct Access Gateway 1.7.16, теперь поддерживается регион Канада. Выберите регион Канада во время развертывания в центре действий Администрирование при развертывании установочного файла шлюза.

На компьютере Direct Access gateway выполните одно из следующих действий в зависимости от вашего процесса установки:

* Windows сервер: откройте командную строку от имени администратора и перейдите в подпапку ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent при установке по умолчанию).

* В контейнере: откройте консоль внутри контейнера direct-access-agent.

Затем переходите к следующим действиям.

#### Настройка клиента Qlik Cloud

Задайте, к какому клиенту Qlik Cloud необходимо подключаться. Чтобы подключаться к клиенту через прокси-сервер, добавьте соответствующие параметры в команду, как показано ниже.

Команды для настройки клиента Qlik Cloud без прокси-сервера:

* Windows установка сервера

  * Синтаксис:connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url

  * Пример: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

* Контейнеризированная установка

  * Синтаксис:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url

  * Пример: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

Команды для настройки клиента Qlik Cloud с прокси-сервером:

* Windows установка сервера

  * Синтаксис:connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password

  * Пример: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

* Контейнеризированная установка

  * Синтаксис:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password

  * Пример: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

Для получения информации об ограничениях использования прокси-сервера см. [Подключение к Qlik Cloud через прокси-сервер](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Connecti).

#### Настройка пакета ЦС

Пакет ЦС проверяет подлинность удостоверения клиента Qlik Cloud, тем самым обеспечивая доверенное подключение.

Кому требуется настраивать пакет СЦ?

Пакет ЦС необходимо настраивать, только если вы:

* Клиент Qlik Cloud для правительства
* Коммерческий клиент Qlik Cloud, использующий устройства обеспечения безопасности, которые выступают в роли прокси и заменяют информацию сертификата, полученную из Интернета, на собственные корневые сертификаты ЦС

Какой пакет следует использовать?

Клиентам следует использовать пакет ЦС Qlik или получить собственный пакет ЦС следующим образом:

* Qlik предоставляет объединить в пакет CA: Следует использовать клиентам Qlik Cloud для правительства, у которых стандартная среда. Под стандартной понимается среда, в которой не используется устройство обеспечения безопасности, которое выполняет функцию прокси и заменяет информацию сертификата, полученную из Интернета, на собственные корневые сертификаты ЦС.

  В установке Direct Access Gateway по умолчанию файл пакета ЦС находится в следующем местоположении:

  * Windows установка на сервере: C:\Program Files\Qlik\ConnectorAgent\caBundle\qcg\_ca\_bundle.pem

  * Контейнерная установка: /usr/share/Qlik/Gateway/ssl/qcg\_ca\_bundle.pem

  Примечание к информацииФайл пакета ЦС можно переименовать, но при этом необходимо сохранить расширение .pem (например, qlikcerts.pem). Затем выполняются команды, описанные ниже.

* Клиенты предоставляют собственный объединить в пакет CA: Следует использовать, если среда клиента использует устройство безопасности, которое выполняет функции прокси-сервера и заменяет информацию о сертификатах, полученную из Интернета, на собственные корневые cертификаты CA. Если это самозаверяющие сертификаты, то в дополнение к команде для настройки пакета ЦС также необходимо выполнить команду для разрешения пакета ЦС. Обе эти команды описаны ниже. Это применяется к клиентам Qlik Cloud для правительства и к коммерческим клиентам Qlik Cloud.

Команда для настройки пакета ЦС

Выполните следующую команду, чтобы настроить пакет сертификатов ЦС:

Синтаксис (установка сервера Windows):

connectoragent qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file

Синтаксис (контейнерная установка):

dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file

Пример (установка сервера Windows):

connectoragent qcs qcs set\_config --ca\_bundle\_path c:\ca\cacerts.pem

Пример (контейнеризированная установка):

dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_path c:\ca\cacerts.pem

Команда для разрешения пакета ЦС

В некоторых средах используются устройства обеспечения безопасности, которые выполняют функцию прокси и заменяют информацию сертификата, полученную из Интернета, на собственные корневые сертификаты ЦС. Эту команду требуется выполнять, только если устройство обеспечения безопасности использует самозаверяющий сертификат. В таком случае пакет ЦС не может быть доверенным, пока не выполнена следующая команда:

* Windows установка сервера:

  connectoragent qcs set\_config --ca\_bundle\_allow\_invalid\_certs true

* Контейнеризированная установка:

  dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_allow\_invalid\_certs true

Примечание к информацииЕсли точно неизвестно, используется ли в среде такое устройство обеспечения безопасности, обратитесь к ИТ-администратору.

#### Создание и отображение регистрационного ключа:

Ключ используется для установки подключения между шлюзом прямого доступа и клиентом Qlik Cloud с проверкой подлинности.

Команды для создания регистрационного ключа

* Windows установка сервера:

  connectoragent qcs generate\_keys

* Контейнерная установка:

  dotnet ConnectorAgent.dll qcs generate\_keys

Команды для отображения регистрационного ключа

dotnet ConnectorAgent.dll qcs get\_registration

* Windows установка сервера:

  connectoragent qcs get\_registration

* Контейнерная установка:

  dotnet ConnectorAgent.dll qcs get\_registration

Ключ отображается.

![](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/da_reg_key.png)

Скопируйте ключ полностью, как показано в примере выше. Его потребуется вставить в центр активности Администрирование на следующем этапе.

### Этап 4: регистрация шлюза данных

Следующий шаг — зарегистрировать шлюз данных. Это можно сделать либо через центр активности Администрирование, либо в командной строке.

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)Вариант 1: через центр активности Администрирование

Примечание к предупреждениюРегистрация Direct Access Gateway автоматически создает запись поставщика удостоверений (Мультиоблако) в центре активности Администрирование для безопасной связи между шлюзом и клиентом. Описание поставщика удостоверений включает идентификатор шлюза (issuer gateway\_id), что позволяет легко найти связанный шлюз в разделе Шлюзы данных (центра активности Администрирование). Удаление поставщика удостоверений шлюза отключит шлюз, поэтому это следует делать только в том случае, если вы абсолютно уверены, что шлюз больше не требуется. Если вы случайно удалили поставщика удостоверений, перезапуск Direct Access Gateway восстановит запись и повторно подключит шлюз.

1. В центре активности Администрирование выберите Шлюзы данных.

   Все существующие шлюзы данных будут перечислены в [таблице, где отображается базовая информация о каждом шлюзе](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing-console.htm#gateprop).

2. На панели инструментов нажмите кнопку Создать.

   Откроется диалоговое окно Создание шлюза данных.

   ![](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_da-gate-create.png)

3. Укажите имя для шлюза данных.

4. Также можно добавить описание для шлюза данных.

5. В раскрывающемся списке Тип шлюза данных выберите Прямой доступ.

6. В раскрывающемся списке Связанное пространство (Associated space) выберите пространство.

   При связывании шлюза прямого доступа с пространством необходимо учитывать следующее:

   * Шлюзы данных можно создавать только в общих и управляемых пространствах.

   * Чтобы создать подключение к данным в одном пространстве, которое использует шлюз данных из другого пространства, необходимо иметь роль Может использовать данные в пространстве шлюза данных.

   * Для создания шлюза данных необходимо быть владельцем пространства или иметь роль Может управлять. Для подписок на основе пользователей вам также необходим уровень доступа Professional. Для получения дополнительной информации см. раздел [Управление правами пользователей](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/SaaS-user-allocations.htm).

   * Шлюзы данных могут быть связаны только с одним пространством.

7. Вставьте созданный ранее регистрационный ключ в поле Ключ.

8. Щелкните команду Создать.

   Шлюз данных добавляется как активный в список Шлюзы данных.

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)Вариант 2: автоматическая регистрация с помощью командной строки

Direct Access Gateway также можно зарегистрировать автоматически из командной строки, не переходя в центр активности Администрирование.

Инструкции см. в одном из следующих разделов в зависимости от рабочего процесса установки:

* Установка сервера Windows: [Вариант 2: автоматическая регистрация с помощью командной строки](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#StageAuto)

* Контейнерная установка: [Вариант 2: автоматическая регистрация с помощью командной строки](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#StageAuto)

### Этап 5. Запуск службы Шлюз данных Qlik — прямой доступ на сервере Direct Access Gateway

Затем необходимо запустить службу Шлюз данных Qlik — прямой доступ.

См. один из следующих разделов в зависимости от способа настройки:

* Установка сервера Windows: [Этап 5. Запуск службы Шлюз данных Qlik — прямой доступ на сервере Direct Access Gateway](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage3)

* Контейнерная установка: [Этап 5. Запуск службы Шлюз данных Qlik — прямой доступ на сервере Direct Access Gateway](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage5)

### Этап 6. Добавление подключения к источнику данных

Найдите шлюз в списке Шлюзы данных и убедитесь, что для него отображается Состояние «Подключено» (может потребоваться обновить браузер, чтобы увидеть актуальное состояние). Затем можно добавить подключение к источнику данных.

Существует несколько способов загрузки данных из источников данных:

* [Добавление источников данных из пространств и управление ими](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/managing-data-resources-spaces.htm)

* [Загрузка данных и управление ими с помощью Диспетчера данных](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/managing-data.htm)

* [Загрузка и преобразование данных с помощью скрипта](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/introduction-data-modeling.htm)

Список доступных источников данных содержит повторяющиеся записи для источников данных, которые поддерживают подключение к шлюзу. Источники данных с поддержкой шлюза данных можно идентифицировать по словам «через шлюз прямого доступа» (via Direct Access gateway), которые отображаются в скобках после типа источник.

Пример подключения к источнику с поддержкой шлюза

Пример подключения к источнику с поддержкой шлюза

Пример подключения к источнику с поддержкой шлюза ![Пример подключения к источнику с поддержкой шлюза](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/da-source-example.png)

Примечание к информацииВ диалоговом окне Добавление подключения к данным для источников данных, поддерживающих шлюзы данных) предусмотрено дополнительное поле Шлюз прямого доступа, которое позволяет выбрать нужный шлюз.

## Общие ограничения и важные моменты

* Direct Access Gateway можно подключить только к одному клиенту.

* Если по какой-либо причине сервер Direct Access Gateway перезапускается во время перезагрузки приложения Qlik, происходит ошибка перезагрузки. Повторно запустите перезагрузку приложения Qlik, чтобы обновить данные.

* Запросы перезагрузки сценариев не должны превышать 500 000 символов.

  Для получения информации о перезагрузке скриптов см. раздел [Выполнение скриптов](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/reloading-scripts.htm).