Cómo se entra en ResidApp: el acceso y la sesión

Lo esencial

• Quién te da el acceso

  Al personal y a las familias, la Administración de su centro. A la primera Administración de un centro nuevo, Plataforma. «Cómo pedir el acceso», en la pantalla de acceso, lo explica.

• Para entrar

  Tu identificador de acceso y tu contraseña; el personal, además, el código de 6 cifras de su aplicación de autenticación; o, si has registrado una, «Entrar con passkey». La primera vez, la invitación de tu Administración. En el entorno de pruebas, igual, con las cuentas de prueba (por ejemplo, almendros-enfermeria).

• Tu ámbito

  Si tu cuenta tiene más de un perfil o más de un centro, eliges con cuál trabajas. Lo que ves y lo que puedes hacer depende de esa elección.

• 30 minutos y 12 horas

  La sesión se cierra tras 30 minutos sin usarla y, en todo caso, a las 12 horas de entrar. Guarda lo que estés escribiendo antes de dejar la tablet.

• Salir de verdad

  En una tablet compartida, pulsa siempre «Salir». Cerrar el navegador no siempre basta: algunos recuperan la sesión al volver a abrirse.

• Sin sesión

  El Inicio, el Manual, el Flujo de trabajo, esta página y la página sin conexión. Todo lo demás te lleva a la pantalla de acceso.

• La clave de los documentos de CJ

  Solo abre /pendientes-cj, no la aplicación. Para la aplicación, cada persona usa su propia cuenta.

Cómo se pide el acceso

Cada cuenta la da de alta quien responde de esa persona, y nadie más. Se pide fuera de la aplicación (en persona, por teléfono o por el canal de cada centro) y no hay formulario de solicitud: el enlace «Cómo pedir el acceso» de la pantalla de acceso solo lo explica.

Quién da de alta y entrega la invitación

• Las cuentas de prueba tampoco se comparten: CJ y Orlando tienen cada uno su juego, con los mismos perfiles. Desde el 24/10/2026 no hay ninguna forma de entrar sin contraseña ni ninguna clave común.
• El identificador de acceso no se puede cambiar después del alta; el nombre visible, sí. Es único en todo ResidApp: una persona con cuenta en un centro no necesita otro identificador para trabajar en otro, y sigue con su contraseña y su código del móvil (mira «Trabajar en otro centro» más abajo).
• Un perfil más (por ejemplo, Medicina a quien ya es Enfermería) no es una cuenta nueva: Administración se lo concede en la ficha de la cuenta, y la persona elige con cuál trabaja al entrar.

La invitación y la recuperación (incremento I2)

Así recibe cada persona su contraseña (ADR 0007, hecho el 22/10/2026):

1. 1Administración o Plataforma

   Da de alta la cuenta: Administración al personal y a las familias, Plataforma a la primera Administración de un centro nuevo. La cuenta nace sin contraseña.

2. 2Administración o Plataforma

   Entrega una invitación de un solo uso: una hoja con un código QR y su dirección, en mano o en su pantalla. Vale 72 horas; solo se ve al crearla, y crear otra anula la anterior. No hace falta que la persona tenga correo.

3. 3La persona

   Abre la invitación y elige su contraseña; la invitación deja de valer. Si es del personal, ahí mismo prepara el segundo factor (una app de códigos en el móvil, TOTP) y guarda sus 10 códigos de recuperación. Es el único sitio donde se prepara: saber la contraseña de alguien no basta para registrar otro móvil.

   Desde entonces entra con su identificador, su contraseña y el código del móvil.

4. 4Administración

   Si olvida la contraseña o pierde el móvil, la persona lo pide a su Administración, que le entrega una invitación de recuperación. Al usarla elige otra contraseña, prepara de nuevo el segundo factor y se cierran todas sus sesiones: recuperar el acceso nunca deja la cuenta con menos protección. Hasta que la usa, su contraseña de siempre sigue valiendo.

5. 5La persona

   En «Mi cuenta» cambia su contraseña, genera códigos de recuperación nuevos, registra o quita sus passkeys y ve y cierra sus sesiones abiertas. Para cambiar de móvil necesita una invitación de recuperación (paso 4), que además borra sus passkeys.

Las cuentas de Plataforma entran solo con passkey en cuanto tienen una (I4). El segundo factor de las familias está por decidir con CJ.

Qué hace Plataforma o soporte

Plataforma es el perfil de quien opera ResidApp; hoy, el soporte lo da Orlando. Crea centros y ayuda a sus Administraciones, pero no ve residentes ni nada clínico y no da de alta al personal de un centro: eso es siempre de su Administración. Todo lo que hace queda en la auditoría.

• Un centro nuevo quiere empezar

  1. Entra con su cuenta de Plataforma: «Centros» → Nuevo centro.
  2. Escribe el código y el nombre del centro, su primera unidad y su primer administrador (identificador de acceso y nombre). Se crea todo a la vez o nada.
  3. En el centro, Crear invitación de acceso para esa Administración, y entrégale la hoja en privado.

  Desde ahí, la Administración monta el centro y da el resto de accesos.

• Una Administración sin unidades o sin principal

  1. «Centros» → Administraciones y unidades del centro.
  2. Marca o quita la Administración principal, o añade una unidad al ámbito de una Administración.

  Es la forma de recuperar una unidad que se quedó sin nadie que la gestione.

• Alguien del personal no puede entrar

  1. Si ve «Usuario o contraseña incorrectos», comprueba que escribe bien su identificador. Tras 5 fallos seguidos, la cuenta se bloquea 15 minutos.
  2. Si ve un error 429, que espere un minuto: son demasiados intentos seguidos.
  3. Si usaba una passkey y no tiene a mano ese dispositivo, puede entrar con su contraseña y el código del móvil.
  4. Si no es eso, lo resuelve su Administración en «Usuarios»: la cuenta puede estar suspendida o sin ningún perfil vigente. Si ha perdido el móvil, una invitación de recuperación, que además borra sus passkeys.

  Soporte no crea ni reactiva cuentas de personal desde la aplicación.

• Una familia no puede entrar

  1. Remítela a la Administración del centro.
  2. Allí, en la ficha del residente, «Autorización»: tiene que estar Activa y sin caducar, y el familiar tener acceso al Portal Familiar.

• Hay que cortar un acceso ya

  1. Personal: su Administración suspende la cuenta. Deja de valer en la siguiente pantalla que abra.
  2. Familia: su Administración suspende o revoca la autorización. Deja de ver al residente en la siguiente pantalla.
  3. Plataforma: por SQL, quien administra la base de datos.

• Plataforma ha perdido su acceso

  1. Quien administra la base de datos le emite una invitación de recuperación con database/operaciones/invitar_cuenta.sql y se la entrega en privado.
  2. Al usarla elige otra contraseña y prepara de nuevo el código del móvil; se cierran sus sesiones y se borran sus passkeys.

• Un centro sin ninguna Administración que pueda entrar

  La aplicación todavía no permite a Plataforma reactivar una cuenta ni crear otra Administración en un centro que ya existe. Lo resuelve por SQL quien administra la base de datos.

• Una cuenta de Plataforma nueva o que se retira

  Solo por SQL, quien administra la base de datos (ADR 0006). Nunca desde la aplicación. Lo mismo si pierde todas sus passkeys: se borran sus filas de la tabla passkeys y vuelve a entrar con su contraseña y su código del móvil para registrar otra.

Cada vez que abres una pantalla

Las comprobaciones van en este orden y en todas las pantallas, también al guardar. Si una falla, la pantalla no se muestra. La sesión se comprueba contra la base de datos en cada paso: si se cerró en otro sitio, se nota en ese mismo momento.

En el móvil, desliza el diagrama hacia los lados. Una sesión válida está abierta, se ha usado en los últimos 30 minutos, no han pasado 12 horas desde que entraste y la cuenta sigue activa.

Entrar

En «Iniciar sesión» escribes tu usuario y tu contraseña y pulsas «Entrar». Llegas a ella al abrir una pantalla sin sesión, con «Iniciar sesión» en la cabecera o con «Entrar con otra cuenta» en la pantalla de elegir ámbito. Si eres del personal (cualquier perfil salvo el de familiar), después te pide el código de 6 cifras de tu aplicación de autenticación, que preparaste al usar tu invitación. Si no lo llegaste a preparar, la pantalla te pide una invitación nueva.

Si has registrado una passkey, pulsas «Entrar con passkey» sin escribir nada: el dispositivo te pide la huella, la cara o el PIN y entras. Es una entrada completa, sin contraseña ni código del móvil, y solo funciona en la dirección web de ResidApp, así que una página falsa que imite a ResidApp no puede aprovecharla. Una cuenta bloqueada por intentos, suspendida o sin ámbito activo tampoco entra con passkey. Las cuentas de Plataforma entran solo con passkey en cuanto tienen una; sin ninguna, su primer acceso con contraseña y código las lleva a «Mi cuenta» a crear la primera. Cómo se añade una, paso a paso, está en Passkeys.

• Si algo no cuadra, el aviso es siempre «Usuario o contraseña incorrectos.», sin decir qué falla: así no se puede averiguar qué cuentas existen.
• Cinco fallos seguidos (contraseña o código del móvil) bloquean la cuenta 15 minutos, aunque después se escriba bien. Cada fallo, cada bloqueo y cada entrada quedan en el registro de accesos.
• Sin el móvil, «Usa un código de recuperación» deja entrar con uno de los 10 códigos; cada uno vale una vez. Si no te quedan, pide ayuda a tu Administración.
• Entre la contraseña y el código hay 10 minutos; si se pasan, o si entretanto cambia la contraseña de la cuenta, vuelves a empezar. Ese paso intermedio no abre ninguna pantalla.
• Más de 20 accesos fallidos en 15 minutos desde la misma conexión (la de toda una residencia cuenta como una), sea cual sea la cuenta: se rechazan los intentos siguientes con un error (429) hasta que pasa la ventana. Los accesos correctos no cuentan, así que varias personas pueden entrar a la vez. Además hay un techo de 120 peticiones por minuto contra inundaciones.
• «Mi cuenta», en el menú con tu nombre, te deja cambiar tu contraseña (se cierran tus demás sesiones), generar 10 códigos de recuperación nuevos (con tu contraseña y el código del móvil; los anteriores dejan de valer) y ver y cerrar tus sesiones abiertas, con los últimos accesos a tu cuenta. El código del móvil no se cambia ahí: para otro móvil hace falta una invitación de recuperación de tu Administración.
• Passkeys, también en «Mi cuenta» (solo personal): para añadir una hacen falta tu contraseña y el código vigente del móvil, y el dispositivo te pide verificarte. Todo, paso a paso, en Passkeys.
• Entrar con otra cuenta no exige salir antes. La sesión anterior se cierra solo si la nueva entra; si te equivocas, conservas la que tenías.
• Familia: la cuenta de un familiar entra, por ahora, solo con la contraseña (su segundo factor está por decidir con CJ) y va directamente al Portal Familiar, con su propio aspecto y sin nada del personal.
• Si la sesión había terminado al pulsar «Guardar», lo escrito no se guarda: tras entrar de nuevo, la pantalla de acceso te lo avisa y te devuelve a la pantalla del formulario.
• Al entrar o salir se olvida el ámbito elegido y termina cualquier lectura clínica declarada por Dirección Clínica.

Passkeys: qué son, qué necesitas y cómo se usan

Una passkey («llave de acceso») es la forma más cómoda de entrar: no escribes usuario, contraseña ni código del móvil, solo te verificas con la huella, la cara o el PIN del dispositivo. Por dentro son dos claves que crea tu dispositivo: la secreta nunca sale de él y solo se desbloquea con tu huella, tu cara o tu PIN; la pública se la queda ResidApp y no sirve para entrar a nadie. Al entrar, ResidApp le plantea un reto al dispositivo y este lo firma si tú te verificas. Como la passkey solo responde en la dirección web exacta donde se creó, una página falsa que imite a ResidApp no puede aprovecharla.

Qué necesitas

• Un dispositivo que pueda verificarte con huella, cara o PIN: un ordenador con Windows Hello (PIN o huella) o un móvil con el bloqueo de pantalla activado. Mejor Chrome o Edge; un navegador antiguo avisa de que no admite passkeys.
• Una cuenta de personal que ya tenga contraseña y código del móvil: para añadir la passkey, la app te pide ambos. Los familiares no usan passkeys, por ahora.
• Que las passkeys estén activadas en el entorno. En el de pruebas lo están, ligadas a app-residapp-dev.azurewebsites.net.

Con qué cuenta empezar

Con una cuenta que no sea de Plataforma, por ejemplo la de Administración de tu centro. En una cuenta normal la passkey es un camino extra: la contraseña y el código del móvil siguen valiendo, así que equivocarse no deja a nadie fuera. En una cuenta de Plataforma, en cambio, en cuanto hay una passkey la contraseña deja de servir para entrar y la última no se puede quitar: si se pierde el único dispositivo, solo quien administra la base de datos puede borrar la fila y volver a empezar. Por eso, en Plataforma, registra siempre dos passkeys en dos dispositivos distintos.

Paso a paso para añadir una

1. 1Tú

   Entra con tu contraseña y tu código del móvil, y abre «Mi cuenta» en el menú con tu nombre (arriba a la derecha).

2. 2Tú

   Baja hasta la ficha «Passkeys» (la de la banda naranja). Si no tienes ninguna, dice «No tienes ninguna passkey».

3. 3Tú

   Rellena el formulario: un nombre que la reconozca («Windows de Orlando», «Móvil de trabajo»), tu contraseña y el código que da ahora tu móvil. Pulsa «Añadir una passkey».

4. 4Tu dispositivo

   Se abre una ventana del sistema, no de ResidApp, que te pide el PIN, la huella o la cara. Si ofrece dónde guardarla, elige Windows Hello o «este dispositivo». «Móvil o tableta» muestra un QR para guardarla en el móvil: también vale, pero es más fácil empezar con el propio equipo. ResidApp nunca ve tu PIN ni tu huella.

5. 5ResidApp

   Te lo confirma en una ventana de aviso («Passkey … añadida») que se cierra con «Entendido», y la nueva aparece en la lista con su fecha y el botón «Quitar».

Cómo comprobar que funciona

Pulsa «Salir» en el menú. En el inicio de sesión pulsa «Entrar con passkey» sin escribir nada: el dispositivo te pide verificarte y entras directamente. Si no tienes a mano el dispositivo donde la registraste, sigues pudiendo entrar con contraseña y código del móvil (salvo en Plataforma).

Qué conviene saber

• Recuperar el acceso las borra

  Una invitación de recuperación, además de la contraseña y el código del móvil, borra todas tus passkeys: hay que añadirlas de nuevo.

• Hasta 10, y quitar cualquiera

  Cada una con su nombre, para saber cuál es de cada dispositivo. Una cuenta de Plataforma no puede quitar la última.

• Ligadas a la dirección web

  No se pueden mover a otra: si la dirección de ResidApp cambiara, habría que registrarlas de nuevo.

• Pueden copiarse a tus otros dispositivos

  Si tu móvil o tu portátil las sincroniza con tu cuenta de Google o de Apple, «Mi cuenta» lo indica en esa passkey.

Cuánto dura la sesión

Cada pantalla que abres y cada dato que guardas cuentan como uso. Leer una pantalla abierta sin tocar nada no cuenta. Un ejemplo inventado, en la Residencia Los Almendros:

1. 1
   08:00Enfermería

   Entra con almendros-enfermeria, su contraseña y el código del móvil. Se abre su sesión, que durará como mucho hasta las 20:00.

2. 2
   08:00 – 10:10Enfermería

   Trabaja. Cada pantalla que abre aplaza los 30 minutos de inactividad.

3. 3
   10:10 – 10:45Enfermería

   Deja la tablet con el basal de Rosa a medias, sin guardar. A las 10:45 pulsa «Guardar»: han pasado 35 minutos sin uso y la app la lleva a la pantalla de acceso, sin más aviso.

   Lo que no había guardado se pierde. Entra otra vez: es una sesión nueva, que durará como mucho hasta las 22:45.

4. 4
   15:00Auxiliar

   Cambio de turno en la misma tablet. El Auxiliar pulsa «Entrar con otra cuenta» y entra con almendros-auxiliar.

   La sesión de Enfermería se cierra en ese momento: aunque alguien hubiera copiado su cookie, ya no vale.

5. 5
   22:00Auxiliar

   Pulsa «Salir» al acabar. La sesión queda cerrada y la tablet vuelve al Inicio, sin datos de nadie.

Por qué se cierra una sesión

Las cuentas de prueba: Residencia Los Almendros

Es el centro del Flujo de trabajo y de las guías de pruebas de CJ, ya montado, con una cuenta por perfil. Los pasos 1 a 5 de la vida de Rosa están hechos: el centro con sus dos plantas, sus turnos y sus equipos, Rosa dada de alta en Planta 1 · 104 · B y Elena con acceso al portal. Su historia sigue en vivo desde el paso 6, el basal. Hay además otros cinco residentes para las guías (el Manual dice para qué sirve cada uno). Todos son ficticios.

Cada cuenta se da de alta como en un centro real, con su invitación, su contraseña y su código del móvil. Hay dos juegos con los mismos perfiles, para que nadie comparta contraseñas: el de CJ, que es el de abajo, y el de Orlando, con -orlando en el nombre (por ejemplo, almendros-orlando-enfermeria).

• Administración

  almendros-administracion

  Administración principal de las dos plantas: residentes, familias, usuarios, estructura, turnos, citas y auditoría.

  No ve nada clínico.

• Dirección Clínica

  almendros-direccion

  Las dos plantas. Puede leer lo clínico declarando para qué (queda auditado), fijar los rangos de referencia y los plazos de los hitos.

  La lectura declarada termina al salir o al entrar con otra cuenta.

• Medicina

  almendros-medicina

  Las dos plantas, con permiso para firmar y reevaluar el basal.

• Enfermería

  almendros-enfermeria

  Las dos plantas, con permiso de basal, y en el equipo de Enfermería de cada planta. Empieza por firmar el basal de Rosa.

• Auxiliar

  almendros-auxiliar

  Solo Planta 1. Tiene a cinco residentes en «Mis residentes», entre ellos Rosa.

  No ve la Planta 2.

• Familia

  almendros-elena

  Elena, hija de Rosa y su contacto prioritario, con la autorización activa. Entra directamente en el Portal Familiar.

• Plataforma

  plataforma-cj

  No es del centro: es global. Da de alta centros nuevos y atiende a sus Administraciones.

  Nunca ve residentes.

• Es un centro compartido. Lo que hagas en él se queda, y lo ve cualquiera que entre con esas cuentas. No se puede reiniciar, porque la auditoría no se borra.
• Un segundo centro, la «Residencia Los Olmos (ficticia)» (olmos-administracion y olmos-enfermeria), sirve para comprobar que cada centro solo ve lo suyo.
• Para ver la elección de ámbito, entra con varios-centros, que tiene perfiles en los dos centros. El resto está en el Manual.
• Las mismas cuentas existen en local y en el entorno publicado, cada una con sus propias credenciales en cada sitio.

Qué protege y qué no

• Nadie se hace pasar por otro

  La sesión viaja en una cookie que el servidor cifra y firma. La cookie antigua, con el usuario escrito tal cual, ya no da acceso: era el fallo más grave del entorno publicado y está cerrado.

• Se puede revocar

  Cada sesión es una fila en la base de datos y se comprueba en cada pantalla. Al salir, una copia de la cookie deja de valer al instante.

• Ante la duda, fuera

  Inactividad, caducidad o cuenta suspendida llevan a la pantalla de acceso. Seguir usando la sesión nunca alarga las 12 horas.

• Solo por HTTPS

  Una dirección http:// pasa a https:// y el navegador recuerda no volver a usar http. Las cookies solo viajan cifradas y las páginas no pueden leerlas.

• Una sola forma de entrar

  El acceso de desarrollo (entrar escribiendo solo el nombre de una cuenta) se retiró el 24/10/2026, también del entorno de pruebas. Las pruebas automáticas usan una entrada que solo existe dentro de ellas y nunca se publica.

• Nada queda abierto por descuido

  Toda pantalla exige sesión salvo una lista cerrada. Una prueba automática recorre las más de 150 acciones de la aplicación y falla si alguna queda abierta sin querer.

• Contraseña y segundo factor

  La contraseña se guarda como un resumen que no se puede revertir; el personal necesita además el código de su móvil, o entra con una passkey: la clave que te desbloquea y prueba que eres tú no sale nunca de tu dispositivo, y ResidApp guarda solo la que sirve para comprobarla, que por sí sola no permite entrar. Cinco fallos bloquean la cuenta y todo queda en un registro de accesos separado de la auditoría clínica.

• Lo que todavía no protege

  La pulsera con PIN para las tablets compartidas (I5) aún no existe, y falta la validación del responsable de protección de datos (DPO) de la residencia piloto. Hasta entonces solo se usan datos ficticios.

Trabajar en otro centro con la misma cuenta

Quien ya tiene cuenta en un centro y empieza a trabajar también en otro no necesita otra cuenta. Se hace en tres pasos, sin que la Administración del segundo centro llegue a conocer la cuenta de la persona hasta que ella misma la acepta:

1. La Administración del centro nuevo prepara una hoja con el perfil (de personal) y las unidades, sin decir a quién, y se la entrega en mano. Lleva un código y un QR, vale 72 horas y se usa una sola vez.
2. La persona la acepta en «Mi cuenta», ya con su contraseña y su código del móvil: ve el centro, el perfil y las unidades que se le ofrecen y acepta. El segundo factor es lo que demuestra que es quien dice ser; por eso es solo para el personal. Aceptar no concede nada.
3. La Administración confirma. Ve el nombre y el usuario de quien aceptó y, si es la persona que tenía delante, confirma: entonces se crea el perfil con sus unidades. Si no la reconoce, rechaza y no se concede nada.

Después, al entrar, la persona elige con qué centro trabaja, y cada centro solo ve lo suyo. Como la cuenta es de la persona y no de un centro, ninguna Administración puede suspenderla, cambiarle el nombre ni entregarle una invitación: lo hace la plataforma («Cuentas de varios centros»). Cada Administración puede retirar su propio perfil, y eso no suspende la cuenta. Todo queda en la auditoría del centro y en el registro de accesos de la persona.

Lo que falta: el acceso definitivo

ResidApp tendrá su propio inicio de sesión (con ASP.NET Core Identity, el sistema de cuentas que trae la propia plataforma de la aplicación), con los datos de acceso en la misma base de datos de la UE que el resto. Se hace por partes; las cinco primeras (hasta las passkeys) y la vinculación de cuentas entre centros ya están hechas (ADR 0007), y el acceso de desarrollo se retiró el 24/10/2026.

• I0 · Sesión seguraSesión cifrada y revocable, todo con sesión, HTTPS. Hecho el 21/10/2026.
• I1 · ContraseñaContraseña y segundo factor con app de códigos (TOTP), bloqueo por intentos y registro de accesos. Hecho el 22/10/2026.
• I2 · InvitacionesAlta con un enlace o QR de un solo uso que entrega Administración, que también recupera el acceso. Hecho el 22/10/2026.
• I3 · Mi cuentaCambiar la contraseña, generar códigos de recuperación nuevos y ver y cerrar tus sesiones. Hecho el 22/10/2026.
• I2b · Otro centroLa misma cuenta en dos centros: la Administración da una hoja, la persona la acepta con su segundo factor y la Administración confirma. Hecho el 23/10/2026.
• I4 · PasskeysEntrar con la huella, la cara o el PIN del móvil o una llave, sin contraseña ni código. Obligatorias para Plataforma. Hecho el 23/10/2026.
• I5 · PulseraPulsera NFC con PIN para entrar rápido en la tablet compartida.

Para quien mantiene la aplicación

Dónde vive cada pieza. El detalle y las fuentes de la decisión están en docs/decisiones-arquitectura/0007-proveedor-identidad.md.