# Autorización y post-procesamiento Además del enrutamiento, el controlador ofrece dos puntos donde cada sitio puede intervenir en **todas** sus peticiones, con programas DKL en la carpeta protegida: | Programa | Cuándo se ejecuta | Recibe | Para | |---|---|---|---| | `_protected/auth.dk` | Después del enrutamiento, antes de su programa | `@http_request` | Decidir si la petición puede continuar, identificar al usuario, cambiar el destino | | `_protected/render.dk` | Cuando la respuesta ya está lista | `@http_context` | Retocar la respuesta: encabezados comunes, envolver contenido en una plantilla, bitácora | Si el archivo no existe, el paso se omite. Para lógica común a **todos** los sitios del servidor están los programas del controlador `fastcgi/auth.dkl` y `fastcgi/render.dkl` (vea [El controlador](/es/devkron/2.0/marcos/servidor-web/controlador-y-pila.md)). ## auth.dk `auth.dk` recibe la misma variable `@http_request` que `routing.dk` (`host`, `uri`, `base_path`, `document_path` y `http_context`). Para trabajar con el contexto cómodamente, tome la referencia: ```dkl ref @http_context = @@(@http_request, "&http_context") ``` Lo que agregue a ese contexto (por ejemplo, el miembro `session`) lo verá su programa. **Para detener la petición, lance un error con `rise_error`**: el controlador deja de procesarla y responde la página de error `500.dkl` con el mensaje. Es la forma más simple y segura de negar el acceso. Tenga en cuenta que el código que usted ponga en `rise_error` (401, 403) **no** se convierte en el estado HTTP: la respuesta sale con estado 500 y el código aparece en el texto (`{401} Llave de API inválida`). Si el cliente necesita el estado exacto, cambie `document_path` a un programa que responda ese estado. Ejemplo: exigir una llave en el encabezado `X-Api-Key` para todo lo que esté bajo `/api/`: ```dkl #include "dkli.dkh" #! program "auth.dk" { #include "functions.dkh" ref @http_context = @@(@http_request, "&http_context") uri = @@(@http_context, "$request/headers/REQUEST_URI") if findstr(uri, "/api/") == 0 { if @@(@http_context, "$request/headers/HTTP_X_API_KEY") != "MiLlave#2026" { do rise_error(401, "Llave de API inválida") } } } ``` Resultado real: ```text GET /api/v1/productos/CUA-100 → 500, "{401} Llave de API inválida" GET /api/v1/productos/CUA-100 (X-Api-Key correcta) → 200, {"success":1,"data":{...}} ``` La plantilla de sitio `blank` trae un `auth.dk` completo que identifica al usuario con un proveedor de identidad, arma `@http_context/session` y aplica el privilegio `read` de los manifiestos de FSO. Úselo como base: está explicado en [Autenticación y autorización](/es/devkron/2.0/marcos/autenticacion/auth-dk.md). El código que usted ponga en `auth.dk` se ejecuta en **cada** petición, incluidas las de archivos estáticos (CSS, imágenes): manténgalo rápido y no abra conexiones a la base de datos si no las necesita. ## render.dk `render.dk` se ejecuta al final, con la respuesta ya armada en `@http_context` (aquí **no** existe `@http_request`). Lo que cambie en `response` es lo que se envía: ```dkl #include "dkli.dkh" #! module "render.dk" { #include "functions.dkh" @http_context<"response/headers/X-Sitio">: "tienda" } ``` ```text GET /resp/json.dkl HTTP/1.1 200 OK X-Sitio: tienda ``` Usos típicos: - Agregar encabezados comunes (CORS, seguridad, caché) a todas las respuestas. - Convertir un archivo Markdown solicitado en HTML y envolverlo en la plantilla del sitio (con la [biblioteca Markdown](/es/devkron/2.0/bibliotecas/terceros/markdown.md)). - Escribir una bitácora de las respuestas. `render.dk` se ejecuta también con los archivos estáticos (comprobado: un `.css` sale con el encabezado `X-Sitio`), así que, igual que `auth.dk`, debe ser rápido. ## La variable @http_request Solo existe en `routing.dk` y `auth.dk`. En todos los demás programas el contexto completo es `@http_context`. | Miembro | Contenido | |---|---| | `host` | Nombre del host de la petición | | `uri` | URI del documento dentro del sitio | | `base_path` | Carpeta del sitio | | `document_path` | Archivo que se entregará o ejecutará | | `http_context` | El contexto de la petición hasta ese momento (puede ir cambiando) | Si cambia `document_path`, cambia lo que responde el servidor. Por ejemplo, un `auth.dk` que manda a la página de inicio de sesión a quien no tiene sesión puede poner `document_path` en el programa de login en lugar de lanzar un error. ## Errores típicos | Síntoma | Causa y solución | |---|---| | Todo el sitio responde 500 después de crear `auth.dk` | Un error en `auth.dk` detiene todas las peticiones. Pruebe el sitio con una página simple y revise el mensaje de la página 500 | | `Variable global '@http_request' no definida` | El programa se pidió directamente por su URL. Solo el controlador debe ejecutar `auth.dk` y `routing.dk`: restrinja la carpeta protegida | | Los cambios a `session` no llegan al programa | Se modificó un contexto distinto: tome `ref @http_context = @@(@http_request,"&http_context")` y escriba en él |