> ## 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.

# Inicio rápido de VU ONE FREE

> Cree su tenant de VU ONE FREE, registre un cliente OAuth en la consola y haga su primera llamada a la API del tenant con un token de client credentials.

Esta guía lo lleva de cero a su primera llamada a la API de **VU ONE**. Va a crear el tenant en el **VU Customer Portal**, registrar un cliente OAuth de servidor a servidor en la consola y usar su token para listar las identidades del tenant.

> [!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).

## Lo que va a lograr

En cinco pasos va a tener:

* Un tenant de VU ONE FREE con su administrador global.
* Un cliente OAuth de servidor a servidor.
* Un token de acceso y una respuesta real de la API de su tenant.

## Lo que necesita

* Una cuenta de Identity Link habilitada para la vista previa, con la configuración inicial completa.
* Una terminal con `curl`. El paso 4 usa `jq` para leer el token, pero puede copiarlo a mano.

> [!TIP]
>
> ¿No escribe código? Siga los pasos 1 a 3 y continúe en [La consola](https://docs.vu-one.com/vu-one/admin/consola.md).

## Pasos

**1. Cree el tenant**

Ingrese a `https://portal.vu-one.com`, abra **VU ONE** en el menú lateral y haga clic en **Crear tenant gratis**. Marque **Acepto los términos de la versión de prueba de VU ONE.** y haga clic en **Crear tenant**.

La creación pasa por los pasos **Pedido**, **Preparando** y **Listo**. VU genera el nombre, por ejemplo `wispy-waterfall-3912`, y la dirección del tenant.

> [!WARNING]
>
> Cuando el tenant está listo, haga clic en **Ver contraseña**. El portal muestra la contraseña del administrador global **una sola vez**. Guárdela en un gestor de contraseñas antes de seguir. Su usuario es el e-mail de su cuenta.

Detalle completo en [Crear el tenant](https://docs.vu-one.com/vu-one/admin/crear-tenant.md).

**2. Ingrese a la consola**

Haga clic en **Abrir VU ONE**. La consola abre en `https://<tenant>.prod.vu-one.com/vuone/<idioma>/signin/governance`. La página abre en la pestaña **Global**. Escriba su e-mail y haga clic en **Siguiente**. Escriba la contraseña que guardó y haga clic en **Iniciar sesión**.

Detalle en [Ingresar a la consola](https://docs.vu-one.com/vu-one/admin/ingresar.md).

**3. Registre un cliente OAuth**

En la consola, abra **Ajustes Globales**, luego **Clientes OAuth**, y haga clic en **Crear**. Complete el asistente:

1. Escriba un **Nombre del Cliente**. La consola propone el **ID del Cliente** a partir del nombre.
2. En **Tipos de Concesión**, elija **Credenciales de Cliente** y quite **Código de Autorización**, que viene marcado por defecto. Si deja **Código de Autorización**, el asistente le pide una URI de redirección.
3. Deje **Secreto de Cliente Básico** en **Métodos de Autenticación**.
4. En **Ámbito de Acceso**, elija **Global (Tenant)** en **Negocio**, **Todos los canales** en **Canal** y un **Tipo de Cuenta**, por ejemplo **SERVICIO**. Los tres campos son obligatorios. Haga clic en **Próximo**. Si negocio, canal o tipo de cuenta son términos nuevos para usted, vea [Conceptos](https://docs.vu-one.com/vu-one/conceptos.md).
5. En **Alcances**, haga clic en **Administrador**. Ese alcance es `role_admin`. Haga clic en **Próximo**.
6. Deje los valores de tokens y seguridad y haga clic en **Crear Cliente OAuth**.

La pantalla **Credenciales del Cliente** muestra el **ID del Cliente** y el **Secreto del Cliente**. El secreto se muestra una sola vez: cópielo antes de hacer clic en **Cerrar**.

> [!TIP]
>
> `role_admin` concede todos los permisos dentro del negocio y el canal del cliente. Con **Global (Tenant)**, eso es todo el tenant. Úselo para esta prueba. En producción, registre solo los permisos que su integración necesita. Vea [Clientes OAuth](https://docs.vu-one.com/vu-one/admin/clientes-oauth.md).

**4. Obtenga un token**

Defina sus variables y pida un token al servidor de autorización del tenant:

```bash theme={null}
export TENANT_HOST="wispy-waterfall-3912.prod.vu-one.com"
export CLIENT_ID="<id-del-cliente>"
export CLIENT_SECRET="<secreto-del-cliente>"

curl -s -X POST "https://$TENANT_HOST/middleware/oauth2/token" \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&scope=role_admin"
```

La respuesta sigue el formato estándar de OAuth 2.0 e incluye `access_token`, `token_type` y `expires_in`. Guarde el token:

```bash theme={null}
export TOKEN=$(curl -s -X POST "https://$TENANT_HOST/middleware/oauth2/token" \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d "grant_type=client_credentials&scope=role_admin" | jq -r .access_token)
```

**5. Llame a la API**

Liste las identidades del tenant:

```bash theme={null}
curl -s "https://$TENANT_HOST/middleware/api/v1/identities" \
  -H "Authorization: Bearer $TOKEN"
```

Las listas de la API usan este sobre de paginación. La página empieza en `1` y trae 10 elementos si no envía `pageSize`:

```json theme={null}
{
  "currentPage": 1,
  "pageSize": 10,
  "totalElements": 1,
  "totalPages": 1,
  "content": [
    {
      "id": "<identity-id>",
      "name": "<nombre>",
      "identityType": "PERSON"
    }
  ]
}
```

> [!TIP]
>
> Si recibió la lista, su tenant y su cliente funcionan.

## Si algo falla

> [accordion] El token responde invalid\_client
>
> El ID o el secreto del cliente no coinciden, o el cliente no tiene **Secreto de Cliente Básico** en **Métodos de Autenticación**. Revise que copió el secreto completo de **Credenciales del Cliente**. La consola no vuelve a mostrar el secreto ni genera uno nuevo: si lo perdió, cree un cliente nuevo.

> [accordion] El token responde unauthorized\_client
>
> El cliente no tiene el tipo de concesión **Credenciales de Cliente**. En **Clientes OAuth**, haga clic en **Editar** en la fila del cliente, agregue **Credenciales de Cliente** en **Tipos de Concesión** y haga clic en **Actualizar**.

> [accordion] El token responde invalid\_scope
>
> El cliente no tiene registrado el alcance que pidió en `scope`, o no tiene configurado su **Ámbito de Acceso**. Revise el paso 3.

> [accordion] La API responde 402
>
> La función es del plan pago. Listar identidades está incluido en VU ONE FREE. Vea [FREE y plan pago](https://docs.vu-one.com/vu-one/plan-free.md).

Para cualquier otro código, vea [Errores](https://docs.vu-one.com/vu-one/desarrolladores/errores.md).

## Qué sigue

> [card] [Autenticación](https://docs.vu-one.com/vu-one/desarrolladores/autenticacion.md)
>
> Sume el login de usuarios con authorization code y PKCE. Ese flujo usa un segundo cliente OAuth.

> [card] [Identidades y cuentas](https://docs.vu-one.com/vu-one/desarrolladores/cuentas.md)
>
> Cree identidades y cuentas desde su sistema.

> [card] [Factores](https://docs.vu-one.com/vu-one/desarrolladores/factores.md)
>
> Envíe códigos por e-mail, enlaces mágicos y TOTP.

> [card] [FREE y plan pago](https://docs.vu-one.com/vu-one/plan-free.md)
>
> Qué incluye el plan y qué es del plan pago.


## Related topics

- [Guía para desarrolladores de VU ONE FREE](https://docs.vu-one.com/vu-one/desarrolladores/introduccion.md)
- [Errores de la API de VU ONE FREE](https://docs.vu-one.com/vu-one/desarrolladores/errores.md)
- [Crear su tenant de VU ONE FREE](https://docs.vu-one.com/vu-one/admin/crear-tenant.md)
- [Qué es VU ONE FREE](https://docs.vu-one.com/vu-one/introduccion.md)
- [VU ONE FREE frente al plan pago](https://docs.vu-one.com/vu-one/plan-free.md)


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