# Subir y servir archivos con FSO En esta guía montará en `tienda.localhost` una carpeta `/documentos` donde solo el equipo de contabilidad puede ver, subir y organizar archivos, y una página que los lista con un formulario para subir. Usará la [API FSO](/es/devkron/2.0/marcos/fso/) y sus manifiestos de privilegios: no escribirá código para guardar archivos. Requisitos: el sitio de [Crear un sitio nuevo](/es/devkron/2.0/guias/sitio-nuevo-nginx.md) con la regla `.fso > $fso/fso.*.dkl` en `_protected/ext.map`, y el inicio de sesión de [Inicio de sesión y permisos](/es/devkron/2.0/guias/inicio-de-sesion.md) (proveedor de identidad de base de datos, usuarios `ana` del equipo de contabilidad y `luis` fuera de él). ## 1. El manifiesto de la raíz `web/tienda.localhost/._p_`: el usuario `web` administra todo y cualquiera puede listar y ver metadatos. **Sin `read`**, para que las páginas públicas sigan siéndolo: ```json {"admin":[{"user":"web"}],"dkl_fso_list":[{"user":"+"}],"dkl_fso_getprops":[{"user":"+"}]} ``` ## 2. El manifiesto de la carpeta Cree `web/tienda.localhost/documentos/` y su `._p_`. El equipo de contabilidad (el `sys_guid` del grupo en `usergroup`) puede leer, listar, subir y crear carpetas; solo `ana` puede borrar: ```json { "read": [{"team":"5a0c2f7e9b1d4e6f8a3b2c1d0e9f8a7b"}], "dkl_fso_list": [{"team":"5a0c2f7e9b1d4e6f8a3b2c1d0e9f8a7b"}], "dkl_fso_getprops": [{"team":"5a0c2f7e9b1d4e6f8a3b2c1d0e9f8a7b"}], "dkl_fso_upload": [{"team":"5a0c2f7e9b1d4e6f8a3b2c1d0e9f8a7b"}], "dkl_fso_mkdir": [{"team":"5a0c2f7e9b1d4e6f8a3b2c1d0e9f8a7b"}], "dkl_fso_delete": [{"user":"ana"}], "admin": [{"user":"web"}] } ``` Como el manifiesto **declara `read`**, el `auth.dk` del sitio también protege la descarga directa de los archivos. Los privilegios se explican en [Metadatos y privilegios](/es/devkron/2.0/marcos/fso/privilegios.md). ## 3. Suba, liste, descargue y borre Inicie sesión como `ana` (la cookie queda en `ana.txt`): ```bash curl -c ana.txt -X POST "http://tienda.localhost/cuenta/entrar.dkl" \ --data-urlencode "usuario=ana" --data-urlencode "clave=MiClave#2026" ``` Respuestas reales: ```bash curl -b ana.txt -F "archivo=@factura-octubre.pdf" "http://tienda.localhost/documentos/upl.fso" ``` ```json {"success":1,"data":{"factura-octubre.pdf":{"done":1}}} ``` | Acción | Comando | Respuesta | |---|---|---| | Subir a una subcarpeta (se crea) | `curl -b ana.txt -F "2026/10/factura=@factura-octubre.pdf" .../documentos/upl.fso` | `{"success":1,"data":{"factura-octubre.pdf":{"done":1}}}` y el archivo en `documentos/2026/10/` | | Listar | `curl -b ana.txt ".../documentos/lst.fso?deep=0"` | `files`: `factura-octubre.pdf`; `folders`: `2026` | | Descargar | `curl -b ana.txt .../documentos/factura-octubre.pdf` | 200, `Content-Type: application/pdf` | | Borrar la carpeta 2026 | `curl -b ana.txt -X POST -H "Content-Type: application/json" -d '{"2026":{"action":"delete"}}' .../documentos/do.fso` | `{"success":1,"data":{"2026":{"done":1}}}` | | Subir un `.dkl` | `curl -b ana.txt -F "archivo=@prueba.dkl" .../documentos/upl.fso` | `{"prueba.dkl":{"message":"No autorizado","done":0}}` (extensión peligrosa) | Y lo que **no** pueden hacer los demás: | Quién | Acción | Respuesta | |---|---|---| | Sin sesión | Descargar `/documentos/factura-octubre.pdf` | 500 con `{401} Debe iniciar sesión (Unauthorized)` | | `luis` (fuera del equipo) | Descargar | 500 con `{403} No autorizado (Forbidden)` | | `luis` | `lst.fso` | `{"success":1,"data":null}` | | `luis` | `upl.fso` | `{"success":0,"message":"... No está autorizado para subir archivos en esta ubicación..."}` | Tome en cuenta: - Subir un archivo con un nombre que ya existe **lo sustituye**. - La carpeta de destino de `upl.fso` (la de la URL) debe existir; las subcarpetas en el nombre del campo sí se crean. Si necesita una carpeta nueva como destino, créela antes con `do.fso` (`{".":{"action":"mkdir","path":"nueva"}}`). ## 4. Una página para sus usuarios `web/tienda.localhost/archivos/index.dkl` lista los documentos con la biblioteca `fso.dk` (respetando los mismos privilegios) y ofrece un formulario para subir. Dele a la carpeta `archivos/` un manifiesto sin `read`, igual al de la raíz, para que la página se pueda abrir y ella misma decida: ```dkl #include "dkli.dkh" #set "meta-xml-declaration" "\r\n" #! program "documentos" { #include "functions.dkh" #include "serialize.dkh" #include "webauth.dkl" #include "fso/fso.config.dk" #include "fso/fso.dk" if @@(@http_context,"$session/user/ids") == "" { @http_context<"response/headers/Location">: "/cuenta/entrar.dkl?volver=/archivos/" return } new p { @"base_path": @@(@http_context,"$request/headers/document_root") @"uri": "/documentos" @"filter": "*.*" @"deep": 0 @"mode": 2 } ref r = dklfso.list(p) ref archivos = @@(r,"&files") ## html(lang="es") { head { meta(charset="utf-8"){} title{"Documentos"} } body { h1{$"Documentos de #<@@(@http_context,'$session/user/name')>"} ## if isnull(r) { ## p{"No tiene acceso a la carpeta de documentos."} ## } else { ## ul { ## for i=0; i<@count(archivos) { ref f = @item(archivos,i) ## li{ a(href="#<@@(f,'$fullpath')>"){$"#<@@(f,'$name')>"} $" (#<@@(f,'$length')> bytes)" } ## } ## } form(action="/documentos/upl.fso" method="POST" enctype="multipart/form-data") { input(type="file" name="archivo"){} button(type="submit"){"Subir"} } ## } ## p{ a(href="/cuenta/salir.dkl"){"Cerrar sesión"} } } } ## } ``` Resultados reales: | Quién | `GET /archivos/` | |---|---| | Sin sesión | `302`, `Location: /cuenta/entrar.dkl?volver=/archivos/` | | `ana` | `

Documentos de Ana López

` | | `luis` | `

Documentos de Luis Pérez

No tiene acceso a la carpeta de documentos.

` | El formulario envía el archivo directo a `upl.fso`, que responde JSON. Para volver a la página después de subir, envíe el formulario con JavaScript (`fetch`) y recargue la lista al recibir `success`. ## 5. Servir archivos que no están en el sitio Si los archivos deben vivir fuera de la carpeta del sitio (otro disco, una carpeta compartida), publíquelos con `paths.map` ([Enrutamiento](/es/devkron/2.0/marcos/servidor-web/enrutamiento.md#pathsmap-carpetas-virtuales)) o entréguelos desde un programa con `output` = `binary` ([Responder un archivo](/es/devkron/2.0/marcos/servidor-web/respuestas.md#un-archivo-binario)), verificando usted los permisos. FSO solo administra archivos dentro del sitio (salvo con `@dklfso_multisites`). ## Errores típicos | Síntoma | Causa y solución | |---|---| | `.fso` responde 404 | Falta la regla en `ext.map` o apunta a `$/fso/...` | | Todo responde `data: null` o `No autorizado` | No hay manifiesto en la ruta: sin manifiesto FSO niega todo, incluso a los administradores | | Todo el sitio pide sesión | Se declaró `read` en el manifiesto de la raíz | | `No está autorizado para crear la estructura de directorios` | La carpeta de destino de la URL no existe: créela con `do.fso` | | Un usuario del equipo no tiene acceso | El manifiesto usa el nombre del grupo; debe ser su `sys_guid` |