# El auth.dk de la plantilla La plantilla de sitio `blank` de dkl-web trae `_protected/auth.dk`, el **controlador de autorizaciones**: un programa que el servidor ejecuta antes de cada petición del sitio (vea [Autorización y post-procesamiento](/es/devkron/2.0/marcos/servidor-web/auth-y-render.md)). Identifica al usuario con el proveedor de identidad, averigua los privilegios del usuario sobre el recurso pedido y aplica el privilegio `read`. ## El código ```dkl #include "dkli.dkh" #! program { #include "functions.dkh" #include "serialize.dkh" #include "webcl.dkh" #include "webauth.dkl" #include "fso/fso.config.dk" #include "fso/fso.dk" @auth.idp=path.concat(@dklfso_protected_dir,"idp/default.dk") ref @http_context=@@(@http_request,"&http_context") base_path=field.dstr(@http_request,"base_path","") @http_context<"session*">:record.create() include path.concat(base_path,@auth.idp) //Recuperar manifiesto de privilegios del recurso solicitado do _map_function(_import_library("System.Net.dll"),"System.Net.WebUtility","UrlDecode","net.urldecode","System.String","$") uri=net.urldecode(list.str(split(field.dstr(@http_context,"request/headers/request_uri","/"),"?"),0)) ref res_info=dklfso.createObjectInfo(base_path,uri) if isnull(res_info) { return } // Abortar si no se puede recuperar información del recurso if field.typeof(res_info,"privileges")!=3 { return } // Abortar si no hay manifiesto de privilegios @http_context<"session/resource*">:res_info ref user=@@(@http_context,"&session/user") if isnull(user) { ref user=record.create() using user{@"uid":"*"} } ref privs=auth.checkPrivs(user, @@(res_info,"&privileges")) @http_context<"session/resource/authforuser*">:privs if field.typeof(res_info,"privileges/"+@privid_read)!=3 { return } //Abortar si no está establecido explícitamente el privilegio de lectura ref read_privs=@@(res_info,"&privileges/"+@privid_read) if isnull(read_privs) { return } if isnull(@@(@http_context,"&session/user")) { do rise_error(401,"Debe iniciar sesión (Unauthorized)")} //Verificar el permiso de lectura if not(auth.findStrInList(privs, @privid_read)) { do rise_error(403,"No autorizado (Forbidden)") } } ``` ## Qué hace, paso a paso 1. **Prepara la sesión**: toma el contexto de la petición (`@http_request/http_context`) y crea `session` vacío. 2. **Carga el IdP** `_protected/idp/default.dk` (variable `@auth.idp`), que deja `session/user` si hay un token válido. Vea [Proveedores de identidad](/es/devkron/2.0/marcos/autenticacion/sesion.md). 3. **Busca el recurso**: con la URI de la petición (sin la cadena de consulta, decodificada) obtiene sus metadatos con `dklfso.createObjectInfo`, incluido el manifiesto de privilegios propio o heredado. 4. **Sin recurso o sin manifiesto, termina**: la petición sigue sin restricciones. Esto incluye las URL que no corresponden a un archivo real (las de `routes.map`), cuyos datos no existen en disco. 5. **Calcula los privilegios**: guarda el recurso en `session/resource` y en `session/resource/authforuser` la lista de privilegios del usuario (o del anónimo, `uid` = `*`). 6. **Aplica `read`** solo si el manifiesto lo declara: sin sesión, `401 Debe iniciar sesión (Unauthorized)`; con sesión y sin el privilegio, `403 No autorizado (Forbidden)`. Como `rise_error` desde `auth.dk` detiene la petición, el navegador recibe la página de error 500 del controlador con el mensaje (`{401} Debe iniciar sesión (Unauthorized)`); el código 401 o 403 va en el texto, no en el estado HTTP. ## Proteger una carpeta Los manifiestos son archivos `._p_` en formato JSON (los mismos de la [API FSO](/es/devkron/2.0/marcos/fso/privilegios.md)). Para que solo un equipo vea `/privado/`, cree `web//privado/._p_`: ```json {"read":[{"team":"a1b2c3d4e5f60718293a4b5c6d7e8f90"}],"write":[{"user":"web"}]} ``` Resultados reales con el IdP de base de datos: | Petición a `/privado/` | Respuesta | |---|---| | Sin sesión | 500 con `{401} Debe iniciar sesión (Unauthorized)` | | Con sesión de un usuario del equipo | 200 y `session/resource/authforuser` = `["read","write"]` | | Con sesión de un usuario fuera del equipo | 500 con `{403} No autorizado (Forbidden)` | | Con un token ya cerrado | 500 con `{401} ...` (el IdP no reconoce el token) | ### Cuidado con el manifiesto de la raíz El manifiesto se **hereda** por las carpetas inferiores que no tienen uno propio, y se aplica completo. Si pone en la raíz del sitio un manifiesto con `read` (por ejemplo, `{"read":[{"user":"+"}], ...}` para dar lectura a todos en FSO), **todas** las páginas del sitio pasan a exigir sesión, incluida la de inicio de sesión: la condición `+` se cumple con cualquier usuario, pero `auth.dk` exige primero que haya sesión cuando `read` está declarado. Comprobado en 2.0: con ese manifiesto en la raíz, `GET /` responde `{401} Debe iniciar sesión`. Para un sitio público con carpetas privadas: - No declare `read` en el manifiesto de la raíz; dé ahí solo los privilegios de FSO que necesite (`dkl_fso_list`, `dkl_fso_getprops`...) y `admin`. - Ponga `read` solo en los manifiestos de las carpetas privadas. - Dé a la carpeta de la página de inicio de sesión un manifiesto propio **sin** `read` (por ejemplo `{"admin":[{"user":"web"}]}`), para que no herede el de una carpeta privada. ## Adaptarlo - **Otro IdP**: cambie `@auth.idp` o el archivo `idp/default.dk`. - **Redirigir al inicio de sesión** en lugar de mostrar el error 401: antes del `rise_error(401, ...)`, cambie el destino de la petición y termine: ```dkl if isnull(@@(@http_context,"&session/user")) { @http_request<"document_path">: path.concat(base_path, "cuenta/entrar.dkl") return } ``` - **Rutas de `routes.map`**: como no corresponden a archivos, `auth.dk` no las restringe. Proteja esos programas en el propio programa (revisando `session/user`) o agregue a `auth.dk` reglas por URI. - **Rendimiento**: `auth.dk` corre en cada petición, incluidos los archivos estáticos. Si sirve muchos, que nginx los entregue directamente. ## Errores típicos | Síntoma | Causa y solución | |---|---| | Todo el sitio pide iniciar sesión | Hay un `read` en el manifiesto de la raíz o de una carpeta superior (vea arriba) | | La página de inicio de sesión también pide sesión | Su carpeta hereda un manifiesto con `read`: dele uno propio sin `read` | | `Variable global '@http_request' no definida` al abrir `/_protected/auth.dk` | Se pidió el archivo por su URL; restrinja la carpeta protegida (`@http_restrict_protected_dir`) | | Un usuario con el privilegio recibe 403 | El manifiesto que se aplica es otro (el más cercano gana y no se combina); revise `session/resource/priv_inherited` y `privileges` |