Guía completa: Instalación de Passbolt en Debian paso a paso

por

Requisitos previos y preparación para instalar Passbolt en Debian 13

Instalar Passbolt en un servidor Debian 13 requiere una preparación minuciosa y el conocimiento de los componentes esenciales para garantizar una configuración exitosa. Passbolt es una solución de código abierto dedicada a la gestión segura de contraseñas de equipo, basada en OpenPGP para proporcionar un cifrado robusto. Antes de comenzar, es importante asegurarse de que el sistema Debian esté actualizado y listo para alojar esta exigente aplicación.

Primero, conéctese a su máquina Debian 13 mediante la línea de comandos con una cuenta que tenga privilegios de sudo o acceso root. Dominar la línea de comandos es esencial para seguir este tutorial y aplicar correctamente cada paso.

  • Un elemento clave de esta instalación es la herramienta `curl`, utilizada para descargar archivos de internet. Debian no instala curl automáticamente, por lo que debe instalarse: `apt-get update`: actualiza la lista de paquetes disponibles. `apt-get install curl`: instala curl en el sistema.
  • Passbolt también requiere la instalación de MariaDB, que funcionará como base de datos local, y Nginx como servidor web.

Otro paso preliminar esencial es verificar que el sistema sea compatible con conexiones TLS seguras, ya que la seguridad es fundamental para el uso de Passbolt. Si bien es posible agregar un certificado posteriormente, administrar un certificado TLS garantiza la confianza y evita que se intercepten las comunicaciones entre los usuarios y el servidor.

Además, el entorno Debian 13 debe contar con al menos 2 GB de RAM para un funcionamiento óptimo, especialmente si varios usuarios accederán al administrador simultáneamente. En cuanto al espacio en disco, se recomiendan aproximadamente 10 gigabytes para almacenar bases de datos y copias de seguridad.

Finalmente, aquí tienes una lista de requisitos previos para una instalación sin problemas:

  • Debian 13 actualizado y accesible mediante SSH.
  • Cuenta de usuario root o usuario con privilegios sudo.
  • Curl instalado.
  • Servidores web MariaDB y Nginx accesibles.

Nombre de dominio o dirección IP pública/privada configurada para el acceso al servidor.

Acceso a la terminal y conocimientos básicos de administración de servidores Linux. Planifica una estrategia de copia de seguridad de datos.

  • Esta lista constituye la base para una instalación completa de Passbolt, un paso hacia una mayor autonomía gracias al software libre y el control total sobre la seguridad de tus contraseñas.
  • Procedimiento detallado para instalar Passbolt en un servidor Debian: añadir repositorios e instalación.

Passbolt Community Edition (CE) se puede instalar de forma muy eficiente utilizando los repositorios oficiales proporcionados por el equipo del proyecto. Esto simplifica enormemente la gestión de actualizaciones y dependencias mediante APT. El proceso comienza descargando un script específico que añade el repositorio necesario a la lista de fuentes de paquetes de Debian.

  • El script, `passbolt-repo-setup.ce.sh`, es accesible mediante curl, junto con un archivo de suma de comprobación SHA512 para verificar la integridad y seguridad de los archivos descargados. Usar esta verificación es crucial, especialmente para prevenir cualquier vulneración al obtener paquetes esenciales.

  • Descargue los dos archivos: `curl -LO https://download.passbolt.com/ce/installer/passbolt-repo-setup.ce.sh`
  • `curl -LO https://github.com/passbolt/passbolt-dep-scripts/releases/latest/download/passbolt-ce-SHA512SUM.txt`

Verifique la integridad y agregue el repositorio: `sha512sum -c passbolt-ce-SHA512SUM.txt && bash ./passbolt-repo-setup.ce.sh ||` echo «Suma de comprobación incorrecta. Abortando» && rm -f passbolt-repo-setup.ce.sh

  • Este comando valida el archivo de script mediante el hash SHA512 y lo ejecuta solo si todo es correcto. Esto evita la instalación de paquetes maliciosos o dañados. Al agregar el repositorio, la lista de paquetes se actualiza automáticamente.
  • A continuación, instale el paquete Passbolt Community Edition:
  • `apt install passbolt-ce-server` La instalación le mostrará un asistente interactivo. Este asistente le solicitará la configuración para conectar Passbolt a la base de datos MariaDB. El objetivo es:

Crear un usuario dedicado de Passbolt en MariaDB. Establecer una contraseña segura para este usuario.

Crear una base de datos utilizada exclusivamente para almacenar contraseñas y metadatos de Passbolt.

El siguiente paso es configurar el servidor web Nginx. Passbolt ofrece la opción de automatizar esta configuración para facilitar el despliegue de la aplicación en el dominio o la dirección IP deseados.

Un último punto importante en este asistente se refiere al certificado TLS: tiene tres opciones:

Ninguno: omitir la configuración de TLS; realizarla más tarde.

  • Manual: proporcionar un certificado y una clave privada obtenidos previamente. Automático
  • : Permite que el sistema intente la generación automática mediante Let’s Encrypt (requiere acceso público). Elegir la opción automática es una excelente solución si el servidor es accesible desde internet. Para uso interno, gestionar manualmente un certificado corporativo suele ser más seguro. Por último, no olvide proteger la base de datos MariaDB con el script integrado mysql_secure_installation
  • o
  • mariadb-secure-installation
  • que elimina los usuarios anónimos y restringe el acceso a la cuenta de administrador.
  • https://www.youtube.com/watch?v=6yT4597tjkY

Garantizar la seguridad de un gestor de contraseñas es fundamental. El uso de un certificado TLS no solo establece una conexión cifrada entre el cliente y el servidor, sino que también verifica que la comunicación se realice con el servidor legítimo, evitando así el riesgo de un ataque de intermediario (Man-in-the-Middle). Al instalar Passbolt en una dirección interna, por ejemplo,

https://passbolt.it-connect.local

se recomienda usar un certificado TLS emitido por una Autoridad de Certificación (CA) interna, generalmente una solución de Servicios de Certificados de Active Directory (AD CS) en un entorno corporativo. Este certificado garantiza una confianza total y una integración perfecta con las infraestructuras existentes.

Los pasos clave para gestionar el certificado TLS incluyen: Generar una Solicitud de Firma de Certificado (CSR) u obtener un certificado existente de su CA.

  • Transferir de forma segura el certificado (.cer) y la clave privada (.key) al servidor Debian mediante
  • scp
  • o una herramienta como WinSCP.
  • Coloque los archivos en un directorio seguro, generalmente en
  • /etc/ssl/certs

y

/etc/ssl/private con los permisos adecuados.

Reconfigure Passbolt para usar estos archivos:

`dpkg-reconfigure passbolt-ce-server`

inicia la reinstalación mínima necesaria.

  • Omita la configuración de la base de datos.
  • Elija la configuración manual de TLS.
  • Especifique las rutas completas al certificado y la clave.
  • Una vez aplicados los cambios, basta con recargar la configuración de Nginx con `systemctl reload nginx`
  • para habilitar la seguridad TLS. También es posible complementar este método con la integración de un proxy inverso equipado con un WAF (Firewall de Aplicaciones Web) o herramientas como Fail2ban o CrowdSec, para añadir una capa adicional de protección contra ataques de red dirigidos a Passbolt. En resumen, gestionar un certificado TLS no termina con una simple instalación: es un proceso integral que incluye la rotación periódica del certificado, la monitorización de vulnerabilidades y el mantenimiento del acceso seguro. Passbolt, como herramienta de código abierto, proporciona esta flexibilidad esencial en entornos profesionales exigentes.
  • https://www.youtube.com/watch?v=u9-DgZUe8Bs
  • Finalización de la configuración inicial y creación de la cuenta de administrador de Passbolt
  • Tras la instalación en el servidor, la configuración inicial de Passbolt continúa directamente desde la interfaz web. Este paso es fundamental para preparar el gestor de contraseñas para su uso en entornos reales, especialmente para la colaboración segura.

Para ello, abra su navegador y acceda a la dirección configurada para Passbolt, por ejemplo: https://passbolt.it-connect.local