Add documentation to change the admin credentials

This is something really important, and we weren't mentioning it.
This commit is contained in:
Javi Martín
2024-09-17 13:21:47 +02:00
parent 71da9f4cda
commit f133bc14a8
2 changed files with 28 additions and 0 deletions

View File

@@ -6,6 +6,20 @@ To do this, you will need to go to your Consul Democracy installation URL with a
Once you have logged in you will see on the top right of the screen a "Menu" button. Click on it and then click on "Administration" to go to the administration area. From this interface you can configure the following basic options: Once you have logged in you will see on the top right of the screen a "Menu" button. Click on it and then click on "Administration" to go to the administration area. From this interface you can configure the following basic options:
## Change the administrator credentials
Since the `admin@consul.dev` email address doesn't exist, and since anyone familiar with Consul Democracy will know the default password, we strongly recommended that you change the login credentials immediately after installing the application.
First, sign in using the default administrator credentials.
Then, click on "My account". On the "My account" page, click on "Change my login details". Fill in the form with the new email and password.
The password will be updated immediately, and you can sign out and sign in using the new password. In order to update the email address, you will receive an email on that address asking to confirm your account. Click on the link included in that email, and you'll be able to sign in using the new email address.
You can also change the default "admin" username. Once again, go to "My account". On that page, you will see a form containing a "username" field. Just change the username and click on the form button to update it.
It's possible that, before following this process, you've already signed up with the email you'd like to use as an administrator. If that's the case, instead of following the previous process, sign in as an administrator and go the admin area. Once there, on the side navigation menu, click on "Profiles" to open a submenu and then click on "Administrators". To add an administrator, use the search form and enter the email of the user you'd like to make an administrator (not very intuitive; sorry for that!). Once the search results are returned, click on the "Add" icon. Now, sign out, sign in as the new administrator, go to the admin area, click once again on "Profiles" and then on "Administrators" and delete the default `admin@consul.dev` administrator. Note that this won't delete the user, but that user will no longer be an administrator.
## Global configuration parameters ## Global configuration parameters
In the admin area, on the side navigation menu, click on "Settings" to open a submenu and then click on "Global settings". Here you will find many interesting parameters, but at the moment we recommend you to define some of the most basic ones (later, when you are more familiar with the tool, you will be able to configure other parameters): In the admin area, on the side navigation menu, click on "Settings" to open a submenu and then click on "Global settings". Here you will find many interesting parameters, but at the moment we recommend you to define some of the most basic ones (later, when you are more familiar with the tool, you will be able to configure other parameters):

View File

@@ -6,6 +6,20 @@ Para ello, deberás acceder a tu instalación de Consul Democracy a través de c
Una vez identificado, en la parte superior derecha de la pantalla verás un botón con el texto "Menú". Pincha en él y a continuación pincha en "Administración" para ir al área de administración. Desde esta interfaz puedes configurar las siguientes opciones básicas: Una vez identificado, en la parte superior derecha de la pantalla verás un botón con el texto "Menú". Pincha en él y a continuación pincha en "Administración" para ir al área de administración. Desde esta interfaz puedes configurar las siguientes opciones básicas:
## Cambio de la contraseña de administrador
Ya que el correo `admin@consul.dev` no existe, y que cualquiera que esté familiarizado con Consul Democracy sabrá cuál es la contraseña por defecto de administrador, recomendamos encarecidamente que cambies las credenciales justo después de instalar la aplicación.
En primer lugar, identifícate como administrador utilizando el correo y la contraseña por defecto.
A continuación, entra en "Mi cuenta". En la página de "Mi cuenta", pincha en "Cambiar mis datos de acceso". Rellena el formulario con el nuevo correo y la nueva contraseña.
La contraseña se actualizará inmediatamente, y podrás cerrar la sesión y abrir una nueva utilizando la nueva contraseña. Para actualizar la dirección de correo, recibirás un correo en esa dirección pidiéndote que confirmes tu cuenta. Pincha en el enlace incluido en ese correo, y podrás identificarte en la aplicación usando la nueva dirección de correo.
También puedes cambiar el nombre de usuario por defecto ("admin"). Una vez más, entra en "Mi cuenta". En esa página, verás un formulario que incluye el campo "Nombre de usuario". Para actualizarlo, cambia el valor de ese campo y pincha el botón de "Guardar cambios".
Es posible que, antes de hacer todo esto, ya hayas registrado un nuevo usuario que te gustaría usar como administrador. De ser así, en lugar de seguir el proceso descrito anteriormente, identifícate como administrador y vete al área de administración. Una vez allí, en el menú de navegación, pincha en "Perfiles" para abrir un submenú y a continuación pincha en "Administradores". Para añadir un administrador, usa el formulario de búsqueda e introduce el correo del usuario al que quieras hacer administrador (sabemos que no es muy intuitivo; ¡perdón!). Una vez que aparezcan los resultados de búsqueda, pincha en "Añadir como Administrador". Ahora puedes cerrar sesión, entrar con el nuevo administrador, pinchar nuevamente en "Perfiles" y a continuación en "Administradores", y borrar el administrador por defecto `admin@consul.dev`. Ten en cuenta que con esto ese usuario no se borrará, pero ya no tendrá permisos de administrador.
## Parámetros de la configuración global ## Parámetros de la configuración global
En el menú de navegación del área de administración, pincha en "Configuración" para abrir un submenú y a continuación pincha en "Configuración global". Aquí encontrarás muchos parámetros interesantes, pero por el momento te recomendamos definir algunos de los más básicos (más adelante, cuando estés más familiarizado con la herramienta, podrás volver a esta sección a configurar otros parámetros): En el menú de navegación del área de administración, pincha en "Configuración" para abrir un submenú y a continuación pincha en "Configuración global". Aquí encontrarás muchos parámetros interesantes, pero por el momento te recomendamos definir algunos de los más básicos (más adelante, cuando estés más familiarizado con la herramienta, podrás volver a esta sección a configurar otros parámetros):