> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/gateway/es/getting-started/devolutions-gateway-configuration-on-linux.md). # Configuración de Devolutions Gateway en Linux Instalar y ejecutar Devolutions Gateway en Linux es rápido y sencillo, siempre que se cumplan varios requisitos previos. Se ha utilizado Ubuntu 22.04 LTS para demostrar la instalación y la configuración. {% hint style="warning" %} Para la configuración se requiere Devolutions Server o Devolutions Cloud, así como una licencia de Devolutions Gateway. {% endhint %} ### Instalar Devolutions Gateway 1. Vaya a la página [Devolutions Gateway GitHub Release](https://github.com/Devolutions/devolutions-gateway/releases/) y descargue el fichero **.deb** de la última versión. 2. Introduzca lo siguiente en la línea de comandos: `wget https://github.com/Devolutions/devolutions-gateway/releases/download/v2024.3.2/devolutions-gateway_2024.3.2.0_amd64.deb` ![](https://cdnweb.devolutions.net/docs/DGW0027_2024_3.png) 3. Instale el paquete con la utilidad `dpkg`: `sudo dpkg -i devolutions-gateway_2024.3.2.0_amd64.deb` ![](https://cdnweb.devolutions.net/docs/DGW0028_2024_3.png)

Los paquetes de configuración y binarios se encuentran en las siguientes ubicaciones:

### Actualizar Devolutions Gateway Para actualizar Devolutions Gateway en Linux, descargue el último paquete como se explica en la sección anterior y ejecute el comando de instalación. El paquete se instalará sobre la instalación existente y conservará las configuraciones. ### Instalar el módulo de PowerShell del gateway Se recomienda utilizar el módulo de PowerShell del gateway para configurar y gestionar la instancia de Devolutions Gateway en Linux. 1. Instale PowerShell con este comando: ```powershell source /etc/os-release wget -q https://packages.microsoft.com/config/ubuntu/$VERSION_ID/packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb sudo apt-get update sudo apt-get install -y powershell ``` 2. Instale el módulo de PowerShell de Devolutions Gateway: ```powershell Install-Module -Name DevolutionsGateway Import-Module -Name DevolutionsGateway ``` Una vez instalado, la configuración de Devolutions Gateway se puede iniciar, detener, ver o modificar. ### Configurar los certificados Una confianza adecuada de los certificados entre sistemas es clave para que Devolutions Gateway funcione. Funciones como WebSockets, utilizadas en las vistas del panel web de RDP, SSH, etc., requieren un certificado correctamente confiable. Un certificado de una autoridad oficial como Let's Encrypt sería lo ideal para la mayoría de los sistemas de producción. Se pueden generar certificados autofirmados, como el ejemplo que se muestra a continuación, pero requieren una configuración adicional para su confianza. Puede generar certificados en cualquier sistema y utilizarlos en Devolutions Gateway si cumplen los requisitos de certificado. #### Generar un certificado LetsEncrypt en Ubuntu 22.04 LTS mediante Certbot Una opción es generar un certificado LetsEncrypt con la utilidad Certbot. Para instalar la última versión, puede utilizar el gestor de paquetes snap. Según la distribución de Ubuntu, los repositorios APT predeterminados pueden no contener la última versión del software. En este ejemplo, se utiliza la verificación de dominio con Cloudflare como proveedor de DNS. 1. El ejemplo siguiente muestra Certbot instalado y ejecutándose como usuario root, pero Devolutions Gateway como un usuario diferente. ```shell sudo snap install certbot --classic sudo snap set certbot trust-plugin-with-root=ok sudo snap install certbot-dns-cloudflare ``` 2. Cuando utilice Cloudflare, genere un token de API con ámbito de usuario o de cuenta, utilizando la plantilla **Edit zone DNS**. Una vez que tenga el token de API, cree la carpeta contenedora y el fichero `.ini` correspondiente para contener el token de API. ```shell sudo install -d -m 0700 /root/.secrets sudo nano /root/.secrets/cloudflare.ini sudo chmod 0600 /root/.secrets/cloudflare.ini ``` 3. Solicite un certificado para su dominio de Devolutions Gateway utilizando el plugin de DNS de Cloudflare. Sustituya el valor `gateway.mydomain.com` que aparece a continuación por su propio dominio. ```shell certbot certonly --dns-cloudflare --dns-cloudflare-credentials /root/.secrets/cloudflare.ini -d gateway.mydomain.com --cert-name gateway ``` 4. Modifique su fichero de configuración `gateway.json` para añadir las siguientes líneas y utilizar el certificado recién generado, usando el módulo de PowerShell de Devolutions Gateway. Los comandos siguientes modifican las variables de configuración `TlsCertificateFile`, `TlsPrivateKeyFile` y `Listeners`. ```powershell Import-Module DevolutionsGateway Set-DGatewayConfig -TlsCertificateFile "/etc/letsencrypt/live/gateway/fullchain.pem" -TlsPrivateKeyFile "/etc/letsencrypt/live/gateway/privkey.pem" -Listeners @( @{ "InternalUrl" = "tcp://*:8181" "ExternalUrl" = "tcp://*:8181" } @{ "InternalUrl" = "https://*:7171" "ExternalUrl" = "https://*:7171" } ) ``` 5. Antes de poder reiniciar Devolutions Gateway para utilizar el nuevo certificado, debe permitir que el usuario que ejecuta Devolutions Gateway lea los ficheros del certificado. Esto supone que su usuario se llama **devolutions** y que el certificado se llama **gateway**. Está concediendo derechos de recorrido a los directorios y derechos de lectura a los propios ficheros del certificado. ```shell sudo setfacl -R -m u:devolutions:x /etc/letsencrypt/live sudo setfacl -R -m u:devolutions:x /etc/letsencrypt/live/gateway sudo setfacl -R -m u:devolutions:x /etc/letsencrypt/archive sudo setfacl -R -m u:devolutions:x /etc/letsencrypt/archive/gateway sudo setfacl -m u:devolutions:r /etc/letsencrypt/live/gateway/fullchain.pem sudo setfacl -m u:devolutions:r /etc/letsencrypt/live/gateway/privkey.pem sudo setfacl -m u:devolutions:r /etc/letsencrypt/archive/gateway/fullchain*.pem sudo setfacl -m u:devolutions:r /etc/letsencrypt/archive/gateway/privkey*.pem # Reconfigure to add a deploy hook sudo certbot reconfigure --cert-name gateway --deploy-hook "sudo setfacl -m u:devolutions:r /etc/letsencrypt/archive/gateway/fullchain*.pem; sudo setfacl -m u:devolutions:r /etc/letsencrypt/archive/gateway/privkey*.pem; systemctl restart devolutions-gateway.service" ``` 6. Reinicie Devolutions Gateway utilizando el comando `systemctl` o el módulo de PowerShell de Devolutions Gateway. ```shell # Restart Gateway using systemctl systemctl restart devolutions-gateway.service ``` ```powershell # Restart Gateway using the Devolutions Gateway PowerShell module, assuming it is run in a pwsh shell. Import-Module DevolutionsGateway; Restart-DGateway ``` **Renovar el certificado LetsEncrypt** De forma predeterminada, con el método de instalación mediante Snap, se utiliza un temporizador de systemd (en lugar de una tarea cron), que se ejecuta dos veces al día (aunque solo renueva un certificado en los 30 días previos a su caducidad). Para forzar una renovación, puede utilizar el comando siguiente. ``` sudo certbot renew # To perform a renewal dry run and force a restart of the service, you can use the following command: # sudo certbot renew --dry-run --run-deploy-hooks ``` #### Generar un certificado autofirmado en Ubuntu 22.04 LTS mediante OpenSSL Con la utilidad OpenSSL, genere un certificado directamente desde la línea de comandos. A continuación, el certificado debe colocarse directamente en el directorio de configuración **/etc/devolutions-gateway**. ![](https://cdnweb.devolutions.net/docs/DGW0029_2024_3.png) ```powershell sudo openssl req -x509 -subj "/C=CA/ST=Quebec/L=Lavaltrie/O=Devolutions/CN=ubuntu-2204" -addext "subjectAltName = IP:10.10.0.20" -addext "extendedKeyUsage = serverAuth" -nodes -days 365 -newkey rsa:2048 -keyout /etc/devolutions-gateway/server.key -out /etc/devolutions-gateway/server.crt ``` La solicitud de certificado será diferente en cada configuración. Tenga en cuenta que el certificado **debe** incluir una extensión **Subject Alternative Name (SAN)** con un **nombre DNS** o una **dirección IP**, y también debería contener la extensión **Extended Key Usage (EKU)** con la finalidad **Server Authentication** (`serverAuth`). Esto es necesario porque los sistemas operativos y navegadores modernos, incluidos **Google Chrome** y **macOS,** rechazarán los certificados que carezcan de un SAN o del EKU adecuado, incluso si el Common Name (CN) está definido. Es posible relajar este requisito estableciendo la opción `TlsVerifyStrict` en `false` si es necesario, pero no se recomienda.
Opciones de personalizaciónExplicación
reqCrear y procesar solicitudes de certificado, incluidos certificados autofirmados en formato PKCS#10.
-x509Genera un certificado autofirmado.
-subj

Define el asunto del certificado en la línea de comandos. No debe haber espacios entre las secciones

  • /C - País en código de 2 dígitos, como «CA» para Canadá o «US» para Estados Unidos.
  • /ST - Estado o provincia, como Quebec o California.
  • /L - Localidad, como Lavaltrie o Sacramento.
  • /O - Organización, como Devolutions o Microsoft.
  • /CN - Nombre común, aquí ubuntu-2204 (como se muestra mediante el comando hostname).
-addext

Para añadir un Subject Alternate Name (SAN), puede utilizar este parámetro para definir una entrada de IP o de DNS.

  • "subjectAltName = IP:10.10.0.20"
  • "subjectAltName = DNS:ubuntu-2204"
-nodesNo cifrar la clave privada creada.
-daysEl número de días que el certificado es válido.
-newkeyDefine el algoritmo y el tamaño en bits, aquí se utiliza rsa:2048.
-keyoutLa ubicación donde crear el fichero de clave privada.
-outLa ubicación donde crear el fichero de clave pública.
#### Confiar en el certificado autofirmado en Ubuntu El certificado TLS tiene dos finalidades: 1. Proteger la API de gestión; 2. Proteger cualquier túnel de cliente a Gateway en el que el gateway pueda inspeccionar o filtrar el tráfico (sitios web, Gateway Tunnel, SCP/SFTP, etc.).\ Para protocolos opacos como RDP o SSH, Devolutions Gateway simplemente reenvía bytes ya cifrados, pero el certificado sigue siendo necesario para las comprobaciones de estado del gateway y para funciones futuras. Una vez creado el certificado autofirmado, será necesario confiar en el certificado dentro del sistema Ubuntu. Para confiar en él en todo el sistema, utilice el siguiente conjunto de comandos: ```powershell cd /etc/devolutions-gateway sudo apt-get install -y ca-certificates sudo cp server.crt /usr/local/share/ca-certificates sudo update-ca-certificates ``` ![](https://cdnweb.devolutions.net/docs/DGW0030_2024_3.png) Es posible que `ca-certificates` ya esté instalado. Al ejecutar el comando `update-ca-certificates` se creará un enlace simbólico en `/etc/ssl/certs` al fichero de certificado copiado en **/usr/local/share/ca-certificates**. ![](https://cdnweb.devolutions.net/docs/DGW0031_2024_3.png) {% hint style="warning" %} Si esto se hace en Firefox, aparecerán múltiples errores de confianza, ya que el navegador no utiliza el almacén de certificados del sistema. Su [documentación](https://support.mozilla.org/en-US/kb/setting-certificate-authorities-firefox) ofrece algunas soluciones para ello. {% endhint %} #### Confiar en el certificado autofirmado en Windows Después de crear el certificado autofirmado, será necesario confiar en él en Devolutions Server. Los ficheros **server.crt** y **server.key** deberán transferirse al sistema Windows; o bien copie y pegue su contenido en ficheros (es decir, **sudo cat server.crt** en Ubuntu y copiarlo en un fichero de texto en Windows). {% hint style="warning" %} Omita esta sección si Devolutions Server no se ejecuta en Windows. {% endhint %} 1\. Copie la clave pública a Windows (en el ejemplo, **C:\Gateway** es una ubicación temporal):\ `sudo cat server.crt` ![](https://cdnweb.devolutions.net/docs/DGW0032_2024_3.png) 2. Copie el contenido en un fichero **server.crt**. ![](https://cdnweb.devolutions.net/docs/DGW0064_2024_3.png) 3. Copie la clave privada a Windows:\ `sudo cat server.key` ![](https://cdnweb.devolutions.net/docs/DGW0034_2024_3.png) 4. Copie el contenido en un fichero **server.key**. ![](https://cdnweb.devolutions.net/docs/DGW0065_2024_3.png) 5. Cree un fichero PFX utilizando la herramienta de línea de comandos certutil de Windows. Para que esto funcione, el fichero de clave debe tener el mismo nombre que el fichero **crt**, diferenciándose solo en la extensión:\ `certutil -mergepfx server.crt server.pfx` ![](https://cdnweb.devolutions.net/docs/DGW0036_2024_3.png) 6. Importe el fichero PFX en el [almacén de certificados Entidades de certificación raíz de confianza](https://learn.microsoft.com/en-us/windows-hardware/drivers/install/trusted-root-certification-authorities-certificate-store). 1. Haga doble clic en el fichero **server.pfx** para iniciar el asistente de importación y elija ***Equipo local***. 2. Haga clic en ***Siguiente*** y acepte el aviso. ![](https://cdnweb.devolutions.net/docs/DGW0037_2024_3.png) 3. Haga clic en ***Siguiente***. ![](https://cdnweb.devolutions.net/docs/DGW0038_2024_3.png) 4. Introduzca la contraseña que indicó con el comando `certutil`. * Opcionalmente: elija ***Marcar esta clave como exportable***. ![](https://cdnweb.devolutions.net/docs/DGW0039_2024_3.png) 5. Elija la opción ***Colocar todos los certificados en el siguiente almacén***. 6. Seleccione ***Entidades de certificación raíz de confianza*** con el botón ***Examinar...***. 7. Haga clic en ***Siguiente***. ![](https://cdnweb.devolutions.net/docs/DGW0040_2024_3.png) 8. Haga clic en ***Finalizar*** para completar la importación. ### Abrir los puertos del cortafuegos de Ubuntu Si el sistema Linux utiliza UFW (Uncomplicated Firewall) para gestionar el cortafuegos basado en iptables, ejecute los siguientes comandos para abrir los puertos necesarios: ```powershell sudo ufw status sudo ufw allow 7171 sudo ufw allow 8181 sudo ufw status ``` ![](https://cdnweb.devolutions.net/docs/DGW0041_2024_3.png) ### Modificar la configuración de Devolutions Gateway La configuración predeterminada de un gateway contenida en el fichero **/etc/devolutions-gateway/gateway.json** necesita que se añadan las directivas del certificado (el `InternalUrl` deberá utilizar HTTPS): ```powershell { "Id": "YOUR-UNIQUE-GUID", "ProvisionerPublicKeyFile": "provisioner.pem", "ProvisionerPrivateKeyFile": null, "Listeners": [ { "InternalUrl": "tcp://:8181", "ExternalUrl": "tcp://:8181" }, { "InternalUrl": "http://:7171", "ExternalUrl": "https://:7171" } ] } ``` Modifique el fichero anterior para que refleje lo siguiente, suponiendo que tanto **server.crt** como **server.key** se encuentran en el mismo directorio que **gateway.json** (se recomienda utilizar el editor de ficheros integrado Nano): ```powershell { "Id": "YOUR-UNIQUE-GUID", "ProvisionerPublicKeyFile": "provisioner.pem", "ProvisionerPrivateKeyFile": null, "TlsCertificateFile": "server.crt", "TlsPrivateKeyFile": "server.key", "Listeners": [ { "InternalUrl": "tcp://:8181", "ExternalUrl": "tcp://:8181" }, { "InternalUrl": "https://:7171", "ExternalUrl": "https://:7171" } ] } ``` ![](https://cdnweb.devolutions.net/docs/DGW0042_2024_3.png) #### Reiniciar Devolutions Gateway Con la nueva configuración en su lugar, reinicie Devolutions Gateway. Esto se puede hacer con el comando `systemctl`: ```powershell sudo systemctl restart devolutions-gateway.service sudo systemctl status devolutions-gateway.service ``` ![](https://cdnweb.devolutions.net/docs/DGW0046_2024_3.png) Como alternativa, también se pueden utilizar los comandos de PowerShell `Stop-DGateway` y `Start-DGateway`. ### Conectar Devolutions Gateway a Devolutions Server #### Copiar la clave pública de Devolutions Server a Devolutions Gateway en Linux 1. Inicie sesión en la consola web de Devolutions Server y vaya a ***Administración***** – *****Devolutions Gateway***. 2. Haga clic en el botón ***Más*** y elija la opción ***Descargar clave pública***. ![](https://cdnweb.devolutions.net/docs/DGW0049_2024_3.png) 3. Copie el contenido del fichero **gateway\_public\_key.pem** descargado en Windows. ![](https://cdnweb.devolutions.net/docs/DGW0066_2024_3.png) 4. Sustituya el contenido del fichero **/etc/devolutions-gateway/provisioner.pem** (se recomienda la utilidad Nano) por el contenido copiado desde Windows. ![](https://cdnweb.devolutions.net/docs/DGW0045_2024_3.png) 5. Reinicie Devolutions Gateway con el comando `sudo systemctl restart devolutions-gateway.service`. ![](https://cdnweb.devolutions.net/docs/DGW0046_2024_3.png) #### Configurar Devolutions Gateway en Devolutions Server Vaya a la interfaz web de Devolutions Server donde se añadirá el Devolutions Gateway de Linux recién configurado. {% hint style="warning" %} Omita esta sección si está instalando Devolutions Gateway con Devolutions Cloud. {% endhint %} 1. Inicie sesión en la consola web de Devolutions Server y navegue a ***Administration*** – ***Devolutions Gateway***. 2. Haga clic en el botón ***Add*** (***+***). 3. Seleccione ***Gateway***. ![](https://cdnweb.devolutions.net/docs/DGW0047_2024_3.png) 4. Introduzca lo siguiente (esto variará según la configuración). 1. ***Name***: Linux Gateway 2. ***Devolutions Gateway URL***: `https://10.10.0.20:7171` 3. ***TCP Hostname***: `Ubuntu-2204` 5. Haga clic en ***Save***. ![](https://cdnweb.devolutions.net/docs/DGW0050_2024_3.png)

Haga clic en el menú de opciones More del gateway y elija la opción Publish revocation list si la lista de revocación está desactualizada.

![](https://cdnweb.devolutions.net/docs/DGW0048_2024_3.png) ### Resolver hosts en Ubuntu El sistema Devolutions Gateway alojado en Linux debe poder resolver las direcciones solicitadas por Devolutions Server. El método más sencillo para realizar pruebas es modificar el fichero hosts. Conéctese al siguiente sistema: * **Hostname**: `it-help-dc` * **Nombre de dominio completo (FQDN)**: `it-help-dc.ad.it-help.ninja` * **Dirección IP**: `10.10.0.3` Abra el fichero hosts para editarlo con `sudo nano /etc/hosts` para añadir el host en Ubuntu. ![](https://cdnweb.devolutions.net/docs/DGW0052_2024_3.png) ### Abrir una sesión RDP basada en web El gateway ya puede conectarse a hosts. Dado que el host `it-help-dc` se añadió como resoluble en Ubuntu, puede utilizarse para conectarse en una sesión basada en web. {% hint style="info" %} Las sesiones basadas en web requieren un gateway activo configurado para la entrada y el usuario que la inicie necesitará una licencia asignada de Remote Desktop Manager edición Team o una licencia de Devolutions Launcher. Además, si se han realizado cambios en las asignaciones de licencias, puede ser necesario cerrar la sesión y volver a iniciarla para ver la opción de lanzar la conexión basada en web. {% endhint %} 1. En la interfaz web de Devolutions Server haga clic en ***Add***. Seleccione una entrada de sesión ***RDP***. 2. Haga clic en ***Continue***. ![](https://cdnweb.devolutions.net/docs/DGW0053_2024_3.png) 3. Introduzca un ***Name*** y un ***Host*** que deben ser resolubles por la instalación de Devolutions Gateway en Linux. 4. Haga clic en ***Add***. ![](https://cdnweb.devolutions.net/docs/DGW0054_2024_3.png) 5. Introduzca o vincule las credenciales necesarias a la sesión RDP y haga clic en ***Add***. ![](https://cdnweb.devolutions.net/docs/DGW0055_2024_3.png) 6. En la pestaña ***VPN/Tunnel/Gateway*** elija Devolutions Gateway como tipo de VPN. 7. Establezca la opción ***Connect*** en ***Always connect***. 8. Elija el gateway correcto. 9. Haga clic en ***Add***. ![](https://cdnweb.devolutions.net/docs/DGW0056_2024_3.png) 10. Haga clic en ***Open in web client***. ![](https://cdnweb.devolutions.net/docs/DGW0069_2024_3.png) ### Abrir una sesión RDP de Remote Desktop Manager Si la entrada ya está configurada desde la interfaz web de Devolutions Server, puede lanzarse desde Remote Desktop Manager cuando esté conectado al workspace de Devolutions Server. {% hint style="warning" %} Omita esta sección si está instalando Devolutions Gateway con Devolutions Cloud. {% endhint %} Al crear una nueva entrada desde Remote Desktop Manager, el proceso es similar al de Devolutions Server. 1. En Remote Desktop Manager, haga clic en ***New entry***. Seleccione una entrada de sesión RDP. 2. Haga clic en ***Select***. ![](https://cdnweb.devolutions.net/docs/DGW0058_2024_3.png) 3. Introduzca un ***Name*** y un ***Host*** que deben ser resolubles por la instalación de Devolutions Gateway en Linux. 4. Introduzca o vincule las credenciales necesarias a la sesión RDP. ![](https://cdnweb.devolutions.net/docs/DGW0067_2024_3.png) 5. Establezca la opción ***Connect*** en ***Always connect***. 6. En la pestaña ***VPN/Tunnel/Gateway*** elija Devolutions Gateway como tipo de VPN. ![](https://cdnweb.devolutions.net/docs/DGW0068_2024_3.png) 7. Vaya a la subpestaña ***Settings (Devolutions Gateway)***. 8. Elija el Devolutions Gateway deseado. 9. Haga clic en ***Add***. ![](https://cdnweb.devolutions.net/docs/DGW0061_2024_3.png) 10. Haga clic en el botón ***Open session***.

Al pasar el cursor por la barra de título aparecerá un tooltip que mostrará que el RDP está conectado a través de Devolutions Gateway.

![](https://cdnweb.devolutions.net/docs/DGW0062_2024_3.png) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/gateway/es/getting-started/devolutions-gateway-configuration-on-linux.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.