Configurar Qlik Data Gateway - Direct Access en un contenedor

Última actualización: 30/9/2026

Este tema describe cómo configurar Direct Access gateway en un contenedor. Proporciona requisitos previos e instrucciones de instalación, y describe las limitaciones y consideraciones que debe tener en cuenta al trabajar con Direct Access gateway en un contenedor.

Compatible a partir de Direct Access gateway 1.8.0.

¿Qué es Direct Access gateway en un contenedor?

Puede implementar Direct Access gateway en un contenedor Docker. Este tipo de implementación se denomina Direct Access gateway en contenedores. Las implementaciones de Direct Access gateway en contenedores son compatibles con Linux, macOS y Windows.

Direct Access gateway en contenedores proporciona portabilidad a su entorno Direct Access gateway.

Buenas prácticas en el uso de Qlik Data Gateway - Direct Access

Para disfrutar de una experiencia satisfactoria al utilizar Qlik Data Gateway - Direct Access, se recomienda encarecidamente seguir las siguientes prácticas recomendadas:

No utilice la misma Direct Access gateway para el desarrollo, las pruebas de aceptación del usuario y la producción, ya que esto aumentará el riesgo de sobrecargar los recursos disponibles y afectará a la estabilidad del sistema. Desde una perspectiva empresarial, la combinación de recursos insuficientes y una menor estabilidad podría provocar retrasos en la actualización de los datos de las aplicaciones de producción.
Para un rendimiento óptimo, instale Direct Access gateway en un entorno que esté lo más cerca posible de su fuente de datos.

Requisitos previos del sistema

Esta sección describe los requisitos para usar Direct Access gateway en contenedores.

Requisitos de software

Docker Engine versión 20.9+ y el plugin de Docker Compose (docker compose, sintaxis v2) instalados en el host.

Puertos y protocolos requeridos

Para conocer los puertos y protocolos requeridos, consulte Puertos y protocolos requeridos.

Hardware recomendado

Host: 8 núcleos, 32 GB de memoria, 5 GB de almacenamiento disponibles para Docker

Opcional: establezca límites coincidentes en el contenedor en el archivo compose para que la pasarela tenga capacidad específica en lugar de competir con otros contenedores o procesos en el host:

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

Hardware mínimo

El hardware mínimo solo es adecuado para escenarios específicos que utilicen implementaciones dedicadas más pequeñas (desarrollo, pruebas o producción), con volúmenes de datos continuamente bajos y un número limitado de recargas simultáneas.

Host: 4 núcleos, 8 GB de memoria, 5 GB de almacenamiento disponibles para Docker

Opcional: establezca límites coincidentes en el contenedor en el archivo compose para que la pasarela tenga capacidad dedicada en lugar de competir con otros contenedores o procesos en el host:

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

Instalar Qlik Data Gateway - Direct Access

La configuración de la pasarela Direct Access gateway implica procedimientos que deben realizarse tanto en el centro de actividades Administración como en el servidor de la pasarela Direct Access gateway.

Los procedimientos de la pasarela de datos que deban realizarse en el centro de actividades de Administración requieren el permiso del administrador del espacio empresarial inquilino.

Etapa uno: Descargar Qlik Data Gateway - Direct Access

En el centro de actividades Administración, seleccione Pasarelas de datos.

Cualquier pasarela de datos existente se indicará en una tabla que muestra información básica sobre cada puerta de enlace.
Haga clic en el botón de la barra de herramientas Implementar.

Se abre el cuadro de diálogo Implementar la pasarela de datos.
Seleccione Pasarela de datos de acceso directo - Containerized Direct Access Gateway, acepte el Acuerdo de cliente de Qlik y haga clic en Descargar. El archivo de configuración de Direct Access gateway (docker-compose.qlik-data-gateway-direct-access.yml) se descargará en su equipo.

Segunda fase: inicie la implementación ejecutando el archivo Docker Compose

Para iniciar la implementación de Direct Access gateway, ejecute el siguiente comando:

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

Etapa tres: Configurar Direct Access gateway

Para obtener instrucciones de configuración detalladas, consulte Etapa tres: configurar Direct Access gateway.

Etapa cuatro: registre la pasarela de datos

El siguiente paso es registrar la pasarela de datos. Esto se puede hacer a través del centro de actividades Administración o en la línea de comandos.

Puede registrar la pasarela utilizando el centro de actividades Administración. Vea Opción 1: desde el centro de actividades Administración.

También puede registrar Direct Access gateway automáticamente desde la línea de comandos, sin utilizar el centro de actividades Administración. Este método utiliza un token de sesión de corta duración generado a partir de un cliente OAuth.

El registro automático solo se admite a través de la línea de comandos. Actualmente no hay disponible una API REST para el registro automático de pasarelas.

Requisitos previos

Una clave de API con permiso de administrador de espacio empresarial inquilino para crear y administrar clientes OAuth.

Registro de la pasarela con registro automático

En primer lugar, debe configurar un entorno de Python para generar un ID de cliente OAuth, así como una clave de aserción (token de corta duración) en el contenedor direct-access-agent. Ejecute los siguientes comandos por separado, en este orden:
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>
Para el último comando de la lista anterior, siga las instrucciones interactivas y copie el client_id (ID de cliente OAuth) y assertion cuando se proporcionen. Guarde estos datos en papel o en un archivo de texto temporal por ahora—son necesarios para pasos posteriores del proceso.
Cuando haya anotado el client_id y assertion, limpie el entorno de Python con el siguiente comando:

deactivate
Establezca el método de consentimiento del cliente de OAuth en de confianza.

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"}]'
Solicite un token de acceso. Esto también activa la creación automática de la cuenta de usuario bot utilizada por la pasarela.

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 informativa
Si la aserción ha caducado, vuelva a ejecutar el script desde el entorno virtual.
Busque el usuario bot creado automáticamente.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>'
Copie el ID de my-bot-client.
Cree un rol "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"]}'
Asigne roles a nivel de espacio empresarial inquilino al usuario 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" } ] } ]'
Obtenga el espacio de Direct Access Gateway.

curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>'
Copie el ID del espacio de Direct Access Gateway.
Añada el usuario bot al espacio con el permiso Puede editar.

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"}'
En caso de que la aserción existente haya caducado, genere una nueva. Ejecute el siguiente comando:

python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Siga los pasos necesarios en el símbolo del sistema. Dado que el cliente OAuth ya está creado, es necesario actualizar JWK mediante esta llamada a la 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>"}]'
Registre la pasarela:

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>

Eliminar una pasarela registrada automáticamente

Siga los pasos siguientes para anular el registro de una pasarela que se registró mediante el método automático basado en token de sesión descrito anteriormente. Estos pasos también eliminan el cliente OAuth, el usuario bot y el rol que se crearon para ella.

Genere una aserción, como se describe en la sección anterior.
Elimine la pasarela de datos:

dotnet ConnectorAgent.dll qcs delete_gateway --tenant_url <tenant-url> --gateway_name <gateway-name> --client-id <client-ID> --assertion <assertion>
Busque la cuenta de usuario bot que se creó para la pasarela de datos.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>'
Copie el ID del bot.
Elimine esta cuenta de usuario bot.

curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>"
Busque el rol “DAG Registration” que se creó para la pasarela de datos.

curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name%20eq%20%22DAG%20Registration%22)" -H "Authorization: Bearer <api-key>"
Copie el ID del rol.
Elimine este rol.

curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID> -H "Authorization: Bearer <api-key>"
Elimine el cliente de 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>

Etapa cinco: inicie el servicio Qlik Data Gateway - Direct Access en el servidor de la pasarela de acceso directo

Para iniciar el servicio Qlik Data Gateway - Direct Access, inicie los contenedores dcaas-dg y direct-access-agent.

Etapa seis: agregue una conexión a su fuente de datos

Vea Etapa seis: agregue una conexión a su fuente de datos.

Configuración del entorno

Esta sección muestra variables de entorno específicas del archivo docker-compose.qlik-data-gateway-direct-access.yml que podría necesitar configurar para conectar correctamente sus fuentes de datos a través de la pasarela.

ALLOW_SOURCES: una lista de elementos permitidos separada por comas de nombres de host e IP. Cuando el agente de la pasarela necesite conectarse a algo en su propio servidor o a otro host en la red local o privada (por ejemplo, una base de datos en localhost, un nombre de servicio de Docker o un host con IP privada), añada esa dirección a ALLOW_SOURCES — de lo contrario se rechazará el intento de conexión.

Fuentes de datos compatibles

Se admiten los siguientes conectores ODBC para instalaciones en contenedores:
- PostgreSQL
- SQL Server
- Oracle
Para más información sobre los conectores ODBC, consulte Bases de datos ODBC ‒ Qlik Cloud (solo en inglés).
Conector REST (REST a través de Direct Access gateway). Para más información sobre las fuentes de datos REST, consulte Fuentes REST ‒ Qlik Cloud (solo en inglés).

Más información

¿Esta página le ha sido útil?

Si encuentra algún problema con esta página o su contenido (errores tipográficos, pasos que faltan o errores técnicos), no dude en ponerse en contacto con nosotros.

Deje aquí sus comentarios