Cargando

Saltar al contenido

Usar UTILIA OS Desarrolladores

Entrar Únete a la lista de espera

Empezar

API

Conectar

Insertar en tu web

Cambios

Cargando la pantalla

¿Aún no usas UTILIA OS?

Únete a la lista de espera

Aviso legal
Privacidad
Cookies

© 2026 UTILIA SERVICIOS IA S. COOP. CAN.

Documentación
Para desarrolladores
Iniciar sesión con UTILIA

Iniciar sesión con UTILIA

OAuth 2.1 y OpenID Connect: que las personas entren en tu aplicación con su cuenta de UTILIA OS y que esta trabaje con sus datos en su nombre.

Entrar en Aplicaciones externas

Cómo encaja el inicio de sesión con UTILIA

Recibe de

Integraciones
Activas OAuth en la ficha de cada aplicación externa y obtienes sus credenciales.
Usuarios y permisos
Cada scope solo se concede si la persona tiene el permiso equivalente.
Mi plan
Los scopes de aplicativos que la organización no tiene contratados no se conceden.

Iniciar sesión con UTILIA

El servidor OAuth 2.1 y OpenID Connect de UTILIA OS.

Envía a

Copiloto y MCP
El token abre, en nombre de la persona, el servidor MCP al que va atado.
Conecta tu IA
Los asistentes de IA se autorizan con este mismo servidor y la misma pantalla de consentimiento.
Perfil › Aplicaciones
Cada persona ve las aplicaciones que ha autorizado y puede retirarles el acceso.

Empieza por aquí

OAuth: visión general

Qué te permite hacer el servidor OAuth 2.1 y OpenID Connect de UTILIA OS, qué endpoints expone y cuánto duran sus tokens.

General

Tu primer token en cinco minutosRegistra un cliente, genera PKCE, autoriza y canjea el código: de cero a un access token de UTILIA OS con curl, JavaScript o Python.
Descubrimiento del servidorEndpoints .well-known con los que los clientes OAuth, OpenID Connect y MCP se configuran solos: qué devuelve cada uno y para qué sirve.
Flujo de autorizaciónCómo pedir la autorización con PKCE: parámetros de /api/oauth/authorize, qué ve la persona, cómo vuelve el código y qué errores pueden llegar.
Canje, revocación e introspección de tokensCanjea el código por tokens, renuévalos con el refresh token, revócalos y comprueba su estado con los endpoints token, revoke e introspect.
Rotación del refresh tokenCada renovación entrega un refresh token nuevo y anula el anterior: cómo guardar siempre el último, qué pasa si se reutiliza uno viejo y cómo evitar renovaciones simultáneas.
Scopes y recursosCatálogo de scopes de UTILIA OS, qué incluye cada conjunto y qué scopes puede llevar un token según el servidor MCP al que va atado.
Scopes y claims de OpenID ConnectQué datos de la persona recibes en el id_token y en /api/oauth/userinfo según los scopes openid, profile y email, y cómo verificarlos.
Pantalla de consentimientoQué ve la persona cuando tu aplicación pide acceso, cómo se agrupan los permisos, qué puede desactivar y cómo afecta eso al token que recibes.
Cierre de sesión desde tu aplicaciónCómo cerrar la sesión de una persona que entró con UTILIA: revoca sus tokens y, si quieres, pásala por el endpoint de cierre de sesión de OpenID Connect.
Activar OAuth en tu aplicaciónActiva el inicio de sesión con UTILIA en una aplicación externa desde el panel: direcciones de vuelta, tipo de aplicación, credenciales y enlaces legales.
Botones y marcaEl botón «Iniciar sesión con UTILIA» listo para copiar, con los logotipos, los iconos, los colores y la tipografía oficiales de UTILIA OS.

Ejemplos

Iniciar sesión con UTILIA en Next.jsAñade el botón «Iniciar sesión con UTILIA» a una aplicación Next.js con Auth.js: UTILIA OS actúa como proveedor OpenID Connect y la configuración es mínima.
Iniciar sesión con UTILIA en FlaskAñade el botón «Iniciar sesión con UTILIA» a una aplicación Flask con Authlib, que descubre la configuración de UTILIA OS y verifica el id_token por ti.
Iniciar sesión con UTILIA con el SDK JavaScriptImplementa «Iniciar sesión con UTILIA» con @utilia-os/sdk-js: URL de autorización con PKCE, canje del código, datos de la persona y cierre de sesión.
Iniciar sesión con UTILIA con el SDK PythonImplementa «Iniciar sesión con UTILIA» con utilia-sdk, en modo asíncrono o síncrono: URL de autorización con PKCE, canje del código, datos de la persona y cierre de sesión.

Ayuda

Problemas frecuentes con OAuthCómo resolver los errores más habituales al integrar el inicio de sesión con UTILIA: direcciones de vuelta, PKCE, invalid_grant, CORS, permisos y límites de uso.
Cambios de OAuthHistorial de cambios del servidor OAuth 2.1 de UTILIA OS y de lo que lo rodea: cambios incompatibles, retiradas con fecha, novedades y refuerzos de seguridad.