# Metadatos y privilegios de FSO Cada carpeta y archivo del sitio puede tener dos clases de metadatos, guardados en archivos JSON junto al recurso: - **Propiedades extendidas** (`._m_`): datos libres (título, autor, etiquetas). - **Manifiesto de privilegios** (`._p_`): quién puede hacer qué. No existen de forma predeterminada; se crean con [set.fso](/es/devkron/2.0/marcos/fso/servicios.md#setfso-propiedades-privilegios-y-contenido-de-texto) o a mano. Nunca aparecen en los listados de `lst.fso`. ## Propiedades extendidas Se guardan en archivos con extensión `._m_` (`@dklfso_metadata_ext`) y contienen cualquier objeto JSON. | Recurso | Archivo de propiedades | |---|---| | Carpeta `/documentos` | `/documentos/._m_` (un archivo sin nombre, solo la extensión, dentro de la carpeta) | | Archivo `notas.docx` | `notas.docx._m_`, junto al archivo | Sin ese archivo, el recurso solo tiene los datos del sistema de archivos: nombre, fechas de creación, último acceso y última escritura (UTC) y, en archivos, tamaño. ## Manifiesto de privilegios Se guarda en archivos `._p_` (`@dklfso_privs_ext`), con la misma convención: `._p_` dentro de la carpeta o `._p_` junto al archivo. ### Formato Un objeto JSON cuyas **llaves son privilegios** y cuyos valores son listas de **condiciones**; el usuario tiene el privilegio si cumple **alguna**: ```json { "read": [ { "user": "+" } ], "write": [ { "role": "editores" }, { "user": "ana" } ], "plus": [ { "team": "ti" } ], "admin": [ { "user": "web" } ], "dkl_fso_upload": [ { "workspace": "ventas" } ] } ``` Cada condición tiene **un solo par** `tipo: valor` (si trae más, solo se evalúa el primero): | Condición | Se cumple cuando | |---|---| | `{"user": "id"}` | El `uid` del usuario es `id` | | `{"user": "+"}` | Siempre: cualquier usuario, con o sin sesión | | `{"user": "*"}` | El usuario es anónimo (sin sesión) | | `{"role": "x"}` | `x` está en `memberships/roles` | | `{"team": "x"}` | `x` está en `memberships/teams` | | `{"workspace": "x"}` | `x` está en `memberships/workspaces` | | `{"campo": "valor"}` | El campo indicado del usuario vale `valor` (`{"email": "ana@ejemplo.com"}`) | Los privilegios pueden ser los cuatro básicos (`read`, `write`, `plus`, `admin`) o los de operación (`dkl_fso_*`, abajo). La evaluación la hace `auth.checkPrivs` de [webauth.dkl](/es/devkron/2.0/marcos/autenticacion/webauth.md). ### Herencia Para un recurso, FSO usa: 1. Su propio manifiesto. 2. Si no tiene, el de su carpeta, luego el de la carpeta superior, y así hasta la raíz del sitio (máximo `@dklfso_privs_revdeep` niveles, 50). **El primero que encuentra se aplica completo**; no se combina con los de arriba. `priv_inherited` en las respuestas dice a cuántos niveles se encontró. **Si no hay ningún manifiesto en la ruta, se niega todo a todos, incluidos los administradores.** ### Primer manifiesto del sitio Como todos los servicios necesitan un manifiesto, el primero se crea a mano en el servidor. Por ejemplo, `web//._p_`, que da todo a un administrador y permite a cualquiera listar y ver metadatos: ```json { "admin": [ { "user": "web" } ], "dkl_fso_list": [ { "user": "+" } ], "dkl_fso_getprops": [ { "user": "+" } ] } ``` A partir de ahí, los demás se crean con `set.fso`: ```bash curl -X POST -H "Authorization: Bearer MI_TOKEN" \ -H "Content-Type: application/json;charset=utf-8" \ -d '{ ".": { "privileges": { "read": [ { "role": "clientes" } ], "write": [ { "role": "editores" } ] } } }' \ "https://sitio.ejemplo.com/documentos/set.fso" ``` **No declare `read` en el manifiesto de la raíz** de un sitio que tiene páginas públicas: el `auth.dk` de la plantilla exige sesión en todo recurso cuyo manifiesto (propio o heredado) declare `read`, aunque la condición sea `{"user":"+"}`. Vea [El auth.dk de la plantilla](/es/devkron/2.0/marcos/autenticacion/auth-dk.md#cuidado-con-el-manifiesto-de-la-raíz). ### Protección de la lectura Con la plantilla estándar (`_protected/auth.dk`), `read` también protege la descarga directa de los archivos: si el manifiesto aplicable tiene un `read` explícito, se exige sesión (`401 Debe iniciar sesión`) y el privilegio (`403 No autorizado`). Los manifiestos sin `read` no restringen la lectura. ## Privilegios por operación FSO usa los cuatro privilegios básicos de la [capa de autorización](/es/devkron/2.0/marcos/autenticacion/) (nombres en `@privid_admin`, `@privid_write`, `@privid_read`, `@privid_plus`) y define uno por operación (`@op_id_*`). Un usuario puede hacer una operación si: 1. tiene el privilegio de la operación, o 2. tiene `admin`, o 3. cumple la equivalencia de la tabla (el **mapa de resolución de privilegios**). | Privilegio de operación | Equivalencia (además de `admin`) | Se usa en | |---|---|---| | `dkl_fso_list` | `write` · `read` + `plus` | `lst.fso` | | `dkl_fso_getprops` | `write` · `read` + `plus` | `get.fso` | | `dkl_fso_getprivs` | `write` · `read` + `plus` | `get.fso` (incluir `privileges`) | | `dkl_fso_setprops` | `write` | `set.fso` (`properties`) | | `dkl_fso_setprivs` | `write` + `plus` | `set.fso` (`privileges`) | | `dkl_fso_upload` | `write` | `upl.fso`; crear archivos con `set.fso`; destino de `copy`, `move`, `rename` | | `dkl_fso_overwrite` | `write` | `set.fso` (`text`) | | `dkl_fso_mkdir` | `write` | `do.fso` (`mkdir`); crear carpetas de destino | | `dkl_fso_copy` | `write` | `do.fso` (`copy`) | | `dkl_fso_move` | `write` | `do.fso` (`move`) | | `dkl_fso_rename` | `write` | `do.fso` (`rename`) | | `dkl_fso_delete` | `write` | `do.fso` (`delete`) | | `dkl_fso_danger` | `write` + `plus` | Subir, copiar, mover, renombrar o escribir archivos con extensión de `@dklfso_danger_files_ext` | | `dkl_fso_zip` | `write` · `read` + `plus` | `upl.fso` (campos `.zip*`) | | `dkl_fso_unzip` | `write` + `plus` | Reservado | | `dkl_fso_lock`, `dkl_fso_recover` | `write` | Reservados (sin servicio) | La resolución está en `dklfso.authOp` (en `fso.config.dk`) y se puede personalizar ([Biblioteca](/es/devkron/2.0/marcos/fso/biblioteca.md)). Comprobado con un usuario que solo tiene `write` en `/compartido`: puede subir `.txt` y crear carpetas, pero no subir ni escribir `.dkl` (falta `plus` para `dkl_fso_danger`) ni cambiar el manifiesto (falta `plus` para `dkl_fso_setprivs`).