# Konfigurowanie Brama danych Qlik — dostęp bezpośredni

Możesz skonfigurować Brama danych Qlik — dostęp bezpośredni albo na serwerze Windows, albo w środowisku skonteneryzowanym. Aby konfiguracja przebiegła pomyślnie, upewnij się, że znasz wymagania wstępne, instrukcje instalacji, ograniczenia oraz uwagi dotyczące konkretnego procesu konfiguracji.

Informacja

Aby uzyskać informacje na temat wzorca AWS PrivateLink dla Brama danych Qlik — dostęp bezpośredni, zobacz [Konfigurowanie AWS PrivateLink dla Brama danych Qlik — dostęp bezpośredni](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-aws-privatelink.htm). Ten wzorzec nie zastępuje standardowych wymagań wstępnych ani wymagań sieciowych opisanych w tym temacie.

## Konfiguracja przepływów pracy

Wybierz jeden z następujących przepływów pracy:

* [Konfiguracja Brama danych Qlik — dostęp bezpośredni na serwerze Windows](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)
* [Konfigurowanie Brama danych Qlik — dostęp bezpośredni w kontenerze](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm)

## Wymagania systemowe

### Wymagania programowe

Zapoznaj się z jedną z poniższych sekcji w zależności od metody konfiguracji:

* WindowsSerwer:[Wymagania wstępne dotyczące oprogramowania](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software)

* Skonteneryzowane: [Wymagania programowe](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#SoftwareReq)

### Wspólne wymagania

Wymagania te mają zastosowanie zarówno do instalacji serwera Windows, jak i instalacji skonteneryzowanych.

#### Wymagane porty i protokoły

Poniżej znajduje się lista wymaganych portów.

#### Porty wychodzące

Port HTTPS/TCP-443 powinien być otwarty dla komunikacji wychodzącej z <tenant-id>.<region>.qlikcloud.com.

#### Porty wewnętrzne

Poniżej znajduje się lista portów używanych do komunikacji przez wewnętrzne procesy bramy danych. Jeśli którykolwiek z tych portów jest używany przez inną aplikację, należy zmienić konfigurację tej aplikacji lub ją odinstalować.

Porty ogólne

* 5050 (API REST agenta łącznika)
* 9027 (API REST DCAAS)

Porty ODBC

* 3005 (API REST łącznika ODBC)
* 50260 (gRPC łącznika ODBC)

Porty SAP

* 3015 (API REST łącznika SAP BW)

* 50270 (gRPC łącznika SAP BW)

* 3025 (API REST łącznika SAP SQL)

* 50280 (gRPC łącznika SAP SQL)

* 3035 (API REST łącznika SAP ODP)

* 50290 (gRPC łącznika SAP ODP)

* 3035 (API REST łącznika SAP Package)

* 50290 (gRPC łącznika SAP Package)

Porty REST

* 3055 (API REST łącznika REST)
* 50310 (łącznik REST gRPC)

Porty plików

* 3045 (API REST łącznika plików)
* 50300 (gRPC łącznika plików)

#### Protokół WSS

Oprócz HTTPS brama dostępu bezpośredniego wykorzystuje również protokół WSS (WebSocket Secure). Dlatego sprawdź, czy zapora sieciowa i serwer proxy (jeśli zamierzasz z nich korzystać) są skonfigurowane tak, aby zezwalały na wychodzące połączenia WSS.

### Zalecany sprzęt

Zapoznaj się z jedną z poniższych sekcji w zależności od metody konfiguracji:

* WindowsSerwer:[Zalecany sprzęt](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#RecHardware)

* Skonteneryzowane: [Zalecany sprzęt](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#RecHardware)

### Kryptografia systemowa (Windows tylko instalacja serwera)

Zobacz [Kryptografia systemu](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#System).

## Instalowanie programu Brama danych Qlik — dostęp bezpośredni

### Etap pierwszy: Pobierz Brama danych Qlik — dostęp bezpośredni

Zapoznaj się z jedną z poniższych sekcji w zależności od metody konfiguracji:

* WindowsSerwer:[Etap pierwszy: pobierz Brama danych Qlik — dostęp bezpośredni](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage5)

* Skonteneryzowane: [Etap pierwszy: pobierz Brama danych Qlik — dostęp bezpośredni](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage1)

### Etap drugi: Zainstalować lub wdrożyć Brama dostępu bezpośredniego

Zapoznaj się z jedną z poniższych sekcji w zależności od metody konfiguracji:

* WindowsSerwer:[Etap drugi: zainstaluj i skonfiguruj bramę Brama dostępu bezpośredniego na serwerze za zaporą chroniącą Twoje źródła danych](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage4)

* Skonteneryzowane: [Etap drugi: Rozpocznij wdrożenie, uruchamiając plik Docker Compose](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage2)

### Etap trzeci: Skonfiguruj Brama dostępu bezpośredniego

Ten etap obejmuje konfigurację adresu URL dzierżawy Qlik Cloud, opcjonalną konfigurację serwera proxy oraz wygenerowanie klucza rejestracyjnego. Klucz należy skopiować do ustawień bramy danych w centrum aktywności Administrowanie (w etapie trzecim poniżej). Klucz ten służy do ustanowienia uwierzytelnionego połączenia między bramą dostępu bezpośredniego a dzierżawcą Qlik Cloud.

Informacja

Połączenie z Qlik anonimową dzierżawą (region Szwecja) nie jest obsługiwane.

Począwszy od Brama dostępu bezpośredniego 1.7.16, region Kanada jest teraz obsługiwany. Wybierz region Kanada podczas wdrożenia w centrum aktywności Administrowanie w trakcie wdrażania pliku instalacyjnego bramy.

Na komputerze Direct Access gateway wykonaj jedną z następujących czynności w zależności od procedury instalacji:

* Windows serwer: Otwórz wiersz polecenia jako administrator i zmień katalog roboczy na podfolder ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent w przypadku instalacji domyślnej).

* Skonteneryzowane: Otwórz konsolę wewnątrz kontenera direct-access-agent.

Następnie postępuj zgodnie z poniższym opisem.

#### Ustawianie Qlik Cloud dzierżawy

Określ dzierżawcę Qlik Cloud, z którym chcesz się połączyć. Aby połączyć się z dzierżawcą przez serwer proxy, dodaj odpowiednie parametry do polecenia, jak pokazano poniżej.

Polecenia ustawiania dzierżawy Qlik Cloud bez serwera proxy:

* Windows instalacja serwera

  * Składnia:connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url

  * Przykład: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

* Instalacja skonteneryzowana

  * Składnia:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url

  * Przykład: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

Polecenia konfigurowania dzierżawy Qlik Cloud z serwerem proxy:

* Windows instalacja serwera

  * Składnia:connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password

  * Przykład: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

* Instalacja skonteneryzowana

  * Składnia:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password

  * Przykład: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

Informacje dotyczące ograniczeń serwera proxy zawiera temat [Połączenie z Qlik Cloud przez serwer proxy](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Connecti).

#### Ustawianie pakietu CA

Pakiet CA uwierzytelnia tożsamość dzierżawy Qlik Cloud, zapewniając w ten sposób zaufane połączenie.

Kto musi ustawić pakiet CA?

Pakiet CA należy ustawić tylko wtedy, gdy jest się:

* Klientem używającym Qlik Cloud Government
* Klientem biznesowym używającym Qlik Cloud i urządzenia zabezpieczającego, które działa jako serwer proxy i zastępuje informacje o certyfikacie otrzymane z Internetu własnymi certyfikatami głównymi urzędu certyfikacji.

Którego pakietu należy użyć?

Klienci powinni albo skorzystać z pakietu CA Qlik, albo użyć własnego pakietu CA w następujący sposób:

* Qlik dostarcza wiązać CA: Powinno być używane przez klientów Qlik Cloud Government posiadających standardowe środowisko. Środowisko standardowe to środowisko niekorzystające z urządzenia zabezpieczającego, które działa jako serwer proxy i zastępuje informacje o certyfikacie otrzymane z Internetu własnymi certyfikatami głównymi urzędu certyfikacji.

  W domyślnej instalacji Brama dostępu bezpośredniego plik pakietu CA znajduje się w następującej lokalizacji:

  * Windows instalacja serwera: C:\Program Files\Qlik\ConnectorAgent\caBundle\qcg\_ca\_bundle.pem

  * Instalacja konteneryzowana: /usr/share/Qlik/Gateway/ssl/qcg\_ca\_bundle.pem

  InformacjaNazwę pliku pakietu CA można zmienić, ale musi ona zachować rozszerzenie .pem (na przykład qlikcerts.pem). Następnie uruchom polecenia opisane poniżej.

* Klienci przynoszą własne wiązać CA: Należy stosować, jeśli środowisko klienta korzysta z urządzenia zabezpieczającego, które działa jako proxy i zamienia informacje o certyfikatach otrzymane z Internetu na własne certyfikaty główne CA. Jeśli te certyfikaty są z podpisem własnym, to oprócz polecenia ustawienia pakietu CA należy również uruchomić polecenie zezwolenia na pakiet CA. Oba te polecenia zostały opisane poniżej. Dotyczy to zarówno klientów używających Qlik Cloud Government, jak i klientów biznesowych używających Qlik Cloud.

Polecenie ustawienia pakietu CA

Uruchom następujące polecenie, aby ustawić pakiet certyfikatów CA:

Składnia (instalacja serwera Windows):

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

Składnia (instalacja skonteneryzowana):

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

Przykład (instalacja serwera Windows):

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

Przykład (instalacja skonteneryzowana):

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

Polecenie zezwalające na pakiet CA

Niektóre środowiska korzystają z urządzenia zabezpieczającego, które działa jako serwer proxy i zastępuje informacje o certyfikacie otrzymane z Internetu własnymi certyfikatami głównymi urzędu certyfikacji.. To polecenie należy uruchomić tylko wtedy, gdy samo urządzenie zabezpieczające używa certyfikatu z podpisem własnym. W takim przypadku pakiet CA może nie być zaufany, chyba że uruchomisz następujące polecenie:

* Windows instalacja serwera:

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

* Instalacja skonteneryzowana:

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

InformacjaJeśli nie masz pewności, czy Twoje środowisko korzysta z takiego urządzenia zabezpieczającego, skontaktuj się z administratorem IT.

#### Generowanie i wyświetlanie klucza rejestracyjnego

Klucz ten służy do ustanowienia uwierzytelnionego połączenia między bramą dostępu bezpośredniego a dzierżawcą Qlik Cloud.

Polecenia służące do generowania klucza rejestracyjnego

* Windows instalacja serwera:

  connectoragent qcs generate\_keys

* Instalacja skonteneryzowana:

  dotnet ConnectorAgent.dll qcs generate\_keys

Polecenia służące do wyświetlania klucza rejestracyjnego

dotnet ConnectorAgent.dll qcs get\_registration

* Windows instalacja serwera:

  connectoragent qcs get\_registration

* Instalacja skonteneryzowana:

  dotnet ConnectorAgent.dll qcs get\_registration

Klucz jest pokazany.

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

Skopiuj cały klucz, jak pokazano w powyższym przykładzie. Należy go wkleić w centrum aktywności Administrowanie w następnym etapie.

### Etap czwarty: Zarejestruj bramę danych

Następnym krokiem jest zarejestrowanie bramy danych. Można to zrobić za pośrednictwem centrum aktywności Administrowanie lub w wierszu poleceń.

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)Opcja 1: Za pośrednictwem centrum aktywności Administrowanie

OstrzeżenieRejestracja Brama dostępu bezpośredniego automatycznie tworzy wpis dostawcy tożsamości (Wielochmurowy) w centrum aktywności Administracja, dla bezpiecznej komunikacji między bramą a dzierżawą. Opis dostawcy tożsamości zawiera identyfikator bramy (identyfikator bramy wystawcy), co pozwala łatwo zlokalizować powiązaną bramę w sekcji Bramy danych (centrum aktywności Administracja). Usunięcie dostawcy tożsamości bramy spowoduje rozłączenie bramy, dlatego należy to zrobić tylko wtedy, gdy ma się absolutną pewność, że brama nie jest już potrzebna. Jeśli przypadkowo usunięto dostawcę tożsamości, ponowne uruchomienie Brama dostępu bezpośredniego przywróci wpis i ponownie połączy bramę.

1. W centrum aktywności Administrowanie wybierz Bramy danych.

   Wszystkie istniejące bramy danych zostaną przedstawione w [tabeli pokazującej podstawowe informacje o każdej z nich](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing-console.htm#gateprop).

2. Kliknij przycisk Utwórz na pasku narzędzi.

   Zostanie otwarte okno dialogowe Tworzenie bramy danych.

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

3. Podaj nazwę bramy danych.

4. Opcjonalnie możesz dodać jej opis.

5. Z listy typ bramy danych wybierz pozycję Dostęp bezpośredni.

6. Z listy rozwijanej Przestrzeń wspólnawybierz przestrzeń.

   Podczas kojarzenia bramy dostępu bezpośredniego z przestrzenią należy pamiętać o następujących kwestiach:

   * Bramy danych można tworzyć tylko w przestrzeniach wspólnych lub zarządzanych

   * Aby utworzyć połączenie danych w jednej przestrzeni, która używa bramy danych z innej przestrzeni, musisz mieć rolę Może używać danych w przestrzeni bramy danych.

   * Aby utworzyć bramę danych, należy być właścicielem przestrzeni lub mieć rolę Może zarządzać. W przypadku subskrypcji opartych na użytkownikach potrzebne jest również uprawnienie Professional. Więcej informacji zawiera temat [Zarządzanie uprawnieniami użytkowników](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/SaaS-user-allocations.htm).

   * Bramę danych można skojarzyć tylko z jedną przestrzenią.

7. Wklej klucz rejestracyjny wygenerowany wcześniej w polu Klucz.

8. Kliknij Utwórz.

   Włączona brama danych zostaje dodana do listy Bramy danych.

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)Opcja 2: Automatyczna rejestracja za pomocą wiersza poleceń

Możesz również zarejestrować Brama dostępu bezpośredniego automatycznie z wiersza poleceń, bez użycia centrum aktywności Administrowanie.

Aby uzyskać instrukcje, zapoznaj się z jedną z poniższych sekcji w zależności od procesu instalacji:

* Windows instalacja serwera: [Opcja 2: Automatyczna rejestracja za pomocą wiersza poleceń](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#StageAuto)

* Instalacja skonteneryzowana: [Opcja 2: Automatyczna rejestracja za pomocą wiersza poleceń](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#StageAuto)

### Etap piąty: uruchom usługę Brama danych Qlik — dostęp bezpośredni na serwerze bramy Direct Access gateway

Następnie musisz uruchomić usługę Brama danych Qlik — dostęp bezpośredni.

Zapoznaj się z jedną z poniższych sekcji w zależności od metody konfiguracji:

* Windows instalacja serwera: [Etap piąty: uruchom usługę Brama danych Qlik — dostęp bezpośredni na serwerze bramy Direct Access gateway](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage3)

* Instalacja skonteneryzowana: [Etap piąty: uruchom usługę Brama danych Qlik — dostęp bezpośredni na serwerze bramy Direct Access gateway](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage5)

### Etap szósty: dodaj połączenie do swojego źródła danych

Znajdź swoją bramę na liście Bramy danych i sprawdź, czy ma stan „Połączono” (aby zobaczyć aktualny stan, być może trzeba będzie odświeżyć okno przeglądarki). Następnie możesz przejść do dodawania połączenia do swojego źródła danych.

Dane ze źródeł danych można dodać na kilka sposobów:

* [Dodawanie źródeł danych z przestrzeni i zarządzanie nimi](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/managing-data-resources-spaces.htm)

* [Ładowanie danych i zarządzanie nimi za pomocą Menedżera danych](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/managing-data.htm)

* [Ładowanie i przekształcanie danych za pomocą skryptów](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/introduction-data-modeling.htm)

Na liście dostępnych źródeł danych pozycje źródeł obsługujących łączność z bramą będą zduplikowane. Obsługujące bramę źródła danych można zidentyfikować po słowach „przez bramę Direct Access gateway”, które znajdują się w nawiasie za typem źródła.

Przykład połączenia ze źródłem zgodnym z bramą

Przykład połączenia ze źródłem zgodnym z bramą

Przykład połączenia ze źródłem zgodnym z bramą ![Przykład połączenia ze źródłem zgodnym z bramą](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Resources/Images/da-source-example.png)

InformacjaOkno dialogowe Dodawanie połączenia danych źródła danych zgodnego z bramą zawiera dodatkowe pole Brama dostępu bezpośredniego, które umożliwia wybór bramy.

## Ogólne ograniczenia i uwagi

* Brama dostępu bezpośredniego można połączyć tylko z jedną dzierżawą.

* Jeśli serwer bramy Brama dostępu bezpośredniego zostanie uruchomiony ponownie podczas przeładowywania aplikacji Qlik, przeładowywanie to się nie powiedzie. Ponownie uruchom przeładowywanie aplikacji Qlik, aby odświeżyć dane.

* Zapytania skryptu przeładowania nie mogą przekraczać 500 000 znaków.

  Informacje na temat przeładowywania skryptów zawiera temat [Uruchamianie skryptów](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/reloading-scripts.htm).