feat: Add documentation for Keycloak (#83)

* feat: Added keycloak documentation

* fix: Delete video

src/.vuepress/navbar.ts

@@ -68,6 +68,13 @@ export const enNavbarConfig = navbar([
           "basic-rules/props",
         ],
       },
+      {
+        text: "Inicio de Sesión con Keycloak",
+        children: [
+          "basic-rules/login-keycloak",
+          "basic-rules/login-2fa",
+        ],
+      },
       {
         text: "Datos Maestros",
         children: [

src/docs/basic-rules/login-2fa.md

@@ -0,0 +1,64 @@
+---
+title: Keycloak con Autenticación 2FA
+category: Documentation
+star: 9
+sticky: 9
+article: false
+author: Jesús Albujas
+---
+
+## ¿Experimentas dificultades al intentar iniciar sesión? ¿No dispones de un dispositivo móvil?
+
+¡No te preocupes! En ERP, fomentamos un proceso seguro para iniciar sesión. Puedes instalar una variedad de aplicaciones en tu teléfono móvil ya sea **Google Authenticator**, **FreeOTP** o **Microsoft Authenticator** o una extensión en tu navegador **Google Chrome** para facilitar este proceso.
+
+1. Abre Google Chrome y dirígete a la **Chrome Web Store**.
+
+![Buscar](https://github.com/erpcya/docs/assets/134967453/e79da902-dbec-4d53-bea0-d035bcf2f4a9)
+
+2. En la barra de búsqueda, introduce **Authenticator**.
+
+![Chrome Web Store](https://github.com/erpcya/docs/assets/134967453/b3e6b52e-cc3f-49d5-8518-0b94824895ea)
+
+En caso de no encontrar dicha extensión, debes buscar específicamente la siguiente:
+
+![Authenticator](https://github.com/erpcya/docs/assets/134967453/9f109193-379c-48e1-bba9-81b700e5d48f)
+
+Posteriormente, haz clic en **Añadir a Chrome** para instalar la extensión.
+
+![Añadir a Chrome](https://github.com/erpcya/docs/assets/134967453/44a2e996-f066-4833-8e9b-ed18b3740f1a)
+
+Te solicitará permisos para agregar la extensión a Chrome. Selecciona **Add extension** (Agregar extensión).
+
+![Agregar Extensión](https://github.com/erpcya/docs/assets/134967453/2d51b163-1299-4567-944b-fbabb0129c57)
+
+En tu navegador, encontrarás un icono de rompecabezas. Allí se encuentran las extensiones instaladas.
+
+![Extensiones](https://github.com/erpcya/docs/assets/134967453/a76639a1-db00-49c3-9953-f3e8a9a04701)
+
+Ahora, en lugar de escanear con un dispositivo móvil, se usará la extensión.
+
+![Configuración](https://github.com/erpcya/docs/assets/134967453/8fc5bd3f-49c2-4397-9d57-af64c5d4279f)
+
+Para ello, dirigete a tus extensiones > **Selecciona Authenticator**
+
+![Extensión](https://github.com/erpcya/docs/assets/134967453/8ddbd759-b4e9-4b74-a79a-cac06f779ca4)
+
+Selecciona el icono de escáner.
+
+![Escanear](https://github.com/erpcya/docs/assets/134967453/a4817b58-984c-4beb-98d7-7ddd33b90218)
+
+Con el mouse dibuja la zona del **QR**
+
+![QR](https://github.com/erpcya/docs/assets/134967453/2d4f33f9-ea4d-4086-be29-0bafe0cd8576)
+
+Te mostrará una ventana indicando, que ha sido agregado satisfactoriamente.
+
+![Mensaje](https://github.com/erpcya/docs/assets/134967453/fa1927ce-b470-471d-b48f-7ab386f7aa4e)
+
+Vuelve a buscar la extensión.
+
+![Seleccionar Extensión](https://github.com/erpcya/docs/assets/134967453/8ddbd759-b4e9-4b74-a79a-cac06f779ca4)
+
+Copia el código en Keycloak y realiza el paso de [Modificar contraseña](http://docs.erpya.com/docs/basic-rules/login-keycloak.html#modificar-la-contrasena)
+
+![image](https://github.com/erpcya/docs/assets/134967453/c45577eb-dba2-496e-8224-b262750dd468)

src/docs/basic-rules/login-keycloak.md

@@ -0,0 +1,76 @@
+---
+title: Acceso Seguro con Keycloak
+category: Documentation
+star: 9
+sticky: 9
+article: false
+author: Jesús Albujas
+---
+
+Keycloak es una plataforma de código abierto que proporciona servicios de gestión de identidades y accesos, facilitando la autenticación y autorización en aplicaciones y servicios. Su propósito es garantizar un acceso seguro y controlado a recursos digitales, ofreciendo una solución integral para la gestión de identidades, single sign-on (SSO) y la federación de identidades.
+
+**ERP Consultores y Asociados** ha decidido implementar Keycloak como parte de su infraestructura tecnológica para aprovechar los beneficios significativos que esta herramienta aporta a la gestión de identidades y accesos.
+
+Si tu servicio tiene habilitado autenticación en dos pasos haz [clic aquí](./login-2fa.md)
+
+---
+
+Ingrese al servicio de ADempiere. En la zona inferior verá **Acceder con Keycloak**
+
+![ADempiere](https://github.com/erpcya/docs/assets/134967453/291b156c-b169-474a-b444-c120619c2711)
+
+## Acceder a tu cuenta
+
+Lo redireccionará a la siguiente página. Donde debe ingresar:
+
+- **Usuario o  Email** suminsitrado por el **Agente de Atención al Cliente**.
+
+- **Contraseña** suminsitrada por el **Agente de Atención al Cliente**.
+
+![image](https://github.com/erpcya/docs/assets/134967453/36baa53f-3b7a-4a05-9fc9-9e0fcccb87ae)
+
+## Configuración de tu aplicación de identificación móvil
+
+Posteriormente de haber ingresado los datos suminstrados, será redirigido al siguiente apartado.
+
+![Configuración](https://github.com/erpcya/docs/assets/134967453/8fc5bd3f-49c2-4397-9d57-af64c5d4279f)
+
+Donde usted debe descargar una de las aplicaciones sugeridas en su teléfono móvil para realizar el escaneo al código QR. Puede instalarlas haciendo click en uno de ellos:
+
+- [**Google Authenticator**](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=es_VE&gl=US)
+
+- [**Microsoft Authenticator**](https://play.google.com/store/search?q=microsoft+authenticator&c=apps&hl=es_VE&gl=US)
+
+- [**FreeOTP**](https://play.google.com/store/search?q=Freeotp&c=apps&hl=es_VE&gl=US)
+
+---
+
+Una vez instalada la aplicación, escanee el código QR.
+
+Luego de haber escaneado este le dejará un código de 6 cifras. Copie el código donde le indica **Keycloak**.
+
+![Código](https://github.com/erpcya/docs/assets/134967453/6605b6fc-994c-49f3-a845-d8fb8430ec79)
+
+## Modificar la contraseña
+
+Ahora deberá modificar su contraseña inicial.
+
+![Modificar](https://github.com/erpcya/docs/assets/134967453/63efef69-7d87-4e68-93cb-5fdbdd7fc70a)
+
+Por otro lado, te solicitará que verifiques el correo electrónico.
+
+![verificar-email](https://github.com/erpcya/docs/assets/134967453/1f21226f-c5aa-4519-9815-100db9fe888a)
+
+Deberas ir a tu correo electrónico y seguir el enlace.
+
+![gmail](https://github.com/erpcya/docs/assets/134967453/64f1d259-c5ff-4f88-a048-b33088c06b42)
+
+El enlace te llevará a Keycloak, donde te estará confirmando la dirección de correo electrónico, haces **click para seguir**.
+
+![confirmar](https://github.com/erpcya/docs/assets/134967453/f583bfd6-c026-4767-baaa-effb36eedd27)
+
+Posteriormente, tu correo ya habrá sido confirmado.
+
+![confirmado](https://github.com/erpcya/docs/assets/134967453/1644800e-b6b1-49a9-88dd-54df1bc98481)
+
+Ahora bien, luego de haber realizado este proceso usted deberá actualizar la página y será redirigido hasta ADempiere, donde ingresará normalmente.