Saltar al contenido principal
VU ONE organiza la identidad en pocas piezas. Conocerlas le ahorra errores de permisos y de alcance cuando configura la consola o llama a la API. Esta página define cada pieza y muestra cómo se relacionan.
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.

El modelo en un diagrama

Tenant

El tenant es su instancia de VU ONE. Tiene una dirección propia, por ejemplo wispy-waterfall-3912.prod.vu-one.com, y sus datos están separados de los de otros tenants. VU genera el nombre del tenant con el formato <adjetivo>-<sustantivo>-<4 dígitos>. Usted no lo elige. Del mismo host salen las tres superficies del tenant:

Negocio

Un negocio es una unidad de organización dentro del tenant, por ejemplo una marca o una línea de producto. Cada negocio tiene un Slug de acceso que define su pantalla de ingreso propia, /signin/b/<slug>. VU ONE FREE permite varios negocios.

Canal

Un canal es un punto de contacto con sus usuarios, por ejemplo la web o la app móvil. La combinación de negocio y canal define qué política de factores aplica.

Identidad y cuenta

  • La identidad representa a la persona. La API también acepta identidades de tipo SERVICE, DEVICE, ORGANIZATION o NONE.
  • La cuenta es la forma en que esa identidad accede. Una identidad puede tener varias cuentas.
Cada cuenta tiene un alcance: El tipo de cuenta indica para qué existe: CUSTOMER (cliente final, Cliente en la consola), WORKFORCE (personal propio, Laboral) o SERVICE (integración, Servicio). La API también acepta NONE, una cuenta sin tipo.

Atributos

Los atributos (claims) son los datos de la identidad y de sus cuentas, como el e-mail o el teléfono. Un atributo puede ser un identificador: VU ONE lo usa para encontrar la cuenta en el ingreso.

Factores y políticas

Un factor es un método de autenticación: contraseña, código por e-mail, enlace mágico, TOTP, rostro o documento. Una política fija cómo funciona un factor para un negocio y un canal: longitud del código, vigencia, intentos y límites de frecuencia.

Clientes OAuth y alcance del token

Un cliente OAuth representa una aplicación que pide tokens al tenant. El token lleva el alcance de la sesión:
  • active_scope vale TENANT o BUSINESS.
  • En alcance BUSINESS, el token lleva business_id y la API solo muestra datos de ese negocio.
  • Los encabezados X-Business-Id, X-Channel-Id y X-Account-Scope pueden acotar el alcance del token, pero nunca ampliarlo.
Vea Autenticación para el detalle.

Roles

Los roles definen qué puede hacer una cuenta en la consola y en la API. También puede crear roles propios en Ajustes Globales, en Gestión de roles y permisos.

Qué sigue

Negocios y canales

Cree la estructura de su tenant.

Identidades

Cree identidades y asígneles cuentas.
Última modificación el 4 de noviembre de 2026