Einrichten von Qlik Data Gateway – direkter Zugriff in einer Sammelbox

Letzte Aktualisierung: 30.09.2026

In diesem Thema wird beschrieben, wie Sie containerisiertes Direct Access Gateway einrichten. Es enthält Voraussetzungen und Installationsanweisungen und beschreibt die Einschränkungen und Aspekte, die Sie bei der Arbeit mit containerisiertem Direct Access Gateway beachten sollten.

Unterstützt ab Direct Access Gateway 1.8.0.

Was ist containerisiertes Direct Access Gateway?

Sie können Direct Access Gateway in einer Docker-Sammelbox bereitstellen. Diese Art der Bereitstellung wird als containerisiert Direct Access Gateway bezeichnet. Containerisierte Direct Access Gateway-Bereitstellungen werden für Linux, macOS und Windows unterstützt.

Containerisiertes Direct Access Gateway bietet Portabilität für Ihre Direct Access Gateway-Umgebung.

Best Practices bei der Verwendung von Qlik Data Gateway – direkter Zugriff

Für eine erfolgreiche Erfahrung bei Verwendung von Qlik Data Gateway – direkter Zugriff wird dringend empfohlen, die folgenden Best Practices einzuhalten:

Verwenden Sie nicht das gleiche Direct Access Gateway für Entwicklung, Benutzerakzeptanztests und Produktion, da dies die Gefahr einer Überlastung der verfügbaren Ressourcen erhöht und die Systemstabilität beeinträchtigen kann. Aus geschäftlicher Perspektive kann die Kombination aus ungenügenden Ressourcen und verringerter Stabilität zu verzögerten Aktualisierungen von Produktionsanwendungsdaten führen.
Installieren Sie zum Optimieren der Leistung das Direct Access Gateway in einer Umgebung, die sich so nah wie möglich an der Datenquelle befindet.

Systemvoraussetzungen

In diesem Abschnitt werden die Anforderungen für die Verwendung von containerisiertem Direct Access Gateway beschrieben.

Softwareanforderungen

Docker Engine Version 20.9+ und das Docker Compose-Plugin (docker compose, v2-Syntax) auf dem Host installiert.

Erforderliche Ports und Protokolle

Informationen zu den erforderlichen Ports und Protokollen finden Sie unter Erforderliche Ports und Protokolle.

Empfohlene Hardware

Host: 8 Kerne, 32 GB Arbeitsspeicher, 5 GB Speicherplatz für Docker verfügbar
Optional: Legen Sie in der Compose-Datei entsprechende Limits für die Sammelbox fest, damit das Gateway über dedizierte Kapazität verfügt, anstatt mit anderen Sammelboxen oder Prozessen auf dem Host zu konkurrieren:
```
direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "6"
          memory: 24G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
```

Minimal erforderliche Hardware

Die minimal erforderliche Hardware ist nur für spezifische Szenarios mit kleineren dedizierten Bereitstellungen (Entwicklung, Test und Produktion) ausreichend, die mit kontinuierlich geringem Datenvolumen und einer begrenzten Anzahl gleichzeitiger Ladevorgänge verwendet werden.

Host: 4 Kerne, 8 GB Arbeitsspeicher, 5 GB Speicherplatz für Docker verfügbar
Optional: Legen Sie in der Compose-Datei entsprechende Limits für die Sammelbox fest, damit das Gateway über dedizierte Kapazität verfügt, anstatt mit anderen Sammelboxen oder Prozessen auf dem Host zu konkurrieren:
```
direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
          memory: 4G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
```

Installieren von Qlik Data Gateway – direkter Zugriff

Das Setup des Direct Access Gateway umfasst Verfahren, die sowohl im Aktivitätscenter Administration als auch auf dem Server des Direct Access Gateway durchgeführt werden müssen.

Für Daten-Gateway-Verfahren, die im Administration Aktivitätscenter ausgeführt werden müssen, ist die Genehmigung des Mandantenadministrators erforderlich.

Phase 1: herunterladenQlik Data Gateway – direkter Zugriff

Wählen Sie im Aktivitätscenter Administration Daten-Gateways aus.

Vorhandene Daten-Gateways werden in einer Tabelle mit grundlegenden Informationen zu jedem Gateway aufgelistet.
Klicken Sie in der Symbolleiste auf die Schaltfläche Bereitstellen.

Das Dialogfenster Daten-Gateway bereitstellen wird geöffnet.
Wählen Sie Daten-Gateway – Direkter Zugriff - Containerized Direct Access Gateway aus, akzeptieren Sie die Qlik Kundenvereinbarung und klicken Sie auf Herunterladen. Die Direct Access gateway-Setup-Datei (docker-compose.qlik-data-gateway-direct-access.yml) wird auf Ihren Computer heruntergeladen.

Phase zwei: Starten Sie die Bereitstellung durch Ausführen der Docker Compose-Datei

Um die Bereitstellung von Direct Access Gateway zu starten, führen Sie den folgenden Befehl aus:

docker compose -f docker-compose.qlik-data-gateway-direct-access.yml up

Phase drei: Einrichten von Direct Access Gateway

Detaillierte Einrichtungsanweisungen finden Sie unter Phase drei: Direct Access Gateway einrichten.

Phase vier: Datengateway registrieren

Der nächste Schritt besteht darin, das Datengateway zu registrieren. Dies kann entweder über das Administration Activity Center oder über die Befehlszeile erfolgen.

Sie können das Gateway über das Administration-Aktivitätscenter registrieren. Siehe Option 1: Über das Administration-Aktivitätscenter.

Sie können Direct Access Gateway auch automatisch über die Befehlszeile registrieren, ohne das Aktivitätscenter Administration zu verwenden. Diese Methode verwendet ein kurzlebiges Session-Token, das von einem OAuth-Client generiert wurde.

Die automatische Registrierung wird nur über die Befehlszeile unterstützt. Eine REST-API für die automatische Gateway-Registrierung ist derzeit nicht verfügbar.

Voraussetzungen

Ein API-Schlüssel mit Mandantenadministrator-Berechtigung zum Erstellen und Verwalten von OAuth-Clients.

Registrieren des Gateways mit automatischer Registrierung

Zuerst müssen Sie eine Python-Umgebung einrichten, um eine OAuth-Client-ID sowie einen Assertion-Schlüssel (kurzlebiges Token) in der direct-access-agent-Sammelbox zu generieren. Führen Sie die folgenden Befehle separat in dieser Reihenfolge aus:
1. docker exec -it --user root direct-access-agent-1 bash
2. apt-get update && apt-get install -y python3 python3-pip
3. apt install python3.11-venv
4. python3 -m venv .venv
5. source .venv/bin/activate
6. pip install cryptography pyjwt
7. python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Folgen Sie für den letzten Befehl in der obigen Liste den interaktiven Eingabeaufforderungen und kopieren Sie client_id (OAuth-Client-ID) und assertion, wenn diese bereitgestellt werden. Notieren Sie diese Details vorerst auf Papier oder in einer temporären Textdatei – sie werden für spätere Schritte im Prozess benötigt.
Wenn Sie client_id und assertion notiert haben, bereinigen Sie die Python-Umgebung mit dem folgenden Befehl:

deactivate
Legen Sie die Einwilligungsmethode des OAuth-Clients auf „trusted“ fest.

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"}]'
Fordern Sie ein Zugriffstoken an. Dies löst auch die automatische Erstellung des vom Gateway verwendeten Bot-Benutzerkontos aus.

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"

Informationshinweis
Wenn die Assertion abgelaufen ist, führen Sie das Skript erneut aus der virtuellen Umgebung aus.
Suchen Sie nach dem automatisch erstellten Bot-Benutzer.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>'
Kopieren Sie die ID von my-bot-client.
Erstellen Sie eine Rolle „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"]}'
Weisen Sie dem Bot-Benutzer Rollen auf Mandantenebene zu.

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" } ] } ]'
Rufen Sie den Bereich des Gateways für direkten Zugriff ab.

curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>'
Kopieren Sie die Direct Access Gateway-Space-ID.
Fügen Sie den Bot-Benutzer mit der Berechtigung Kann bearbeiten zum Space hinzu.

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"}'
Falls die bestehende Assertion abgelaufen ist, generieren Sie eine neue. Führen Sie den folgenden Befehl aus:

python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Führen Sie die erforderlichen Schritte in der Eingabeaufforderung aus. Da der OAuth-Client bereits erstellt wurde, muss der JWK mithilfe dieses API-Aufrufs aktualisiert werden:

curl "https://<tenant-url>/api/v1/oauth-clients/<client-ID>" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d '[{"op":"replace","path":"/publicKeys/0/y","value":"<Y-value-from-JWK>"},{"op":"replace","path":"/publicKeys/0/x","value":"<X-value-from-JWK>"},{"op":"remove","path":"/publicKeys/0/use"},{"op":"replace","path":"/publicKeys/0/kid","value":"<kid-value-from-JWK>"}]'
Gateway registrieren:

dotnet ConnectorAgent.dll qcs register_gateway --tenant_url <tenant-url> --gateway_name <DAG-name> --gateway_description <DAG-description> --space_name <space-name> --client-id <client-ID> --assertion <assertion>

Entfernen eines automatisch registrierten Gateways

Führen Sie die folgenden Schritte aus, um die Registrierung eines Gateways aufzuheben, das mithilfe der oben beschriebenen automatischen, auf Sitzungs-Token basierenden Methode registriert wurde. Diese Schritte entfernen auch den OAuth-Client, den Bot-Benutzer und die Rolle, die dafür erstellt wurden.

Generieren Sie eine Assertion, wie in dem obigen Abschnitt beschrieben.
Löschen Sie das Gateway:

dotnet ConnectorAgent.dll qcs delete_gateway --tenant_url <tenant-url> --gateway_name <gateway-name> --client-id <client-ID> --assertion <assertion>
Suchen Sie das Bot-Benutzerkonto, das für das Gateway erstellt wurde.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>'
Kopieren Sie die Bot-ID.
Löschen Sie dieses Bot-Benutzerkonto.

curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>"
Suchen Sie nach der Rolle „DAG Registration“, die für das Gateway erstellt wurde.

curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name%20eq%20%22DAG%20Registration%22)" -H "Authorization: Bearer <api-key>"
Kopieren Sie die Rollen-ID.
Löschen Sie diese Rolle.

curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID> -H "Authorization: Bearer <api-key>"
Löschen Sie den OAuth-Client.

curl -X DELETE https://<tenant-url>/api/v1/oauth-clients/<OAuth-client-ID> -H "qlik-confirm-delete: <OAuth-client-ID>" -H "Authorization: Bearer <api-key>

Phase 5: Den Qlik Data Gateway – direkter Zugriff-Dienst auf dem Server des Direct Access Gateway starten

Um den Dienst Qlik Data Gateway – direkter Zugriff zu starten, starten Sie die Container dcaas-dg und direct-access-agent.

Phase 6: Eine Verbindung zu Ihrer Datenquelle hinzufügen

Siehe Phase 6: Eine Verbindung zu Ihrer Datenquelle hinzufügen.

Umgebungseinstellungen

Dieser Abschnitt listet spezifische Umgebungsvariablen aus der Datei docker-compose.qlik-data-gateway-direct-access.yml auf, die Sie möglicherweise konfigurieren müssen, um Ihre Datenquellen ordnungsgemäß über das Gateway zu verbinden.

ALLOW_SOURCES: Eine kommagetrennte Zulassungsliste von Hostnamen und IP-Adressen. Wenn der Gateway-Agent eine Verbindung zu etwas auf Ihrem eigenen Server oder einem anderen Host im lokalen oder privaten Netzwerk herstellen muss (zum Beispiel zu einer Datenbank auf localhost, einem Docker-Dienstnamen oder einem Host mit privater IP-Adresse), fügen Sie diese Adresse zu ALLOW_SOURCES hinzu — andernfalls wird der Verbindungsversuch abgelehnt.

Unterstützte Datenquellen

Die folgenden ODBC-Konnektoren werden für containerisierte Installationen unterstützt:
- PostgreSQL
- SQL Server
- Oracle
Weitere Informationen zu ODBC-Konnektoren finden Sie unter ODBC-Datenbanken – Qlik Cloud (nur auf Englisch).
REST Konnektor (REST über Direct Access gateway). Weitere Informationen zu REST-Datenquellen finden Sie unter REST-Quellen ‒ Qlik Cloud (nur auf Englisch).

Weitere Informationen

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!

Geben Sie hier Ihr Feedback ab