Configuración del servidor Passwork

Si un parámetro requerido no se encuentra en la lista, significa que se configura a través de la interfaz web de Passwork o ya no es compatible.

El archivo de configuración config.env se encuentra en los siguientes directorios (dependiendo de la opción de instalación de Passwork elegida):

• Linux — /var/www/init/config.env
• Windows Server — C:\inetpub\wwwroot\passwork\init\config.env
• Docker — /<passwork>/conf/keys/config.env

Parámetros relacionados con el funcionamiento de Passwork

Parámetro	Valor predeterminado	Descripción
ENCRYPTION_CIPHER	AES-256-CFB	Algoritmo de cifrado de datos.
IS_EXPORT_ENABLED	1	De forma predeterminada, la exportación de contraseñas en Passwork está habilitada. El valor 0 deshabilita la exportación.
IS_EMERGENCY_RESET_ENABLED	0	Permiso para restablecer la contraseña del propietario mediante comando de consola.
IS_WRITING_LOGS_TO_STDERR_ENABLED	1	Escritura de errores en el flujo stderr
IS_WRITING_LOGS_TO_ERROR_LOG_ENABLED	1	Escritura de errores en el archivo error_log
ACTIVITY_LOG_OUTPUT	syslog	Escritura del historial de acciones en syslog (predeterminado) o en el flujo stdout de PHP-FPM.
IS_BASE64_RESPONSE_ENCODING_ENABLED	1	Codificación de respuestas en Base64.
APP_URL		Dirección URL de Passwork. Se establece durante el proceso del Asistente de instalación.
HEALTH_CHECK_TOKEN		Token para el endpoint de comprobación de estado.
HASH_ALGORITHM	Se recomienda no modificar	Algoritmo de hash de contraseñas. Se utiliza SHA512 de forma predeterminada.
ENCRYPTION_CIPHER	Se recomienda no modificar	Puede especificar un algoritmo de cifrado de la biblioteca OpenSSL.
IS_HTTP_HEADERS_CHECKER_ENABLED	0	Habilitar la verificación de Referer en los encabezados HTTP.
LDAP_GROUP_ADDITIONAL_FILTER		Filtrado adicional de grupos.

Parámetros de rutas y archivos de configuración

Parámetro	Valor predeterminado	Descripción
FILES_DIR	<Passwork root>/files	Directorio que contiene los registros de tareas en segundo plano, la descripción del esquema API y otros
INIT_DIR	<Passwork root>/init	Directorio predeterminado para almacenar la clave de cifrado y el archivo de configuración del usuario.
ENCRYPTION_KEY_PATH	INIT_DIR/encryption_key	Ruta al archivo de clave de cifrado.
ENV_LOCAL_PATH	INIT_DIR/config.env	Ruta al archivo de configuración del usuario.
SSO_FILES_DIR	FILES_DIR/sso	Ruta al directorio sso, necesario para almacenar certificados cuando se utilizan para la firma.

Uso

init/config.env — la ruta predeterminada especificada, pero se puede anular mediante .env.local. Contiene la parte principal de la configuración y en la mayoría de los casos la configuración se limita a cambiar o añadir parámetros en este archivo.

.env — ubicado en la raíz del código de Passwork (no confundir con .env en la raíz del Docker build). No realice cambios en este archivo a menos que lo solicite nuestro soporte técnico.

.env.local — ausente por defecto, solo puede ubicarse en la raíz del código de Passwork. Recomendamos usarlo para cambiar solo algunos ajustes: rutas, modo de cifrado, modo de codificación de respuestas. Los ajustes de este archivo anularán los especificados en init/config.env y .env.

Environment variables — también pueden usarse para la configuración, pero esto es razonable solo cuando se ejecuta en contenedores o mediante gestores de procesos externos. En otros casos, es preferible utilizar archivos de configuración.

Parámetros de conexión de base de datos

MongoDB

Parámetro	Descripción
MONGODB_URL	Cadena de conexión a MongoDB.
MONGODB_DB	Nombre de la base de datos de Passwork.
MONGODB_USERNAME	(opcional) Nombre de usuario de MongoDB.
MONGODB_PASSWORD	(opcional) Contraseña del usuario de MongoDB.

Parámetros de correo

info

Se utiliza con el tipo DSN.

Parámetro	Descripción
APP_SENDER_EMAIL	Correo electrónico del remitente para mensajes del sistema.
MAILER_DSN	Cadena de conexión DSN al servidor de correo.

Personalización de la interfaz

Visualización del logotipo

Passwork le permite mostrar el logotipo de su empresa en la interfaz web en lugar del nombre textual.

Secuencia de configuración:

1. Prepare un archivo PNG del tamaño adecuado y colóquelo en un directorio accesible para el usuario del servidor web.
2. Especifique la ruta absoluta al archivo en el parámetro APP_LOGO_PATH dentro de config.env.
3. Reinicie los servicios para cargar el logotipo.

Recomendaciones de formato del logotipo:

• Formato: PNG
• Tamaño máximo: 200×80 píxeles

Parámetro	Descripción
APP_LOGO_PATH	ruta a la imagen del logotipo

Ejemplos de configuración

Linux

1. Mueva el archivo .png al servidor donde está instalado Passwork y establezca el usuario del servidor web Apache2 como propietario.

DEB

chown www-data:www-data /opt/logo/example.png

RPM

chown apache:apache /opt/logo/example.png

1. Edite config.env y añada el parámetro:

config.env

APP_LOGO_PATH=/opt/logo/example.png

1. Reinicie los servicios de PHP y del servidor web:

DEB

systemctl restart php8.3-fpm
systemctl restart apache2

RPM

systemctl restart php-fpm
systemctl restart httpd

Docker

1. Coloque el archivo .png en /<passwork>/conf/keys/ dentro del directorio de configuración:

tree

keys
├── config.env
├── encryption_key
└── example.png

1. Añada el parámetro a config.env utilizando la variable %init_dir%:

config.env

APP_LOGO_PATH="%init_dir%/example.png"

1. Reinicie los contenedores de PHP y Nginx:

Docker

docker restart passwork_php passwork_nginx

Windows Server

1. Copie el archivo a cualquier directorio accesible para IIS, por ejemplo:

PowerShell

C:\inetpub\logo\example.png

1. Añada el parámetro a config.env:

config.env

APP_LOGO_PATH="C:\inetpub\logo\example.png"

1. En IIS, reinicie el sitio web de Passwork o el grupo de aplicaciones correspondiente.