# Conexión a la base de datos y sesión ## Los tres modos, en cascada CRUD-L tiene tres formas de conectarse. **No se eligen por configuración**: en cada petición se prueban en orden y se usa la primera posible. 1. **Conexión del proveedor de identidad.** Si `@http_context/session/idp/database` tiene una conexión abierta (la deja, por ejemplo, el IdP de base de datos `idp/dbidp.dk`), se usa tal cual: el usuario ya está autenticado y la conexión es suya. 2. **Suplantación de identidad.** Si no hay conexión del IdP, pero hay sesión (`session/user/ids`) **y** llegó el parámetro `ws` en la URL, se verifica que el usuario cumpla `@crudl.access_privilege` y se abre una conexión con su identidad. 3. **Conexión constante.** Si nada de lo anterior aplica, se inicia sesión con `@crudl.qname`, `@crudl.user` y `@crudl.pwd`. La cascada **degrada en silencio**: sin capa de autorización, o con un token inválido o ausente, la petición no se rechaza; se atiende con la conexión constante. Si su aplicación exige sesión, hágalo cumplir en `auth.dk` o en el punto de entrada, no espere que CRUD-L lo haga. Si no quiere conexión constante, deje `@crudl.user` y `@crudl.pwd` vacíos: sin sesión, la petición fallará al iniciar sesión. Comprobado con 2.0 sobre la entidad `pais` (con una contraseña constante incorrecta, para ver qué modo responde): | Petición | Modo | Resultado | |---|---|---| | Sin token | 3 (constante) | 500, `Error en 'dbr.login. (Error de inicio de sesión...` | | Con token y el IdP de base de datos | 1 (IdP) | 200, la lista | | Con token, IdP sin conexión y `?ws=tienda-ws` (espacio del usuario) | 2 (suplantación) | 200, la lista | | Igual, con `?ws=otro` | 2 | 500, `Usuario no autorizado.` | ## Nombre cualificado de la conexión Identifica una conexión del administrador de conexiones (`connections.xml`) con la forma `conexión@aplicación`. Si se omite la conexión, se usa la predeterminada de la aplicación: ```text principal@tienda @tienda conexiones@miempresa/conexion1587@sistema_empresa ``` Vea [Conexiones a bases de datos](/es/devkron/2.0/instalacion/conexiones.md) y la [Biblioteca dbr](/es/devkron/2.0/bibliotecas/motor/dbr/). ### Cómo se determina El controlador compone el nombre con los parámetros de la URL: `{_connection}@{_app_group}`. Si queda vacío o solo `@`, usa `@crudl.qname`. Esto permite dos estilos: ```dkl @crudl.qname = "principal@tienda" // fija, en el punto de entrada ``` ```text /tienda/entry-point.dkl?_app_group=tienda&_connection=principal&_entities_type=cliente ``` o una regla de `routes.map` que capture ambos valores. Con una aplicación que no existe responde `El nombre de la aplicación no se encuentra en el repositorio`. **Cuidado al exponer `_app_group` y `_connection` en la URL**: cualquiera podría pedir otra conexión del servidor. Prefiera fijar `@crudl.qname`. ## Modo 1: proveedor de identidad El controlador busca la conexión en `@http_context/session/idp/database`. Si no es nula, la usa sin más comprobaciones y no abre ninguna otra. Es el modo preferente cuando el IdP ya administra la conexión, porque cada operación corre con la identidad del usuario. La misma conexión se puede obtener desde cualquier programa o vista con `crudl.database()` (devuelve nulo si no hay). ## Modo 2: suplantación de identidad Se activa si hay **a la vez** un identificador de sesión en `session/user/ids` y el parámetro `ws` en la URL. ### Verificación de acceso Antes de conectar se comprueba, con `auth.checkPrivs`, que el usuario cumpla el manifiesto de `@crudl.access_privilege`. El de la plantilla exige que el usuario pertenezca al espacio de trabajo `ws`: ```dkl @crudl.access_privilege = '{"access":[{"workspace":"' + @ws + '"}]}' ``` Si no lo cumple, la operación se detiene con `Usuario no autorizado.` Puede usar un manifiesto más estricto (roles, equipos). El formato de los manifiestos está en [webauth.dkl](/es/devkron/2.0/marcos/autenticacion/webauth.md#authcheckprivs-qué-privilegios-tiene-el-usuario). ### Cómo se conecta Superada la verificación, `dbr.alter_id`: 1. Busca en `tuser` un usuario con `userid` igual al `uid` de la sesión; si no existe, lo crea con una contraseña aleatoria. 2. Busca en `sys_session` una sesión activa con `sys_guid` igual al token; si no existe, la crea para ese usuario. 3. Devuelve una conexión reabierta con ese identificador de sesión. Así, una identidad administrada fuera (por ejemplo, la API de Induxsoft) queda representada por un usuario y una sesión locales, y lo que depende de la sesión en la base funciona normalmente. Comprobado: tras la primera petición de un usuario externo `ext-ana`, la base tiene en `tuser` la fila `ext-ana` y en `sys_session` la sesión con su token. El aprovisionamiento es **automático**: todo usuario que cumpla el manifiesto obtiene un usuario local en su primera petición. Ajuste `@crudl.access_privilege` en consecuencia. Esta parte es específica de MySQL y vive en `crudl/mysql.dbr.dkh`. ## Modo 3: conexión constante Se inicia sesión con `@crudl.qname` (o el nombre de la URL), `@crudl.user` y `@crudl.pwd`. No hay usuario de la petición: los permisos son los de esas credenciales, iguales para todos, y un punto final así no distingue quién lo llama. Si necesita distinguirlo, use otro modo o resuelva la autorización antes del punto de entrada. ## Cómo llega el identificador de sesión CRUD-L no busca el token: espera el miembro `session` ya armado. La cadena completa es: 1. `auth.token()` de `webauth.dkl` encuentra el token (parámetros `ids`/`token`, cookie `__induxsoft_token`, campo `session_id`, `Authorization: Bearer`...). Vea [webauth.dkl](/es/devkron/2.0/marcos/autenticacion/webauth.md). 2. El proveedor de identidad (`_protected/idp/default.dk`) valida el token y obtiene al usuario. 3. `auth.dk` agrega `session` a `@http_context`. 4. CRUD-L lee `session/idp/database` y `session/user`. Para un cliente REST lo natural es `Authorization: Bearer`; para un navegador, la cookie. Vea [Autenticación y autorización](/es/devkron/2.0/marcos/autenticacion/). ## Autorización CRUD-L no verifica privilegios por operación, entidad ni campo. La única comprobación del marco es la del modo 2, que condiciona la suplantación, no las operaciones. En consecuencia: - `auth.dk` solo verifica `read` (y solo en archivos con manifiesto; las URL de `routes.map` no son archivos). Un punto final CRUD-L al que llegue un usuario admitirá altas, cambios y bajas salvo que otra capa lo impida. - Los permisos efectivos son los que la base de datos concede a la identidad de la conexión: la del usuario en los modos 1 y 2, la de las credenciales constantes en el 3. Si necesita autorización por operación, impleméntela en el `auth.dk` del sitio, en el `controller.dk` de la entidad o en los propios punteros del modelo, con `auth.checkPrivs`. Por ejemplo, en `controller.dk`, impedir las bajas a quien no tenga sesión: ```dkl if @@(@http_context,"$session/user/ids") == "" { ref @delete = @null } ``` ## Errores típicos | Síntoma | Causa y solución | |---|---| | Responde aunque no se envió token | Es el modo 3: la cascada degrada en silencio. Exija sesión en `auth.dk` o deje vacías las credenciales constantes | | `Usuario no autorizado.` | Modo 2 y el usuario no cumple `@crudl.access_privilege` (no pertenece al espacio `ws`) | | `Error en 'dbr.login...` | Modo 3 con credenciales incorrectas o sin tablas `tuser`/`sys_session` | | `El nombre de la aplicación no se encuentra en el repositorio` | `_app_group` o `@crudl.qname` no existe en `connections.xml` |