` y devolver los [datos de usuario](#user-data-format).
La ruta de redirección de OAuth es `/mintlify-oauth-callback`. En una subruta personalizada, el dashboard incluye la subruta en la URL de redirección.
Mintlify intercambia el código de autorización y solicita los datos del usuario desde el navegador del visitante. Si el endpoint de token o de la Info API está en un origen distinto al de tu documentación, configúralo para permitir solicitudes entre orígenes desde el origen exacto de la documentación. La Info API debe permitir el encabezado de solicitud `Authorization`.
## Relleno automático de claves de la API
Rellena automáticamente los campos del área de pruebas de la API con valores específicos de cada usuario devolviendo nombres de campos coincidentes en tus datos de usuario. Incluye esos valores en el campo `apiPlaygroundInputs` de tus [datos de usuario](/docs/es/deploy/authentication-setup#user-data-format).
```json theme={null}
{
"apiPlaygroundInputs": {
"header": { "X-API-Key": "user_api_key_123" },
"server": { "subdomain": "acme" }
}
}
```
Los nombres de los campos deben coincidir con los definidos en tu especificación de OpenAPI. Mintlify aplica únicamente los valores que coinciden con el esquema de seguridad del endpoint actual.
## Contenido MDX dinámico
Muestra contenido en función de la información del usuario, como el nombre, el plan u organización, utilizando la variable `user` en tus páginas MDX. Incluye datos personalizados en el campo `content` de tus [datos de usuario](/docs/es/deploy/authentication-setup#user-data-format).
```json theme={null}
{
"content": {
"firstName": "Jane",
"company": "Acme Corp",
"plan": "Enterprise"
}
}
```
Utiliza estos valores en tu MDX.
```mdx theme={null}
¡Bienvenido de nuevo, {user.firstName}! Tu plan {user.plan} incluye 100 espacios para miembros de tu organización {user.company}.
```
Para el renderizado condicional basado en datos de usuario, usa la variable `user` en componentes JSX.
```jsx theme={null}
{
user.plan === 'enterprise'
? <>Contacta con tu administrador para habilitar esta función.
: <>Consulta precios para obtener información sobre la actualización.
}
```
La variable `user` es un objeto vacío para los usuarios que no han iniciado sesión. Utiliza el encadenamiento opcional en todas las propiedades de `user` para evitar errores. Por ejemplo, `{user.org?.plan}` en lugar de `{user.org.plan}`.
Para leer el mismo objeto de usuario desde un [archivo JavaScript personalizado](/docs/es/customize/custom-scripts#access-personalized-user-data), utiliza `window.mintlify.user` y escucha el evento `mintlify:user`.
## Visibilidad de páginas
Controla qué páginas aparecen en la navegación según los grupos de usuarios añadiendo `groups` al frontmatter de la página.
Con la personalización, `groups` controla la visibilidad, pero no restringe el acceso a una página. Un visitante todavía puede abrir una página filtrada por grupo navegando directamente a su URL. Usa la [autenticación](/docs/es/deploy/authentication-setup) para restringir el acceso a contenido sensible.
```mdx theme={null}
---
title: "Configuración de administrador"
groups: ["admin"]
---
```
## Filtrado de contenido de OpenAPI
Filtra el contenido de referencia de tu API en función de los grupos de usuarios mediante la extensión `x-mint` en tu especificación de OpenAPI. Puedes filtrar endpoints completos, propiedades individuales de esquemas, variantes de `oneOf` y valores de enum.
### Filtrar endpoints
Agrega `x-mint.groups` a una operación o ruta para mostrar el endpoint en la navegación solo a grupos de usuarios específicos. Con la personalización independiente, los usuarios que no pertenezcan a los grupos indicados aún pueden abrir la página del endpoint mediante su URL directa.
```json {6-8} Operación restringida theme={null}
{
"paths": {
"/billing": {
"get": {
"summary": "Obtener detalles de facturación",
"x-mint": {
"groups": ["admin", "billing"]
},
"responses": {
"200": {
"description": "Detalles de facturación"
}
}
}
}
}
}
```
```json {3-5} Ruta restringida theme={null}
{
"paths": {
"x-mint": {
"groups": ["admin", "billing"]
},
"/billing": {
"get": {
"summary": "Obtener detalles de facturación",
}
},
"/users": {
"get": {
"summary": "Obtener detalles de usuarios",
}
}
}
}
```
### Filtrar propiedades del esquema
Agrega `x-mint.groups` a propiedades individuales dentro de los cuerpos de las solicitudes, parámetros o respuestas. Las propiedades sin `x-mint.groups` siguen siendo visibles para todos los usuarios.
```json {11-13} Restricted property theme={null}
{
"components": {
"schemas": {
"User": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"internal_id": {
"type": "string",
"x-mint": {
"groups": ["admin"]
}
}
}
}
}
}
}
```
En este ejemplo, todos los usuarios pueden ver la propiedad `name`. Solo los usuarios del grupo `admin` pueden ver la propiedad `internal_id`.
### Filtrar variantes de oneOf
Agrega `x-mint.groups` a las opciones individuales de `oneOf` para restringir qué variantes de esquema puede ver un usuario.
```json {7-9} Restricted oneOf variant theme={null}
{
"schema": {
"oneOf": [
{
"title": "Enterprise config",
"type": "object",
"x-mint": {
"groups": ["enterprise"]
},
"properties": {
"sso_enabled": { "type": "boolean" }
}
},
{
"title": "Standard config",
"type": "object",
"properties": {
"notifications": { "type": "boolean" }
}
}
]
}
}
```
### Filtrar valores de enum
Usa la extensión `x-mint-enum` para restringir valores individuales de enum por grupo. Enumera cada valor restringido como una key, con sus grupos permitidos como value. Los valores de enum que no estén listados en `x-mint-enum` son visibles para todos los usuarios.
```json {4-7} Restricted enum values theme={null}
{
"type": "string",
"enum": ["free", "pro", "enterprise"],
"x-mint-enum": {
"pro": ["pro", "enterprise"],
"enterprise": ["enterprise"]
}
}
```
En este ejemplo, todos los usuarios ven `free`. Los usuarios de los grupos `pro` o `enterprise` ven `pro`. Solo los usuarios del grupo `enterprise` ven `enterprise`.
`x-mint-enum` es una extensión independiente de nivel superior en el objeto de esquema y no está anidada dentro de `x-mint`.
## Formato de datos de usuario
Tu sistema de identificación o autenticación devuelve datos de usuario que gestionan la personalización. Los campos `groups`, `content` y `apiPlaygroundInputs` descritos en esta página forman parte del objeto de datos de usuario.
Para obtener el formato completo de los datos de usuario y la referencia de campos, consulta [Formato de datos de usuario](/docs/es/deploy/authentication-setup#user-data-format).
## Comportamiento de cierre de sesión
El cierre de sesión se realiza en el cliente. Cuando los usuarios hacen clic en el botón de cerrar sesión, Mintlify borra los datos de la sesión almacenados en el navegador.
Para limitar el tiempo durante el cual persisten los datos de personalización, configura el campo `expiresAt` en los datos de usuario.
## Related topics
- [Migrar desde ReadMe](/docs/es/migration/readme.md)
- [Portales para desarrolladores personalizados](/docs/es/deploy/custom-portal.md)
- [Crear diseños de página personalizados](/docs/es/guides/custom-layouts.md)