Configurazione di Qlik Data Gateway - Accesso diretto in un contenitore

Ultimo aggiornamento: 30/09/2026

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.

Che cos'è Gateway di Direct Access containerizzato?

È possibile distribuire Gateway di Direct Access in un contenitore Docker. Questo tipo di distribuzione è denominato Gateway di Direct Access containerizzato. 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 disponibile per Docker

Facoltativo: impostare 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: impostare 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.
Selezionare Data Gateway Direct Access - Containerized Direct Access Gateway, accettare il Contratto con il cliente Qlik e fare clic su Scarica. Il file di installazione del gateway di Direct Access (docker-compose.qlik-data-gateway-direct-access.yml) verrà scaricato sul computer.

Fase due: Avviare la distribuzione eseguendo il file Docker Compose

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

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

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. Questa operazione può essere eseguita 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.

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

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 dell'elenco sopra, segui i prompt interattivi e copia client_id (ID client OAuth) e assertion quando forniti. Conserva questi dettagli su carta o in un file di testo temporaneo per il momento—sono necessari per i passaggi successivi della procedura.
Dopo aver annotato client_id e assertion, pulisci l'ambiente Python con il comando seguente:

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 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, riesegui 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 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 di 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 tramite 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>
Individuare l'account utente del 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 proprie 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.

Sorgenti dati supportate

I seguenti connettori ODBC sono supportati per le installazioni containerizzate:
- 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, consultare Origini REST ‒ Qlik Cloud (solo in lingua inglese).

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