Saltar al contenido principal
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.
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.

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.
¿No escribe código? Siga los pasos 1 a 3 y continúe en La consola.

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

Obtenga un token

Defina sus variables y pida un token al servidor de autorización del tenant:
La respuesta sigue el formato estándar de OAuth 2.0 e incluye access_token, token_type y expires_in. Guarde el token:
5

Llame a la API

Liste las identidades del tenant:
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:
Si recibió la lista, su tenant y su cliente funcionan.

Si algo falla

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.
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.
El cliente no tiene registrado el alcance que pidió en scope, o no tiene configurado su Ámbito de Acceso. Revise el paso 3.
La función es del plan pago. Listar identidades está incluido en VU ONE FREE. Vea FREE y plan pago.
Para cualquier otro código, vea Errores.

Qué sigue

Autenticación

Sume el login de usuarios con authorization code y PKCE. Ese flujo usa un segundo cliente OAuth.

Identidades y cuentas

Cree identidades y cuentas desde su sistema.

Factores

Envíe códigos por e-mail, enlaces mágicos y TOTP.

FREE y plan pago

Qué incluye el plan y qué es del plan pago.
Última modificación el 4 de noviembre de 2026