---
title: Autenticación Oauth2 usando Keycloak
slug: es/autenticacion-oauth2-usando-keycloak
description: Learn how to set up and configure the Oauth2 authentication method with this comprehensive document. Connect your authentication server, assign user permissions, and configure the method easily using the outlined steps. Discover the various options and pa
createdAt: 2021-10-13T17:13:19.000Z
---

## Antes de Empezar

- [x] Poseer un servidor de autenticación con protocolo OAUTH2. Por ejemplo, Keycloak.
- [x] Conectar el servidor de autenticación al sistema;
- [x] Después de la lectura de un nuevo usuario, el sistema asignará los siguientes permisos contenidos en los siguientes parámetros:

* <font color="#2166ae"><u>**Parámetro 45**</u></font> - LDAP – ID de Grupo estándar
* <u>****</u><font color="#2166ae"><u>**Parámetro 39**</u></font> - LDAP - ID del perfil de acceso que se establecerá automáticamente si el usuario no tiene uno

## Procedimiento

1. Acceda al menú principal `Parametrización > Método de Autenticación > Oauth2`;
2. Se mostrará la pantalla de Método de Autenticación Oauth2 con dos opciones **"Filtros"** y **"Método de Autenticación"**;
3. A partir de la versión <font color="#ff6900">**Helium 1.2.24**</font> se han producido cambios en la interfaz descrita a continuación;
4. La opción **"Filtros"** es una pantalla de búsqueda con 4 opciones:

| **Opción**             | **Descripción**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tipo**               | Donde se elegirá el tipo de autenticación. Hay dos tipos: **Interno o Externo**.  Si la opción es externa, el sistema podrá tener 3 tipos de autenticación: **Interno, Oauth2&#x20;**&#x6F;**&#x20;Ambos**.  Si la opción está como ambos, el sistema mostrará la pantalla de inicio de sesión con el área para: **"Autenticación"**, la opción de **"olvidó su contraseña"** y **"acceder a su cuenta**", que podrá ser a través de Google, Facebook o <font color="#2166ae">**Run**</font>****<font color="#ff6900">**2**</font>****<font color="#2166ae">**biz**</font> Keycloak.  Si la opción es ambos pero no tiene ningún proveedor externo registrado, el sistema no mostrará las opciones de autenticación por Google, Facebook o <font color="#2166ae">**Run**</font>****<font color="#ff6900">**2**</font>****<font color="#2166ae">**biz**</font> Keycloak.  Si la opción es Oauth2 y no tiene un proveedor registrado, no mostrará la pantalla con varios proveedores, mostrando directamente la **"Pantalla de inicio de sesión de** <font color="#2166ae">**Run**</font>****<font color="#ff6900">**2**</font>****<font color="#2166ae">**biz**</font>". |
| **Provider**           | Donde será elegido, si será del tipo Google, Facebook, u otros                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Dominio**            | Identifica el dominio que se asignará al inicio de sesión del usuario                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Nombre del cliente** | Nombre que se mostrará al usuario en la pantalla de inicio de sesión                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

5\. Después de completar la información en **"Filtros"**, si existe algún registro con el campo informado, se mostrará en la tabla que se muestra a continuación e&#x6E;**&#x20;"Método de Autenticación"**;

6\. Si no hay ningún método de autenticación registrado o desea crear uno nuevo, haga clic en **"Nuevo"**;

7\. Al hacer clic en **"Nuevo"** se mostrará la pantalla para el registro de un nuevo método de autenticación con 2 pestañas para rellenar: **"Identificación"** y **"Asignación de campos"**;

8\. Para la pestaña **"Identificación"**, completar:

| **Campo**                 | **Descripción**                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tipo de Autenticación** | Hay dos opciones para seleccionar **"Oauth2 - Interna"** y "**Oauth2"**                                                                                                                                                                                                                                                                                                     |
| **Provider**              | Donde será escolhido se será do tipo **"Google", "Facebook"&#x20;**&#x75;**&#x20;"outros"**  Si es del tipo Google o Facebook, solo será necesario informar: el Id del Cliente y la Clave Secreta del Cliente;  Si es del tipo Otros, será necesario informar: el Nombre del cliente, el Dominio que deberá ser el mismo registrado en las URL de redirección del proveedor |
| **ID del Cliente**        | Donde debe ser informado el client id que fue registrado en el servidor Oauth2                                                                                                                                                                                                                                                                                              |
| **Tipo de Concesión**     | Identifica el grant de acceso concedido por el proveedor de autenticación. Generalmente contiene el valor **“password”**                                                                                                                                                                                                                                                    |
| **URL de Autenticación**  | Donde se debe informar la ruta del servidor de autenticación Oauth2                                                                                                                                                                                                                                                                                                         |
| **Contraseña**            | Donde deberá ser informado el client secret registrado en el servidor Oauth2                                                                                                                                                                                                                                                                                                |
| **Situación**             | Donde se puede elegir si la autenticación está activa o inactiva.  Esta situación determina si el sistema iniciará el proceso de sincronización del usuario                                                                                                                                                                                                                 |
| **Botón Guardar**         | Guarda el medio de autenticación                                                                                                                                                                                                                                                                                                                                            |
| **Botón Eliminar**        | Borra el medio de autenticación de la base de datos                                                                                                                                                                                                                                                                                                                         |
| **Botón Limpiar**         | Limpia todos los campos                                                                                                                                                                                                                                                                                                                                                     |
| **Botón de Búsqueda**     | Aparece en la parte superior de la pantalla, que vuelve a la pantalla de búsqueda                                                                                                                                                                                                                                                                                           |

9\. En la pestañ&#x61;**&#x20;"Asignación de campos"**, rellenar:

| **Campo**             | **Descripción**                                                                   |
| --------------------- | --------------------------------------------------------------------------------- |
| **Botón Guardar**     | Guarda los campos                                                                 |
| **Botón Limpiar**     | Limpia todos los campos                                                           |
| **Botón de Búsqueda** | Aparece en la parte superior de la pantalla, que vuelve a la pantalla de búsqueda |

- Esta pestaña permite la asignación de información en el token de autenticación Oauth2.  En la pantalla se muestran dos columnas: la primera columna con el nombre de los campos existentes en el registro de usuario del Sistema y la segunda columna con el nombre del respectivo atributo del token Oauth2;
- La información que se puede asignar es: **ID numero, Teléfono&#x20;**&#x79; **Fecha de Nacimiento**;

10\. Debe configurarse la URL de Retorno a <font color="#ff6900">**4biz** </font> a través de la Plataforma elegida para la autenticación externa.&#x20;

