Restablecer la contraseña de usuario

Comando de restablecimiento de contraseña

Para restablecer la contraseña de un usuario, use el siguiente comando en el servidor donde se ejecuta Databasus:

docker exec -it databasus ./main --new-password="YourNewSecurePassword123" --email="owner@example.com"

Parámetros

El comando acepta los siguientes parámetros:

--new-password: la nueva contraseña, de al menos 8 caracteres. Asegúrese de que sea segura y combine letras, números y caracteres especiales.
--email: el correo electrónico de la cuenta cuya contraseña quiere restablecer (por ejemplo, owner@example.com). Una instancia creada antes de que la primera cuenta la administrara todavía lleva la dirección provisional admin hasta que su propietario la reemplace, así que allí indique admin.

Listar las cuentas de administrador

Si no recuerda qué dirección administra la instancia, liste las cuentas de administrador en el servidor donde se ejecuta Databasus:

docker exec -it databasus ./main --list-admins

La salida nombra cada cuenta de administrador con su correo electrónico, nombre visible, fecha de creación y estado de actividad, y marca la que la instancia reconoce como su administrador. No imprime ninguna contraseña, ni su hash, ni ningún token. En una instancia donde todavía nadie ha creado una cuenta, informa de que la instancia no tiene administrador.

Crear una cuenta desde la consola

Para dar de alta una cuenta sin registrarse en el navegador, por ejemplo desde un script de despliegue, créela en el servidor donde se ejecuta Databasus:

docker exec -it databasus ./main --create-user --email="ops@example.com" --password="YourSecurePassword123" --role=admin

El comando acepta los siguientes parámetros:

--email: el correo electrónico de la nueva cuenta. Debe ser una dirección válida.
--password: la contraseña de la nueva cuenta, de al menos 8 caracteres.
--role: admin o member.
--name: un nombre visible opcional. Si no lo indica, la cuenta recibe como nombre la parte de la dirección anterior a la @.

La cuenta queda activa de inmediato y entra con esa dirección y esa contraseña, esté o no abierto el registro. En una instancia que todavía no tiene ninguna cuenta, la cuenta que cree pasa a administrar la instancia, así que la primera debe usar --role=admin. Un administrador creado más tarde de esta forma es un administrador corriente.

Si vuelve a ejecutar el comando para una cuenta que ya existe con el mismo rol, termina sin error y no cambia nada, así que puede incluirlo en cada despliegue. En ese caso la contraseña no se toca: para cambiarla, use el comando de restablecimiento --new-password descrito más arriba. Si la dirección pertenece a una cuenta con otro rol, a una cuenta desactivada o invitada, o a una cuenta que inicia sesión con Google o GitHub, el comando falla y no cambia nada.

Dejar de pedir un código al iniciar sesión

Una instancia puede exigir, además de la contraseña, un código de seis dígitos enviado por correo al iniciar sesión. Si el servidor de correo deja de entregar esos códigos, nadie entra con contraseña, y restablecerla no basta. Desactive el segundo factor en el servidor donde se ejecuta Databasus:

docker exec -it databasus ./main --disable-2fa

El comando informa de si ha cambiado algo, termina sin quejarse cuando el segundo factor ya está desactivado y registra el cambio en el historial de auditoría. El siguiente inicio de sesión con contraseña ya no pide código, y un administrador puede volver a activar el ajuste cuando el correo funcione.