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

# Conceptos de VU ONE

> El modelo de VU ONE explicado: tenant, negocio, canal, identidad, cuenta, factor, política, cliente OAuth y alcance del token, y cómo se relacionan entre sí.

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

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

## El modelo en un diagrama

```mermaid theme={null}
flowchart TB
  T["Tenant"] --> B1["Negocio A"]
  T --> B2["Negocio B"]
  T --> Ch["Canales"]
  I["Identidad<br/>(la persona)"] --> A1["Cuenta del negocio A"]
  I --> A2["Cuenta del negocio B"]
  A1 --> F["Factores<br/>contraseña, e-mail, TOTP..."]
  P["Política<br/>(negocio + canal)"] -. "configura" .-> F
```

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

| Superficie | Dirección |
| - | - |
| Consola | `https://<tenant>.prod.vu-one.com/vuone/es/signin/governance` |
| API | `https://<tenant>.prod.vu-one.com/middleware/api/v1/...` |
| OAuth 2.0 y OpenID Connect | `https://<tenant>.prod.vu-one.com/middleware/oauth2/...` |

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

| Alcance | Significado |
| - | - |
| `BUSINESS` | La cuenta pertenece a un solo negocio. |
| `TENANT` | La cuenta no tiene negocio y opera sobre todo el tenant. Es el caso de los administradores del tenant. Debe ser de tipo `WORKFORCE` y usar el proveedor de identidad local. |

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](https://docs.vu-one.com/vu-one/desarrolladores/autenticacion.md) para el detalle.

## Roles

Los roles definen qué puede hacer una cuenta en la consola y en la API.

| Rol | Alcance | Acceso |
| - | - | - |
| `TENANT_ADMIN` | Todo el tenant | Todos los permisos, en todos los negocios. |
| `TENANT_OPERATOR` | Todo el tenant | Solo lectura. |
| `BUSINESS_ADMIN` | Un negocio | Todos los permisos dentro del negocio. |
| `BUSINESS_OPERATOR` | Un negocio | Solo lectura dentro del negocio. |

También puede crear roles propios en **Ajustes Globales**, en **Gestión de roles y permisos**.

## Qué sigue

> [card] [Negocios y canales](https://docs.vu-one.com/vu-one/admin/negocios-y-canales.md)
>
> Cree la estructura de su tenant.

> [card] [Identidades](https://docs.vu-one.com/vu-one/admin/identidades.md)
>
> Cree identidades y asígneles cuentas.


## Related topics

- [Guía para desarrolladores de VU ONE FREE](https://docs.vu-one.com/vu-one/desarrolladores/introduccion.md)
- [Inicio rápido de VU ONE FREE](https://docs.vu-one.com/vu-one/inicio-rapido.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)
- [Recorrido por la consola de VU ONE](https://docs.vu-one.com/vu-one/admin/consola.md)


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