> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vu-one.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear un cliente OAuth en la consola

> Cree un cliente OAuth en la consola de VU ONE con el asistente de cuatro pasos, revise los valores por defecto y guarde el secreto, que se muestra una vez.

Un cliente OAuth representa a una aplicación que pide tokens a su tenant de VU ONE. Los clientes OAuth están incluidos en VU ONE FREE. En esta página usted crea un cliente con el asistente de la consola y elige una configuración segura.

> [!WARNING]
>
> **VU ONE FREE es una versión limitada, en vista previa.** Solo la usan las cuentas de Identity Link que VU seleccionó hasta la disponibilidad general. Algunas funciones son del plan pago y las funciones, los límites y esta documentación pueden cambiar. [Vea qué incluye](https://docs.vu-one.com/vu-one/plan-free.md).

## Antes de empezar

* Haber ingresado a la consola con una cuenta de administrador del tenant. Vea [Ingresar a la consola](https://docs.vu-one.com/vu-one/admin/ingresar.md).
* El tipo de aplicación que va a conectar: pública (navegador o móvil), de servidor o servicio a servicio. Vea la sección de buenas prácticas, más abajo.
* El negocio y el canal del cliente, si no va a usar **Global (Tenant)** y **Todos los canales**.
* Las URIs de redirección de su aplicación, si va a usar **Código de Autorización** o **Implícito**.

## Crear el cliente

Abra **Ajustes Globales**, busque **Clientes OAuth** y haga clic en **Crear**. El asistente tiene cuatro pasos. Use **Próximo** y **Atrás** para moverse, o **Cancelar** para salir.

**1. Información Básica y Ámbito de Acceso**

Escriba el **Nombre del Cliente**. La consola propone un **ID del Cliente** a partir del nombre. Puede editarlo o hacer clic en **Regenerar** para obtener otro. El ID acepta letras, números, guiones y guiones bajos, de 3 a 100 caracteres, y no puede repetirse en el tenant.

Elija los **Métodos de Autenticación** y los **Tipos de Concesión**. Luego complete el **Ámbito de Acceso**:

* **Negocio**: un negocio o **Global (Tenant)**. Si ingresó con una cuenta de negocio, el campo muestra su negocio y no se puede cambiar.
* **Canal**: un canal o **Todos los canales**.
* **Tipo de Cuenta**: **LABORAL**, **CLIENTE** o **SERVICIO**.

Todos los campos de este paso son obligatorios.

**2. URIs y Alcances**

Complete **URIs de Redirección** y **URIs de Post-Logout**. Cada URI debe empezar con `http://` o `https://`. Las **URIs de Redirección** son obligatorias si eligió **Código de Autorización** o **Implícito**.

En **Alcances**, haga clic en los alcances predefinidos o escriba uno propio y presione Enter. El cliente necesita al menos un alcance. El alcance predefinido **Administrador** es `role_admin`.

**3. Tokens y seguridad**

Ajuste **Configuración de Tokens**, **Formato del Token de Acceso**, **Algoritmo de Firma** y **Opciones de Seguridad**. Haga clic en **Crear Cliente OAuth**.

**4. Credenciales del Cliente**

La consola muestra el **ID del Cliente** y el **Secreto del Cliente**, cada uno con un botón para copiarlo. Guarde el secreto y haga clic en **Cerrar**.

> [!WARNING]
>
> **El secreto del cliente se muestra una sola vez.** Cópielo y guárdelo en un gestor de secretos antes de hacer clic en **Cerrar**. Nunca lo incluya en una aplicación web o móvil.

## Opciones del asistente

| Grupo | Opciones |
| - | - |
| Métodos de autenticación | **Secreto de Cliente Básico**, **Secreto de Cliente Post**, **Secreto de Cliente JWT**, **Clave Privada JWT**, **Ninguno** |
| Tipos de Concesión | **Código de Autorización**, **Credenciales de Cliente**, **Token de Actualización**, **Implícito**, **Contraseña del Propietario del Recurso**, **Código de Dispositivo**, **JWT Bearer** |
| Formato del Token de Acceso | **Autocontenido (JWT)**, **Referencia** |
| Opciones de Seguridad | **Requerir Consentimiento de Autorización**, **Requerir PKCE (Proof Key for Code Exchange)**, **Reutilizar Tokens de Actualización**, **Tokens Vinculados a Certificado X.509** |

## Valores por defecto

| Parámetro | Valor por defecto | Valores permitidos |
| - | - | - |
| Método de autenticación | `client_secret_basic` (**Secreto de Cliente Básico**) | |
| Tipo de concesión | `authorization_code` (**Código de Autorización**) | |
| Alcances | `openid` | |
| **Requerir PKCE (Proof Key for Code Exchange)** | Desactivado | |
| **Reutilizar Tokens de Actualización** | Activado | |
| Vida del token de acceso | 3600 segundos | 300 a 3600 |
| Vida del token de actualización | 86400 segundos | 3600 a 86400 |
| Vida del código de autorización | 60 segundos | 30 a 60 |
| Vida del código de dispositivo | 900 segundos | 300 a 900 |
| **Algoritmo de Firma** | `RS256` | |
| **Formato del Token de Acceso** | **Autocontenido (JWT)** | |

Para un cliente de servicio a servicio, cambie el tipo de concesión por defecto: elija **Credenciales de Cliente** y quite **Código de Autorización**.

## Buenas prácticas

* **Aplicaciones públicas** (navegador o móvil): no pueden guardar un secreto. Elija **Ninguno** como método de autenticación, use **Código de Autorización** y active **Requerir PKCE (Proof Key for Code Exchange)**.
* **Aplicaciones de servidor:** guarde el secreto en su backend y use un método con secreto o con clave privada.
* **Servicio a servicio:** use **Credenciales de Cliente**.
* **Mínimos alcances:** pida solo los alcances que la aplicación usa.
* **Mínimas concesiones:** habilite solo los tipos de concesión que la aplicación necesita. Evite **Implícito** y **Contraseña del Propietario del Recurso** en aplicaciones nuevas.
* **Redirecciones exactas:** registre solo las URIs de redirección que la aplicación usa.

## Administrar los clientes

La lista muestra **Nombre del Cliente**, **ID del Cliente**, **Negocio**, **Estado**, **Canal**, **Tipo de Cuenta**, **Alcances** y **Fecha de Creación**.

Cada fila tiene tres acciones:

| Acción | Uso |
| - | - |
| **Editar** | Cambia la configuración del cliente. |
| **Revocar Autorizaciones** | Revoca las autorizaciones que el cliente obtuvo. |
| **Eliminar** | Borra el cliente. |

Si el cliente todavía tiene autorizaciones activas, **Eliminar** no lo borra directamente. Si su cuenta tiene permiso para revocar autorizaciones, la consola ofrece **Revocar y eliminar**: revoca todas las autorizaciones y borra el cliente. Los tokens emitidos para ese cliente dejan de funcionar.

## Qué sigue

> [card] [Autenticación por API](https://docs.vu-one.com/vu-one/desarrolladores/autenticacion.md)
>
> Pida tokens con el cliente que creó.

> [card] [Conceptos](https://docs.vu-one.com/vu-one/conceptos.md)
>
> Repase tenant, negocio, canal y tipo de cuenta.

> [card] [Atributos](https://docs.vu-one.com/vu-one/admin/atributos.md)
>
> Defina los atributos que viajan con sus identidades.


## Related topics

- [Autenticación con OAuth 2.0 y OIDC](https://docs.vu-one.com/vu-one/desarrolladores/autenticacion.md)
- [Inicio rápido de VU ONE FREE](https://docs.vu-one.com/vu-one/inicio-rapido.md)
- [Guía para desarrolladores de VU ONE FREE](https://docs.vu-one.com/vu-one/desarrolladores/introduccion.md)
- [Recorrido por la consola de VU ONE](https://docs.vu-one.com/vu-one/admin/consola.md)
- [Qué es VU ONE FREE](https://docs.vu-one.com/vu-one/introduccion.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.