# Inicio de sesión y permisos con webauth En esta guía agregará a `tienda.localhost` inicio y cierre de sesión contra los usuarios de la base de datos, una carpeta privada para un equipo y un servicio que decide qué mostrar según los permisos del usuario. Usa las piezas de [Autenticación y autorización](/es/devkron/2.0/marcos/autenticacion/): el proveedor de identidad de base de datos, el `auth.dk` de la plantilla y `webauth.dkl`. Requisitos: el sitio de [Crear un sitio nuevo](/es/devkron/2.0/guias/sitio-nuevo-nginx.md) (creado con la plantilla `blank`, que trae `auth.dk`) y la base `tienda2` con `tuser` y `sys_session` de la guía [CRUD con MySQL](/es/devkron/2.0/guias/crud-mysql.md#1-prepare-la-base-de-datos), con la conexión `principal@tienda2`. ## 1. Usuarios y equipos Agregue las tablas de grupos y dos usuarios: `ana`, del equipo de contabilidad, y `luis`, fuera de él (contraseña `MiClave#2026` para los dos). Cargue el script con `--default-character-set=utf8mb4` para que los acentos lleguen bien: ```sql create table usergroup ( sys_pk int not null auto_increment primary key, sys_timestamp datetime not null, sys_guid varchar(32) not null unique, sys_dtcreated datetime, groupid varchar(64) not null, sys_recver int null, sys_deleted bool null, sys_lock int null ); create table user_usergroup_ ( sys_pk int not null auto_increment primary key, `groups` int not null, users int not null ); insert into usergroup(sys_timestamp, sys_guid, sys_dtcreated, groupid) values (now(), '5a0c2f7e9b1d4e6f8a3b2c1d0e9f8a7b', now(), 'contabilidad'); insert into tuser(sys_timestamp, sys_guid, sys_dtcreated, userid, username, pwd, pwdmd5) values (now(), replace(uuid(),'-',''), now(), 'ana', 'Ana López', md5('MiClave#2026'), md5('MiClave#2026')), (now(), replace(uuid(),'-',''), now(), 'luis', 'Luis Pérez', md5('MiClave#2026'), md5('MiClave#2026')); insert into user_usergroup_(`groups`, users) select 1, sys_pk from tuser where userid='ana'; ``` En los manifiestos, el equipo se identifica por el `sys_guid` del grupo (`5a0c2f7e9b1d4e6f8a3b2c1d0e9f8a7b`), no por su nombre. ## 2. El proveedor de identidad Sustituya `_protected/idp/default.dk` por el ejemplo de base de datos de la plantilla y ponga su conexión: ```bash cd /opt/devkron/web/tienda.localhost/_protected/idp cp dbidp.dk default.dk sed -i 's/dbqname="yourconnection@appgroup"/dbqname="principal@tienda2"/' default.dk ``` Desde ahora, en cada petición con un token válido, `@http_context/session/user` trae al usuario y `session/idp/database` una conexión con su identidad ([Proveedores de identidad](/es/devkron/2.0/marcos/autenticacion/sesion.md)). ## 3. Manifiestos - Raíz del sitio, `web/tienda.localhost/._p_`, **sin `read`** (el sitio sigue siendo público): ```json {"admin":[{"user":"web"}],"dkl_fso_list":[{"user":"+"}],"dkl_fso_getprops":[{"user":"+"}]} ``` - Carpeta de la cuenta, `web/tienda.localhost/cuenta/._p_`, también sin `read`, para que la página de inicio de sesión nunca herede un manifiesto privado: ```json {"admin":[{"user":"web"}]} ``` ## 4. Iniciar sesión `web/tienda.localhost/cuenta/entrar.dkl`: ```dkl #include "dkli.dkh" #set "meta-xml-declaration" "\r\n" #! program "entrar" { #include "functions.dkh" #include "serialize.dkh" #include "dbr.dkh" #include "cookies.dkl" mensaje = "" destino = field.dstr(@http_context, "request/get/volver", "/") if toupper(@@(@http_context,"$request/headers/REQUEST_METHOD")) == "POST" { usuario = @@(@http_context,"$request/post/usuario") clave = @@(@http_context,"$request/post/clave") ref db = dbr.login("principal@tienda2", usuario, clave) token = dbr.getSID(db) do dbr.close(db) do cookie.set("__induxsoft_token", token) @http_context<"response/headers/Location">: destino return exception { mensaje = "Usuario o contraseña incorrectos" } } ## html(lang="es") { head { meta(charset="utf-8"){} title{"Iniciar sesión"} } body { h1{"Iniciar sesión"} p(style="color:#b00"){$"#"} form(method="POST" action="") { p{ label{"Usuario "} input(type="text" name="usuario" required="required"){} } p{ label{"Contraseña "} input(type="password" name="clave" required="required"){} } button(type="submit"){"Entrar"} } } } ## } ``` - `dbr.login` valida usuario y contraseña contra `tuser` y abre una sesión en `sys_session`; `dbr.getSID` devuelve su identificador, que es el **token**. - `cookie.set("__induxsoft_token", token)` lo guarda en el navegador; es una de las ubicaciones donde lo busca `auth.token` ([webauth.dkl](/es/devkron/2.0/marcos/autenticacion/webauth.md)). - Un nuevo inicio de sesión del mismo usuario cierra sus sesiones anteriores. - `volver` es la página a la que se regresa después de entrar. Tal como está, acepta cualquier URL; si lo usa en producción, limite su valor a rutas de su sitio. Resultados reales: ```text POST /cuenta/entrar.dkl?volver=/cuenta/perfil/ usuario=ana, clave correcta HTTP/1.1 302 Moved Temporarily Location: /cuenta/perfil/ Set-Cookie: __induxsoft_token=0354a091320e48768e2408bb2cc3bd81;Path=/;Max-Age=31104000 ``` Con una contraseña incorrecta, la misma página muestra `Usuario o contraseña incorrectos`. ## 5. Cerrar sesión `web/tienda.localhost/cuenta/salir.dkl`: ```dkl #include "dkli.dkh" #! program "salir" { #include "functions.dkh" #include "serialize.dkh" #include "dbr.dkh" #include "cookies.dkl" #include "webauth.dkl" token = auth.token() if token != "" { codeblock { ref db = dbr.reconnect("principal@tienda2", token) do dbr.logout(db) do dbr.close(db) exception { } } } do cookie.set("__induxsoft_token", "") @http_context<"response/headers/Location">: "/cuenta/entrar.dkl" } ``` `dbr.logout` cierra la sesión en la base: el token deja de servir aunque alguien lo haya copiado (comprobado: tras salir, el mismo token en `Authorization: Bearer` recibe 401). ## 6. Un servicio que depende del usuario `web/tienda.localhost/cuenta/perfil/index.dkl` responde los datos del usuario y un **permiso propio** (`ver_saldos`) resuelto con `auth.checkPrivs`: ```dkl #include "dkli.dkh" #! program "perfil" { #include "functions.dkh" #include "serialize.dkh" #include "webauth.dkl" @http_context<"response/headers/content-type">: "application/json;charset=utf-8" @http_context<"response/output">: "text" ref usuario = @@(@http_context,"&session/user") if isnull(usuario) { @http_context<"response/http_status">: 401 @http_context<"response/text">: '{"success":false,"message":"Inicie sesión"}' return } // Permiso propio: solo el equipo de contabilidad ve los saldos ref manifiesto = from.json('{"ver_saldos":[{"team":"5a0c2f7e9b1d4e6f8a3b2c1d0e9f8a7b"}]}') ref privs = auth.checkPrivs(usuario, manifiesto) new r { @"success": @true } new datos { @"uid": @@(usuario,"$uid") @"nombre": @@(usuario,"$name") @"ver_saldos": auth.findStrInList(privs, "ver_saldos") } r<"data*">: datos @http_context<"response/text">: to.json(r) } ``` Resultados reales: | Petición | Respuesta | |---|---| | Sin sesión | `401` `{"success":false,"message":"Inicie sesión"}` | | Con la cookie de `ana` | `{"success":1,"data":{"uid":"ana","nombre":"Ana López","ver_saldos":1}}` | | Con `Authorization: Bearer ` | Lo mismo: el token sirve igual desde un cliente REST | | Con la sesión de `luis` | `{"success":1,"data":{"uid":"luis","nombre":"Luis Pérez","ver_saldos":0}}` | | Con el token de `ana` después de salir | `401` | ## 7. Una carpeta privada para el equipo Para que `auth.dk` proteja una carpeta completa (páginas y archivos), declare `read` en su manifiesto. `web/tienda.localhost/contabilidad/._p_`: ```json {"read":[{"team":"5a0c2f7e9b1d4e6f8a3b2c1d0e9f8a7b"}],"admin":[{"user":"web"}]} ``` | Quién | Cualquier página o archivo de `/contabilidad/` | |---|---| | Sin sesión | Página 500 con `{401} Debe iniciar sesión (Unauthorized)` | | `luis` | Página 500 con `{403} No autorizado (Forbidden)` | | `ana` | La página; `session/resource/authforuser` trae `["read"]` | Si prefiere mandar al usuario sin sesión a la página de inicio de sesión en lugar de mostrar el error, adapte `auth.dk` como se explica en [El auth.dk de la plantilla](/es/devkron/2.0/marcos/autenticacion/auth-dk.md#adaptarlo), o haga la verificación en cada página, como el servicio del paso 6 y la página de la guía [Subir y servir archivos con FSO](/es/devkron/2.0/guias/archivos-fso.md). ## Errores típicos | Síntoma | Causa y solución | |---|---| | `session/user` nunca aparece | El IdP sigue siendo el de la API de Induxsoft, o `dbqname` no es su conexión | | La sesión "se cae" al entrar en otro navegador | Un nuevo inicio de sesión cierra las sesiones anteriores del usuario | | La página de inicio de sesión pide sesión | Su carpeta hereda un manifiesto con `read`: dele uno propio sin `read` | | `ver_saldos` siempre 0 | El manifiesto usa el nombre del grupo; use su `sys_guid` | | El token en un cuerpo JSON no funciona | Defecto conocido de `auth.token` con JSON: use `Authorization: Bearer` |