# Proveedores de identidad y la sesión Un **proveedor de identidad** (IdP) es un programa DKL que, con el token de sesión de la petición, averigua quién es el usuario y deja sus datos en `@http_context/session`. Lo carga el `auth.dk` del sitio desde `_protected/idp/default.dk` (la ruta la da la variable `@auth.idp` de `auth.dk`). La plantilla `blank` trae dos: | Archivo | Valida el token contra | Úselo cuando | |---|---|---| | `idp/default.dk` | La API de autenticación de Induxsoft (`https://api.induxsoft.net/auth/login/`) | Sus usuarios inician sesión con cuentas de Induxsoft | | `idp/dbidp.dk` | Las tablas `tuser` y `sys_session` de una base de datos con el patrón de diseño de Devkron | Sus usuarios están en su propia base (sistemas sobre `dbr` con ese patrón) | Para usar `dbidp.dk`, cópielo encima de `default.dk` (o cambie `@auth.idp` en `auth.dk`) y ponga su conexión en `dbqname`. ## Qué debe hacer un IdP 1. Obtener el token con `auth.token()`. 2. Si es válido, poner los datos del usuario en `@http_context<"session/user*">` y los del proveedor en `@http_context<"session/idp*">`. 3. Mantener la cookie: `cookie.set("__induxsoft_token", token)` si es válido, vacía si no. 4. Si el token no es válido, **no** crear `session/user`. No debe lanzar errores: sin `session/user`, el resto del sitio trata al usuario como anónimo. El IdP se ejecuta dentro de `auth.dk`, que ya incluyó `functions.dkh`, `serialize.dkh`, `webcl.dkh`, `webauth.dkl` y FSO; el IdP incluye además lo suyo (`cookies.dkl`, `dbr.dkh`). ## idp/default.dk: API de Induxsoft ```dkl #include "dkli.dkh" #! module "Proveedor de Identidades [Id Provider] de Induxsoft" { #include "cookies.dkl" //Recuperar sesión del usuario token=auth.token() if token!="" { // API de autenticación de Induxsoft new h { @"Content-Type":"application/json" } new srq { @"ids":token @"memberships":@true } ref lgres=from.json(http.request("https://api.induxsoft.net/auth/login/","POST",h,to.json(srq))) if @@(lgres,"#success") { @http_context<"session/user*">: @@(lgres,"&data") new idp { @"name":"induxsoft_idp" } @http_context<"session/idp*">: idp do cookie.set("__induxsoft_token",token) } else { do cookie.set("__induxsoft_token","") } exception { } } } ``` Hace una llamada HTTP a la API en **cada** petición que trae token (incluidas las de CSS e imágenes), así que conviene que nginx entregue los estáticos directamente. No se ejecutó en las pruebas de esta documentación porque el equipo de pruebas no tiene salida a esa API. ## idp/dbidp.dk: base de datos Valida el token como un identificador de sesión de `sys_session`, lee el usuario de `tuser` y sus grupos de `user_usergroup_`/`usergroup`, y deja abierta la conexión **con la identidad del usuario** (`dbr.reconnect`) en `session/idp/database`, de modo que CRUD-L y sus programas la usen sin volver a conectarse: ```dkl #include "dkli.dkh" #! module "Proveedor de Identidades [Id Provider] desde base de datos" { #include "cookies.dkl" #include "dbr.dkh" dbqname="principal@tienda" //Recuperar sesión del usuario token=auth.token() if token!="" { ref db=dbr.reconnect(dbqname,token) new params { @"ids":token } ref uinfo=dbr.rec(db,"select u.userId, u.userName from tuser u inner join sys_session s on u.sys_pk=s.iuser where s.sys_guid=@ids;",params) new res { @"ids":token @"uid":field.str(uinfo,"userId") @"name":field.str(uinfo,"userName") @"multifactor":@false @"verified_email":@false @"verified_mobile":@false } ref lteams=dbr.list(db,"select g.sys_guid group_uuid,groupid, u.userid from `user_usergroup_` as ug inner join `usergroup` as g on ug.groups=g.sys_pk inner join tuser as u on ug.users=u.sys_pk where u.userid=@uid;",res) res<"memberships*">:record.create() res<"memberships/workspaces*">:list.create() res<"memberships/roles*">:list.create() res<"memberships/teams*">:list.create() do list.add(@@(res,"&memberships/workspaces"),dbqname) for i=0;i<@count(lteams) { do list.add(@@(res,"&memberships/teams"),@@(@item(lteams,i),"group_uuid")) } new idp { @"name":"db_idp" @"qname":dbqname @"database*":db } @http_context<"session/user*">: res @http_context<"session/idp*">: idp do cookie.set("__induxsoft_token",token) exception { do cookie.set("__induxsoft_token","") } } } ``` (El único cambio respecto al archivo de la plantilla es `dbqname`, que trae `yourconnection@appgroup`.) Puntos a saber: - El **equipo** de un usuario es el `sys_guid` de su grupo en `usergroup` (no el nombre `groupid`): en los manifiestos escriba `{"team":""}`. - El **espacio de trabajo** es el nombre cualificado de la conexión (`principal@tienda`). - Un token cerrado (`sys_session.sys_deleted=1`) o inexistente hace fallar `dbr.reconnect`; la excepción borra la cookie y no se crea `session/user`. Probado con 2.0 y MySQL 8: con el token de una sesión abierta con `dbr.login`, el IdP deja la sesión de abajo; después de `dbr.logout`, el mismo token ya no da sesión (`401 Debe iniciar sesión` en un recurso con `read`). ## La sesión: @http_context/session Volcado real de `session` con `dbidp.dk`, en una carpeta cuyo manifiesto es `{"admin":[{"user":"web"}]}`: ```json { "user": { "ids": "698f909806764cf195ebdaffd1d3360f", "uid": "web", "name": "Usuario web", "multifactor": 0, "verified_email": 0, "verified_mobile": 0, "memberships": { "workspaces": ["principal@tienda"], "roles": [], "teams": [] } }, "idp": { "name": "db_idp", "qname": "principal@tienda", "database": { "UseHashMD5Unicode": false } }, "resource": { "type": "folder", "fullpath": "/cuenta/yo/", "path": "/cuenta/yo", "name": "", "creation": "2026-10-27T11:36:44", "lastaccess": "2026-10-27T11:36:44", "lastwrite": "2026-10-27T11:36:44", "privileges": { "admin": [{ "user": "web" }] }, "priv_inherited": 1, "authforuser": ["admin"] } } ``` (`database` es el objeto de conexión; al serializarlo solo se ve una de sus propiedades.) | Miembro | Lo pone | Contenido | |---|---|---| | `session/user` | El IdP, si el token es válido | `ids` (token), `uid` (identificador del usuario), `name`, `multifactor`, `verified_email`, `verified_mobile`, `memberships` (`workspaces`, `teams`, `roles`: listas de cadenas). El IdP de Induxsoft puede traer más campos | | `session/idp` | El IdP | `name` del proveedor; con `dbidp.dk` además `qname` y `database` (conexión abierta con la identidad del usuario) | | `session/resource` | `auth.dk`, si el recurso tiene manifiesto | Metadatos del archivo o carpeta pedido (los mismos que devuelve FSO) y `privileges` (el manifiesto aplicable) | | `session/resource/authforuser` | `auth.dk` | Lista de privilegios del manifiesto que el usuario cumple | Si no hay token válido, `session` existe pero sin `user`; si el recurso no tiene manifiesto, no hay `resource`. ### Leerla desde su programa ```dkl #include "dkli.dkh" #! program "privado" { #include "functions.dkh" #include "serialize.dkh" new r { @"usuario": @@(@http_context,"$session/user/name") @"uid": @@(@http_context,"$session/user/uid") @"idp": @@(@http_context,"$session/idp/name") @"privilegios*": @@(@http_context,"&session/resource/authforuser") @"equipos*": @@(@http_context,"&session/user/memberships/teams") } @http_context<"response/headers/content-type">: "application/json;charset=utf-8" @http_context<"response/output">: "text" @http_context<"response/text">: to.json(r) } ``` Con manifiesto `{"read":[{"team":"a1b2c3d4e5f60718293a4b5c6d7e8f90"}],"write":[{"user":"web"}]}` y el usuario en ese equipo: ```json {"usuario":"Usuario web","uid":"web","idp":"db_idp","privilegios":["read","write"],"equipos":["a1b2c3d4e5f60718293a4b5c6d7e8f90"]} ``` Para saber si hay sesión: `@@(@http_context,"$session/user/ids") != ""`. Para verificar un privilegio: `auth.findStrInList(@@(@http_context,"&session/resource/authforuser"), "write")`. ## Escribir su propio IdP Con el mismo contrato puede validar un JWT, una llave de API o la sesión de otro sistema. Un esqueleto: ```dkl #include "dkli.dkh" #! module "Mi proveedor de identidad" { #include "cookies.dkl" token = auth.token() if token != "" { // ... valide el token y obtenga los datos del usuario ... new usuario { @"ids": token @"uid": "ana" @"name": "Ana López" } usuario<"memberships*">: from.json('{"workspaces":[],"teams":[],"roles":["ventas"]}') new idp { @"name": "mi_idp" } @http_context<"session/user*">: usuario @http_context<"session/idp*">: idp exception { } } } ``` Para validar tokens JWT use [hash.dkh](/es/devkron/2.0/bibliotecas/estandar/hash.md). ## Errores típicos | Síntoma | Causa y solución | |---|---| | Siempre anónimo aunque se envía el token | El IdP no encuentra el token (vea las ubicaciones de [auth.token](/es/devkron/2.0/marcos/autenticacion/webauth.md)) o el token ya no es válido | | `memberships/teams` vacío con `dbidp.dk` | El usuario no está en `user_usergroup_`, o falta la fila de `usergroup` | | Un manifiesto por equipo no funciona | Ponga el `sys_guid` del grupo, no su nombre | | Cada página tarda medio segundo | `default.dk` consulta la API de Induxsoft en cada petición con token |