# Configurar Qlik Pasarela de datos - Acceso directo en un servidor Windows Este tema describe cómo configurar Qlik Pasarela de datos - Acceso directo en un servidor Windows. Proporciona los requisitos previos y las instrucciones de instalación, y describe las limitaciones y consideraciones que debe tener en cuenta al trabajar con Qlik Pasarela de datos - Acceso directo en un servidor Windows. ## Buenas prácticas en el uso de Qlik Pasarela de datos - Acceso directo Para disfrutar de una experiencia satisfactoria al utilizar Qlik Pasarela de datos - Acceso directo, 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 servidor que esté lo más cerca posible de su fuente de datos. * Direct Access gateway debe instalarse en un servidor Windows específico, tal como se estipula en los requisitos del sistema a continuación. No lo instale en el servidor de base de datos real ni junto con otros productos de Qlik, incluidos, entre otros, Qlik DataTransfer, Qlik Sense Desktop y Qlik Sense Enterprise. ## Requisitos previos del sistema Esta sección describe los requisitos de software, puertos y hardware para usar Qlik Pasarela de datos - Acceso directo en un servidor Windows. ### Requisitos previos de software * La puerta de enlace de acceso directo debe instalarse en una máquina con Windows Server detrás de su firewall. El servidor debería poder acceder a su fuente de datos. Ediciones de Windows Server compatibles: * 2016 * 2019 * 2022 * 2025 Windows Server 2025 requiere Qlik Pasarela de datos - Acceso directo 1.7.0 o posterior. * Es necesario instalar tres versiones diferentes de .NET. Instale únicamente las siguientes versiones de .NET: * .NET 4.8 se requiere para la instalación. * .NET 6.0.x Runtime (x64) y ASP.NET Core Runtime 6.0.x (x64) (último parche) Nota de prensaDesde Direct Access gateway 1.6.8, ya no se requiere .NET 6.0.x * .NET 8.0.x Runtime (x64) y ASP.NET Core Runtime 8.0.x (x64) (último parche) Nota informativa * No se admite la instalación de versiones de tiempo de ejecución de .NET superiores a 8.0.x. * Direct Access gateway 1.6.6 y 1.6.7 requiere ambas versiones: 6.0.x y 8.0.x de los tiempos de ejecución de .NET y ASP.NET Core. Si desea saber cómo comprobar la versión de .NET actualmente instalada, vea https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed. * Microsoft Visual C++ 2015-2022 Redistribuible (x64). La configuración de Direct Access gateway le pedirá que instale el redistribuible si detecta que no está instalado actualmente. #### Requisitos previos de software adicionales al utilizar fuentes de datos de SAP * Instale el SDK SAP NetWeaver RFC en la máquina de Qlik Pasarela de datos - Acceso directo, como se describe en [Instalación de SAP NetWeaver RFC SDK para la Pasarela de datos de Qlik de acceso directo](https://help.qlik.com/en-US/cloud-services/Subsystems/SAP_Connectors_Help/Content/Connectors_SAP/Installation/Installing-sap-connectors-for-direct-access-gw.htm) (solo en inglés). * Instale Microsoft Visual C++ 2013 Redistributable (x64) en la máquina Qlik Pasarela de datos - Acceso directo. ### Puertos y protocolos requeridos Para conocer los puertos y protocolos requeridos, consulte [Puertos y protocolos requeridos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Ports). ### Hardware recomendado * 8 núcleos * 32 GB de memoria * 5 GB de almacenamiento #### Hardware mínimo El hardware mínimo solo es adecuado para escenarios específicos que utilicen implementaciones de servidores específicos más pequeños (desarrollo, pruebas o producción), con volúmenes de datos continuamente bajos y un número limitado de recargas simultáneas. * 4 núcleos * 8 GB de memoria * 5 GB de almacenamiento Es posible que se necesiten más recursos para poder procesar de forma coherente volúmenes de datos cada vez mayores y recuentos más elevados de recargas simultáneas. El punto en el que el rendimiento se vuelve inaceptable depende del caso de uso y de la configuración dentro de cada entorno único. ### Criptografía del sistema Qlik Cloud Government admite el uso de Qlik Data Gateway - Direct Access solo cuando Windows está configurado para ejecutarse en un modo de funcionamiento aprobado por FIPS 140-2 (modo FIPS). Para activar el modo FIPS, habilite la política de Windows: [Criptografía del sistema: Utilice algoritmos compatibles con FIPS para cifrado, hash y firmas](https://learn.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/system-cryptography-use-fips-compliant-algorithms-for-encryption-hashing-and-signing). Para más información, vea el paso 3 del procedimiento [Uso de Windows en un modo de funcionamiento aprobado por FIPS 140-2](https://learn.microsoft.com/en-us/windows/security/threat-protection/fips-140-validation#using-windows-in-a-fips-140-2-approved-mode-of-operation). Nota informativaNo se necesita instalar módulos adicionales. Qlik Data Gateway - Direct Access utilizan solo los módulos ya proporcionados por Windows e incluidos en la [lista de módulos validados](https://learn.microsoft.com/en-us/windows/security/threat-protection/fips-140-validation#microsoft-fips-140-2-validated-cryptographic-modules). Los módulos Qlik Data Gateway - Direct Access obligan a utilizar únicamente algoritmos criptográficos validados por FIPS a través de .NET Runtime. ## Instalar Qlik Pasarela de datos - Acceso directo 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. Nota informativaLos 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. Pasos de configuración de Qlik Pasarela de datos - Acceso directo — Instalación en un servidor Windows Pasos de configuración de Qlik Pasarela de datos - Acceso directo — Instalación en un servidor Windows Pasos de configuración de Qlik Pasarela de datos - Acceso directoQlik Pasarela de datos - Acceso directo — Instalación en un servidor WindowsWindows ![Diagrama de flujo de la pasarela de datos de acceso directo: pasos de configuración para la configuración en un servidor Windows.](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Resources/Images/direct-access-gateway_setup.png) ### Etapa uno: Descargar Qlik Pasarela de datos - Acceso directo 1. 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](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing-console.htm#gateprop). 2. Haga clic en el botón de la barra de herramientas Implementar. Se abre el cuadro de diálogo Implementar la pasarela de datos. 3. Seleccione Pasarela de datos - Direct Access (Windows), acepte el Acuerdo de cliente de Qlik y haga clic en Descargar. El archivo de configuración de la pasarela Direct Access gateway (qlik-data-gateway-direct-access.exe) se descargará en su equipo. ### Segunda etapa: instale Direct Access gateway en un servidor situado detrás del cortafuegos que protege sus fuentes de datos. Esta etapa consiste en instalar Direct Access gateway. Puede instalar Direct Access gateway de forma interactiva o silenciosa. Nota informativaDesinstalar Direct Access gateway no elimina la configuración. En otras palabras, si desinstala una versión de Direct Access gateway y luego instala una versión diferente, la versión recién instalada utilizará la misma configuración que la versión desinstalada. Nota informativaPara anular la cuenta de servicio predeterminada de Windows se requiere Direct Access gateway 1.7.4 o posterior. #### Instalar Direct Access gateway de forma interactiva 1. Cuando se complete la descarga, copie el archivo de instalación en una máquina con Windows Server detrás del firewall. Asegúrese de que la máquina pueda comunicarse con sus fuentes de datos. 2. Abra el archivo qlik-data-gateway-direct-access.exe para iniciar el asistente de configuración. Nota informativa * Direct Access gateway requiere Microsoft .NET 6.x y .NET 8.x. Si el programa de instalación detecta que hay instalada una versión anterior, se le pedirá que instale la versión que precisa. Cuando se complete la instalación de .NET, deberá reiniciar la máquina de Direct Access gateway y luego ejecutar la instalación de Direct Access gateway nuevamente. * El programa de instalación le pedirá que instale Microsoft Visual C++ 2015-2022 Redistribuible (x64) si detecta que no está instalado actualmente. Nota informativa * Durante la configuración, puede anular opcionalmente los siguientes valores predeterminados: * La ruta de instalación(C:\Archivos de programa\Qlik\ConnectorAgent). * La cuenta de servicio de Windows bajo la que se instalará Direct Access gateway(LocalSystem). La cuenta de servicio especificada debe tener tanto el derecho "Abrir sesión como servicio" como el permiso de escritura "Write" en la carpeta de instalación de la pasarela de datos Direct Access gateway. 3. Pulse Siguiente hasta que se complete la configuración. #### Instalar, actualizar y desinstalar Direct Access gateway de forma silenciosa Nota informativaPosible desde la versión Direct Access gateway 1.6.4. Instalar Direct Access gateway de forma silenciosa es útil, por ejemplo, si necesita realizar la instalación de Direct Access gateway en varias máquinas de su organización. Si es necesario, también puede anular la cuenta de servicio predeterminada de Windows(LocalSystem). Requisitos previos Asegúrese de instalar las versiones correctas de todo el [software necesario](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software) antes de comenzar la instalación silenciosa ya que, a diferencia de la instalación interactiva, esto no se puede hacer durante la instalación. Instalar o actualizar Direct Access gateway Abra un mensaje de CMD como administrador y ejecute el siguiente comando desde la carpeta que contiene el ejecutable Direct Access gateway: qlik-data-gateway-direct-access.exe /S InstallPath="full-path" AcceptEula=yes Donde full-path debe reemplazarse por la ruta de instalación real entre comillas dobles, por ejemplo, "C:\TMP\Qlik". Nota informativaEs necesario configurar el parámetro AcceptEula en "sí". Al configurar el parámetro AcceptEula en "sí", acepta los términos del [Acuerdo de Qlik](https://www.qlik.com/us/legal/legal-agreements) con el cliente. Anular la cuenta de servicio predeterminada de Windows De manera predeterminada, Direct Access gateway se instala bajo la cuenta de servicio de Windows LocalSystem . Para instalar Direct Access gateway bajo una cuenta diferente, incluya los siguientes parámetros en su comando: * ServiceAccount: el nombre de la cuenta de servicio. Nota informativaLa cuenta de servicio especificada debe tener tanto el derecho "Abrir sesión como servicio" como el permiso de escritura "Write" en la carpeta de instalación de la pasarela de datos Direct Access gateway. * ServicePassword: la contraseña de la cuenta de servicio especificada. Ejemplo de comando con parámetros para anular la cuenta de servicio de Windows qlik-data-gateway-direct-access.exe /S InstallPath="C:\TMP\Qlik" AcceptEula=yes ServiceAccount="qliktech.com\user" ServicePassword=kZmbkb8m8BGGz91 Desinstalar Direct Access gateway Abra un mensaje de CMD como administrador y ejecute el siguiente comando desde la carpeta que contiene el ejecutable Direct Access gateway: qlik-data-gateway-direct-access.exe /S /uninstall #### Solución de problemas en la instalación Los archivos de registro de la instalación pueden ser útiles para solucionar problemas con la instalación o la actualización: Desde Direct Access gateway 1.7.7, la ruta completa a los archivos de registro es: <carpeta de instalación de Direct Access gateway>\data\logs\\_<TimestampQlik Pasarela de datos - Acceso directo>.log Si su versión de Direct Access gateway es anterior a la 1.7.7, la ruta completa a los archivos de registro es: C:\Users\<user>\AppData\Local\Temp\\_<TimestampQlik Pasarela de datos - Acceso directo>.log ### Etapa tres: Configurar Direct Access gateway Para obtener instrucciones de configuración detalladas, consulte [Etapa tres: configurar Direct Access gateway](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage3). ### 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. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm) #### Opción 1: desde el centro de actividades Administración Puede registrar la pasarela utilizando el centro de actividades Administración. Vea [Opción 1: desde el centro de actividades Administración](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#StageConsole). [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm) #### Opción 2: registro automático mediante la línea de comandos 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. Nota informativaEl 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. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)Registro de la pasarela con registro automático 1. Genere una clave JSON Web Key (JWK) en la máquina de Direct Access gateway. Este comando crea claves privadas en la máquina de Direct Access gateway: ConnectorAgent.exe qcs generate\_jwk 2. Copie la JWK que devuelve el comando. 3. Utilizando la clave de API, cree un cliente OAuth para la pasarela a través de la API de administración del espacio empresarial inquilino, proporcionando la JWK que copió en el paso anterior. curl "https://<tenant-url>/api/v1/oauth-clients" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <api-key>' -d '{"appType":"web","clientName":"<client-name>","description":"","allowedScopes":["admin.direct-access-gateways:register\_gateway","admin.direct-access-gateways:delete\_gateway"],"allowedAuthMethods":["private\_key\_jwt"],"publicKeys":[<jwk>],"allowedGrantTypes":["client\_credentials"]}' 4. Copie el valor client\_id devuelto en la respuesta. 5. Establezca el método de consentimiento del cliente OAuth como 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"}]' 6. Cree una aserción de registro en la máquina Direct Access gateway: ConnectorAgent.exe qcs generate\_registration\_assertion --tenant\_url <tenant-url> --client-id <client-id> 7. 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" 8. Busque el usuario bot creado automáticamente. curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>' 9. Copie el ID de my-bot-client. 10. 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"]}' 11. 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" } ] } ]' 12. Obtenga el espacio de Direct Access Gateway. curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>' 13. Copie el ID del espacio de Direct Access Gateway. 14. 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"}' 15. En caso de que la aserción existente haya caducado, genere una nueva. ConnectorAgent.exe qcs generate\_registration\_assertion --tenant\_url <tenant-url> --client-id <client-ID> 16. Registre la pasarela: ConnectorAgent.exe qcs register\_gateway --tenant\_url <tenant-url> --gateway\_name <gateway-name> --gateway\_description <gateway-description> --space\_name <space-name> --client-id <client-ID> --assertion <assertion> [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)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. 1. Genere una aserción, tal y como se describe en el [paso seis de Registro automático de pasarela de datos mediante un token de sesión](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#AutoRegister). 2. Elimine la pasarela de datos: ConnectorAgent.exe qcs delete\_gateway --tenant\_url <tenant-url> --gateway\_name <gateway-name> --client-id <client-ID> --assertion <assertion> 3. Elimine el JWK. ConnectorAgent.exe qcs delete\_jwk 4. Busque la cuenta de usuario de bot que se creó para la pasarela. curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>' 5. Copie el ID del bot. 6. Elimine esta cuenta de usuario bot. curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>" 7. Busque el rol “DAG Registration” que se creó para la pasarela de datos. curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name eq \"DAG Registration\")" -H "Authorization: Bearer <api-key>" 8. Copie el ID del rol. 9. Elimine este rol. curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID>" -H "Authorization: Bearer <api-key>" 10. Elimine el cliente de OAuth. curl -X DELETE "https://<tenant-url>/api/v1/oauth-clients/<client-ID>" -H "qlik-confirm-delete: <client-ID>" -H "Authorization: Bearer <api-key>" ### Etapa cinco: Inicie el servicio Qlik Pasarela de datos - Acceso directo en el servidor de la pasarela de acceso directo En el servidor de puerta de enlace de Acceso directo, realice una de las siguientes acciones para iniciar el servicio: * Abra la consola de Servicios de Windows e inicie el servicio Qlik Pasarela de datos - Acceso directo. * Abra un símbolo del sistema como administrador y cambie el directorio de trabajo a la subcarpeta ConnectorAgent (C:\Archivos de programa\Qlik\ConnectorAgent\ConnectorAgent con una instalación predeterminada). Luego, ejecute. el siguiente comando: connectoragent service start Se mostrará una confirmación de que el servicio se inició correctamente. Vea también: [Ejecutar el servicio con una cuenta diferente](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Running) ### Etapa seis: Agregue una conexión a su fuente de datos Vea [Etapa seis: Agregue una conexión a su fuente de datos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage6). ## Fuentes de datos compatibles Los siguientes conectores ODBC son compatibles con las instalaciones de servidor de Windows: * Fuentes ODBC. Para más información, consulte [Bases de datos ODBC - Qlik Cloud](https://help.qlik.com/en-US/cloud-services/Subsystems/ODBC_Connector_help/Content/Connectors_ODBC/Introduction/ODBC-connector.htm) (solo en inglés). * Fuentes REST. Para más información, consulte [Fuentes REST - Qlik Cloud](https://help.qlik.com/en-US/cloud-services/Subsystems/REST_Connector_help/Content/Connectors_REST/REST-connector.htm) (solo en inglés). * Fuentes SAP BW, SAP SQL y SAP ODP. Requiere Direct Access gateway 1.2.0 o posterior. Para obtener información sobre cómo configurar la conectividad con estas fuentes, consulte [SAP NetWeaver](https://help.qlik.com/en-US/cloud-services/Subsystems/SAP_Connectors_Help/Content/Connectors_SAP/SAP-SQL-connector.htm) (solo en inglés). ## Más información * [Configurar Qlik Pasarela de datos - Acceso directo](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm) * [Configurar Qlik Pasarela de datos - Acceso directo en un contenedor](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm)