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 usajqpara leer el token, pero puede copiarlo a mano.
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.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:
- Escriba un Nombre del Cliente. La consola propone el ID del Cliente a partir del nombre.
- 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.
- Deje Secreto de Cliente Básico en Métodos de Autenticación.
- 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.
- En Alcances, haga clic en Administrador. Ese alcance es
role_admin. Haga clic en Próximo. - Deje los valores de tokens y seguridad y haga clic en Crear Cliente 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 token responde invalid_client
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.
El token responde invalid_scope
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.La API responde 402
La API responde 402
La función es del plan pago. Listar identidades está incluido en VU ONE FREE. Vea FREE y plan pago.
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.