Configurazione di Qlik Data Gateway - Accesso diretto in un contenitore

Ultimo aggiornamento: 2026-11-10

Questo argomento illustra come configurare Gateway di Direct Access containerizzato. Fornisce i prerequisiti e le istruzioni di installazione e descrive le limitazioni e le considerazioni di cui tenere conto quando si lavora con Gateway di Direct Access containerizzato.

Supportato a partire da Gateway di Direct Access 1.8.0.

Sorgenti dati supportate

I seguenti connettori sono supportati per le installazioni containerizzate:

I seguenti connettori ODBC sono supportati:
- PostgreSQL
- SQL Server
- Oracle
Per maggiori informazioni sui connettori ODBC, vedere Database ODBC - Qlik Cloud (solo in lingua inglese).
REST connettore (REST tramite gateway di Direct Access). Per ulteriori informazioni sulle origini dati REST, vedere Origini REST ‒ Qlik Cloud (solo in lingua inglese).
Connettore MySQL.

Nota informaticaSupportato da Gateway di Direct Access 1.8.1.
Connettori SAP SQL, SAP BW, SAP ODP e SAP Report. Per informazioni sull'installazione di SAP NetWeaver RFC SDK sul computer Qlik Data Gateway - Direct Access per le installazioni containerizzate, consultare Installazione di SAP NetWeaver RFC SDK per Qlik Data Gateway - Accesso diretto (solo in lingua inglese).

Nota informaticaSupportato da Gateway di Direct Access 1.8.1.

Che cos'è Gateway di Direct Access containerizzato?

È possibile distribuire Gateway di Direct Access in un contenitore Docker. Questo tipo di distribuzione è chiamato containerizzato Gateway di Direct Access. Le distribuzioni containerizzate di Gateway di Direct Access sono supportate per Linux, macOS e Windows.

Gateway di Direct Access containerizzato fornisce portabilità al tuo ambiente Gateway di Direct Access.

Procedure consigliate quando si utilizza Qlik Data Gateway - Accesso diretto

Per un'esperienza ottimale quando si utilizza Qlik Data Gateway - Accesso diretto, si consiglia vivamente di seguire le seguenti procedure consigliate:

Non usare lo stesso Gateway di Direct Access per lo sviluppo, il testing dell'accettazione degli utenti e la produzione, poiché così facendo aumenterà il rischio di sovraccaricare le risorse disponibili con conseguenze negative sulla stabilità del sistema. Da una prospettiva aziendale, la combinazione di risorse insufficienti e stabilità ridotta, possono causare un ritardo negli aggiornamenti dei dati di applicazione di produzione.
Per ottenere prestazioni ottimali, installare Gateway di Direct Access in un ambiente il più vicino possibile alla sorgente dati.

Prerequisiti di sistema

Questa sezione descrive i requisiti per l'utilizzo di Gateway di Direct Access containerizzato.

Requisiti software

Docker Engine versione 20.9+ e il plugin Docker Compose (docker compose, sintassi v2) installati sull'host.

Porte e protocolli richiesti

Per le porte e i protocolli richiesti, vedere Porte e protocolli richiesti.

Hardware consigliato

Host: 8 core, 32 GB di memoria, 5 GB di spazio di archiviazione disponibili per Docker

Facoltativo: imposta limiti corrispondenti sul contenitore nel file compose in modo che il gateway disponga di capacità dedicata anziché competere con altri contenitori o processi sull'host:

direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "6"
          memory: 24G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"

Requisiti hardware minimi

I requisiti hardware minimi sono adatti solo per scenari specifici che utilizzano distribuzioni dedicate più piccole (sviluppo, test o produzione), con volumi di dati costantemente bassi e un numero limitato di ricaricamenti simultanei.

Host: 4 core, 8 GB di memoria, 5 GB di spazio di archiviazione disponibile per Docker

Facoltativo: imposta limiti corrispondenti sul contenitore nel file compose in modo che il gateway disponga di capacità dedicata anziché competere con altri contenitori o processi sull'host:

direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
          memory: 4G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"

Installazione di Qlik Data Gateway - Accesso diretto

La configurazione del gateway di Direct Access comporta procedure che devono essere eseguite sia nel centro attività Amministrazione sia sul server del gateway di Direct Access.

Le procedure per il gateway dati che è necessario eseguire nel centro attività Amministrazione richiedono l'autorizzazione dell'amministratore tenant.

Passaggio uno: scaricare Qlik Data Gateway - Accesso diretto

Nel centro attività Amministrazione, selezionare Gateway dati.

Tutti i gateway di dati esistenti saranno elencati in una tabella che riporta le informazioni di base su ciascun gateway.
Fare clic sul pulsante della barra degli strumenti Distribuisci.

Si apre la finestra di dialogo Distribuisci gateway dati.
Seleziona Data Gateway - Accesso diretto - Containerized Direct Access Gateway, accetta il Contratto con il cliente Qlik e fai clic su Scarica. Il file di installazione del gateway di Direct Access (docker-compose.qlik-data-gateway-direct-access.yml) verrà scaricato sul proprio computer.

Fase due: avviare la distribuzione eseguendo il file Docker Compose

Per avviare la distribuzione del Gateway di Direct Access, eseguire il seguente comando:

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

Copia dell'SDK SAP NetWeaver RFC nel contenitore

Per i connettori SAP SQL, SAP BW, SAP ODP e SAP Report, copiare i file di SAP NetWeaver RFC SDK nel contenitore.

Dalla directory che contiene entrambe le cartelle dei file binari dell'SDK per Linux e Windows, esegui:

docker cp . direct-access-agent-1:/usr/share/Qlik/Gateway/sap-sdk

Riavvia il contenitore direct-access-agent-1 dopo aver copiato i file.

Fase tre: Configurazione di Gateway di Direct Access

Per istruzioni dettagliate sulla configurazione, consultare Fase tre: Configura Gateway di Direct Access.

Fase quattro: Registrare il gateway dati

Il passaggio successivo consiste nel registrare il gateway dati. È possibile eseguire questa operazione sia tramite il centro attività Amministrazione sia da riga di comando.

È possibile registrare il gateway utilizzando il centro attività Amministrazione. Vedere Opzione 1: Tramite il centro attività Amministrazione.

È anche possibile registrare Gateway di Direct Access automaticamente dalla riga di comando, senza usare il centro attività Amministrazione. Questo metodo utilizza un token di sessione di breve durata generato da un client OAuth.

Per registrare e rimuovere automaticamente i gateway registrati automaticamente, sono necessarie le seguenti autorizzazioni:

Registrazione automatica: è necessaria l'autorizzazione di amministratore Registra gateway di Direct Access impostata su Consentito.
Rimozione dei gateway registrati automaticamente: è necessaria l'autorizzazione di amministratore Registra gateway di Direct Access impostata su Consentito.

Per ulteriori informazioni sulle autorizzazioni, vedere Autorizzazioni predefinite e ruoli personalizzati.

La registrazione automatica è supportata solo tramite riga di comando. Un'API REST per la registrazione automatica del gateway non è attualmente disponibile.

Prerequisiti

Una chiave API con autorizzazione di amministratore tenant per creare e gestire client OAuth.

Registrazione del gateway tramite registrazione automatica

Per prima cosa, è necessario configurare un ambiente Python per generare un ID client OAuth, nonché una chiave di asserzione (token di breve durata) nel contenitore direct-access-agent. Eseguire i comandi seguenti separatamente, in questo ordine:
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>
Per l'ultimo comando nell'elenco sopra, segui i prompt interattivi e copia il client_id (ID client OAuth) e assertion quando vengono forniti. Conserva questi dettagli su carta o in un file di testo temporaneo per il momento—saranno necessari per i passaggi successivi del processo.
Dopo aver annotato client_id e assertion, pulire l'ambiente Python con il seguente comando:

deactivate
Imposta il metodo di consenso del client OAuth su attendibile.

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"}]'
Richiedi un token di accesso. Questo attiva anche la creazione automatica dell'account utente del bot utilizzato dal gateway.

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"

Nota informatica
Se l'asserzione è scaduta, esegui nuovamente lo script dall'ambiente virtuale.
Cerca l'utente bot creato automaticamente.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>'
Copia l'ID di my-bot-client.
Crea un ruolo "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"]}'
Assegna i ruoli a livello di tenant all'utente bot.

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" } ] } ]'
Ottieni lo spazio del Direct Access Gateway.

curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>'
Copia l'ID dello spazio Direct Access Gateway.
Aggiungi l'utente bot allo spazio con l'autorizzazione Può modificare.

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"}'
Nel caso in cui l'asserzione esistente sia scaduta, generane una nuova. Eseguire il comando seguente:

python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Seguire i passaggi necessari nel prompt dei comandi. Poiché il client OAuth è già stato creato, è necessario aggiornare il JWK utilizzando questa chiamata API:

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>"}]'
Registrare il gateway:

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>

Rimozione di un gateway registrato automaticamente

Utilizzare i passaggi seguenti per annullare la registrazione di un gateway registrato utilizzando il metodo automatico basato su token di sessione descritto sopra. Questi passaggi rimuovono anche il client OAuth, l'utente bot e il ruolo creati per esso.

Genera un'asserzione, come descritto nella sezione precedente.
Elimina il gateway:

dotnet ConnectorAgent.dll qcs delete_gateway --tenant_url <tenant-url> --gateway_name <gateway-name> --client-id <client-ID> --assertion <assertion>
Cerca l'account utente bot creato per il gateway.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>'
Copia l'ID del bot.
Elimina questo account utente bot.

curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>"
Cerca il ruolo “DAG Registration” creato per il gateway.

curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name%20eq%20%22DAG%20Registration%22)" -H "Authorization: Bearer <api-key>"
Copia l'ID del ruolo.
Elimina questo ruolo.

curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID> -H "Authorization: Bearer <api-key>"
Elimina il client OAuth.

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>

Fase cinque: Avviare il servizio Qlik Data Gateway - Accesso diretto sul server del gateway di c

Per avviare il servizio Qlik Data Gateway - Accesso diretto, avviare i container dcaas-dg e direct-access-agent.

Passaggio sei: aggiunta di una connessione alla sorgente dati

Vedere Passaggio sei: aggiunta di una connessione alla sorgente dati.

Impostazioni dell'ambiente

Questa sezione elenca specifiche variabili di ambiente del file docker-compose.qlik-data-gateway-direct-access.yml che potrebbe essere necessario configurare per connettere correttamente le origini dati tramite il gateway.

ALLOW_SOURCES: Un elenco consentiti separato da virgole di nomi host e IP. Quando l'agente gateway deve connettersi a qualcosa sul tuo server o su un altro host nella rete locale o privata (ad esempio, un database su localhost, il nome di un servizio Docker o un host con IP privato), aggiungi tale indirizzo a ALLOW_SOURCES — altrimenti il tentativo di connessione viene rifiutato.

Ulteriori informazioni

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – ti pregiamo di farcelo sapere!

Lascia qui il tuo feedback