# Autenticación y autorización dkl-web trae las piezas para saber **quién** hace una petición y **qué puede hacer** con el recurso que pide, siguiendo el Modelo de Autorización de Acceso a Recursos de Induxsoft (RAAM). A ese conjunto se le llamó en 1.0 *Devkron Basic Web Layer* (BWL). Esta sección es para el programador que necesita inicio de sesión, servicios con token o carpetas con permisos. Úsela junto con [Servidor web](/es/devkron/2.0/marcos/servidor-web/), donde se explica dónde se ejecuta `auth.dk`. ## Las piezas | Pieza | Archivo | Qué hace | |---|---|---| | Biblioteca de autenticación | `webauth.dkl` | `auth.token()` busca el token de sesión de la petición; `auth.checkPrivs()` resuelve un manifiesto de privilegios contra el usuario | | Biblioteca de cookies | `cookies.dkl` | Lee y escribe cookies (la sesión del navegador viaja en `__induxsoft_token`) | | Proveedor de identidad (IdP) | `_protected/idp/default.dk` del sitio | Con el token, obtiene los datos del usuario y los deja en `@http_context/session/user` | | Controlador de autorizaciones | `_protected/auth.dk` del sitio | En cada petición: carga el IdP, obtiene el manifiesto del recurso (con FSO), calcula los privilegios del usuario y exige `read` si el manifiesto lo declara | | API FSO | `fso/` de la instalación | Guarda los manifiestos de privilegios (`._p_`) y verifica los demás privilegios al operar con archivos | ## El flujo de una petición 1. `auth.dk` crea `@http_context/session` vacío. 2. Carga el IdP. El IdP llama a `auth.token()`; si hay token y es válido, agrega `session/user` (y `session/idp`). 3. `auth.dk` busca el manifiesto de privilegios del archivo o carpeta pedido (el propio o el de una carpeta superior). Si no hay, termina y la petición sigue. 4. Si hay manifiesto, lo deja en `session/resource` y agrega `session/resource/authforuser` con la lista de privilegios que el usuario tiene sobre ese recurso. Sin sesión, se evalúa como el usuario anónimo (`uid` = `*`). 5. Si el manifiesto declara `read`: sin sesión responde **401** (`Debe iniciar sesión`) y sin el privilegio responde **403** (`No autorizado`). Si no declara `read`, el recurso es público. 6. Su programa lee `session` y decide lo demás. ## Los cuatro privilegios básicos | Privilegio | Significado | |---|---| | `read` | Lectura. Es el **único** que `auth.dk` verifica, y solo si el manifiesto lo declara: no declararlo hace el recurso público | | `write` | Escritura | | `plus` | Propósito general; se usa para elevar otro privilegio (`read` + `plus` es casi `write`) | | `admin` | Administrador, sin restricciones | Si una capa superior define privilegios propios (como FSO con `dkl_fso_upload`, `dkl_fso_delete`...), debe dar un **mapa de resolución** que los traduzca a los cuatro básicos; en FSO es la función `dklfso.authOp`. La verificación de `write`, `plus`, `admin` y de los privilegios propios le toca a esa capa (FSO o su aplicación), no a `auth.dk`. ## Contenido | Página | Qué aprenderá | |---|---| | [webauth.dkl](/es/devkron/2.0/marcos/autenticacion/webauth.md) | `auth.token`, `@http_token_locations` (dónde se busca el token y en qué orden), `auth.checkPrivs` y `auth.findStrInList` | | [cookies.dkl](/es/devkron/2.0/marcos/autenticacion/cookies.md) | `cookie.get`, `cookie.dget`, `cookie.set`, `cookie.setw` | | [Proveedores de identidad y la sesión](/es/devkron/2.0/marcos/autenticacion/sesion.md) | `idp/default.dk` (API de Induxsoft), `idp/dbidp.dk` (base de datos), escribir uno propio y la estructura de `session/user`, `session/idp` y `session/resource` | | [El auth.dk de la plantilla](/es/devkron/2.0/marcos/autenticacion/auth-dk.md) | Qué hace línea por línea, cómo proteger una carpeta con un manifiesto y cómo adaptarlo | Para una receta completa (página de inicio de sesión, cierre de sesión, carpeta privada por equipo) vea la guía [Inicio de sesión y permisos](/es/devkron/2.0/guias/inicio-de-sesion.md). Para tokens JWT y OAuth con proveedores externos están [hash.dkh](/es/devkron/2.0/bibliotecas/estandar/hash.md) y [oauth.dkh](/es/devkron/2.0/bibliotecas/estandar/oauth.md).