Gestor de Contraseñas
Esta aplicación permite una gestión completa de contraseñas para múltiples tipos de servicios (web, ssh, teléfonos, wifi, etc...).
Los datos de cada aplicación se guardan cifrados en base de datos.
El cifrado de estos datos se realiza usando el valor de
APP_KEY
como salt, con lo cual es importantísimo no regenerar esta key o perderás el acceso a todas las aplicaciones registradas.
Ni se te ocurra instalar este proyecto en un entorno sin protección HTTPS
Las características principales son:
- Gestión de usuarios.
- Gestión de equipos.
- Acceso a aplicaciones limitadas por equipos.
- Múltiples tipos de datos a registrar.
- Cifrado en base de datos.
- Autenticación por certificado y doble factor con Google Authenticator.
- Usando certificado puedes desactivar el acceso por contraseña.
- Dispone de un log que registra cada vez que algún usuario accede, consulta o actualiza una aplicación.
- Permite aplicaciones privadas o compartidas.
- Dispone de una extensión de chrome que se conecta vía API y accede directamenete a las credenciales de la web que estás visitando.
Este proyecto dispone de una extensión para Google Chrome que puedes descargar en https://github.com/eusonlito/Password-Manager-Chrome
Requisitos
- Apache2 (nginx no soporta autenticación con certificado limitado a ciertas rutas)
- PHP 8.0 o superior (php-curl php-imagick php-mbstring php-mysql php-redis php-zip)
- MySQL 8.0
- ImageMagick
- Redis
Recuerda que si PHP 8 no es la versión por defecto del sistema, siempre debes usar el prefijo de versión, tanto para composer
como para artisan
, por ejemplo:
php8.0 /usr/local/bin/composer install --no-scripts --no-dev
php8.0 /usr/local/bin/composer install --no-dev --optimize-autoloader --classmap-authoritative --ansi
php8.0 artisan key:generate
Instalación
-
Creamos la base de datos en MySQL.
-
Clonamos el repositorio.
git clone https://github.com/eusonlito/Password-Manager.git
- Realizamos la primera instalación (recuerda que siempre usando el binario de PHP 8.0).
composer install --no-scripts --no-dev && composer install --no-dev --optimize-autoloader --classmap-authoritative --ansi
- Configuramos el fichero
.env
con los datos necesarios.
cp .env.example .env
- Generamos la clave de aplicación. Recuerda guardar una copia de seguridad de esta clave (
.env
>APP_KEY
).
php artisan key:generate
- Regeneramos las cachés.
composer artisan-cache
- Lanzamos la migración inicial.
php artisan migrate
- Lanzamos el seeder.
php artisan db:seed --class=Database\\Seeders\\Database
- Configuramos la tarea cron para el usuario relacionado con el proyecto:
* * * * * cd /var/www/password.domain.com && php artisan schedule:run >> storage/logs/artisan-schedule-run.log 2>&1
- Creamos el usuario principal.
php artisan user:create [email protected] --name=Admin --password=StrongPassword2 --admin
-
Configuramos el servidor para acceso web con
DOCUMENT_ROOT
enpublic
. -
Profit!
Actualización
La actualización de la plataforma se puede realizar de manera sencilla con el comando composer deploy
ejecutado por el usuario que gestiona ese projecto (normalmente www-data
).
Este comando realiza las siguientes acciones:
"git checkout .",
"git pull",
"@composer env-version --ansi",
"@composer install --no-dev --optimize-autoloader --classmap-authoritative --ansi",
"@php artisan migrate --force --ansi",
"@php ./vendor/bin/php-cs-fixer fix --ansi --quiet",
"@php artisan maintenance:opcache:preload"
Autenticación con Certificado
Para poder realizar la autenticación con certificado debemos añadir la siguiente configuración en el VirtualHost
de Apache:
<Location /user/profile/certificate>
SSLVerifyClient require
SSLVerifyDepth 2
SSLOptions +StdEnvVars +ExportCertData +OptRenegotiate
</Location>
<Location /user/auth/certificate>
SSLVerifyClient require
SSLVerifyDepth 2
SSLOptions +StdEnvVars +ExportCertData +OptRenegotiate
</Location>
SSLCACertificateFile /var/www/password.domain.com/resources/certificates/certificates.pem
La localización /user/profile/certificate
permite obtener el identificador del certificado automáticamente desde el propio perfil de usuario, y /user/auth/certificate
es la ruta de autenticación por certificado.
La opción de OptRenegotiate
le permite a Apache renegociar la conexión de manera independiente por ruta, algo que nginx no soporta.
Comandos
Alta de usuario:
php artisan user:create {--email=} {--name=} {--password=} {--admin} {--readonly} {--teams=}
Actualización de usuario:
php artisan user:update {--id=} {--email=} {--name=} {--password=} {--certificate=} {--tfa_enabled=} {--admin=} {--readonly=} {--enabled=} {--teams=}
Ayuda!
Pues estaría guay un poco de ayuda para mejorar la traducción a inglés en resources/lang/en
, así como el readme.en.md
.