Guía de emparejamiento ReservingLock - Control de Accesos
Esta guía te mostrará cómo emparejar y configurar un dispositivo ReservingLock para controlar el acceso a los recursos de tu organización (puertas, cancelas, cerraduras inteligentes, etc.).
Requisitos previos
Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:
✅ Rol de Administrador: Debes tener permisos de Admin o Super Admin en tu organización.
✅ Suscripción PRO activa: La funcionalidad de control de accesos requiere una suscripción PRO.
✅ Bluetooth habilitado: Asegúrate de que el Bluetooth esté activado en tu dispositivo móvil.
✅ Dispositivo ReservingLock: El dispositivo debe estar encendido y en modo emparejamiento (LED parpadeando).
✅ Proximidad física: Debes estar cerca del dispositivo ReservingLock (a menos de 10 metros).
Opción 1: Emparejar desde el Dashboard de Administración
1. Acceder al modo Admin
- Abre la aplicación Reserving e inicia sesión con tu cuenta de administrador ().
- En el Dashboard principal, asegúrate de estar en modo Admin (verás un badge con la letra "A" en la esquina superior derecha) ().
- Si no estás en modo Admin, pulsa el botón de cambio de modo (icono de flechas verticales) para activarlo.
2. Acceder al Control de Accesos
- En la sección "Admin Tools" del Dashboard, localiza la tarjeta de "Control de Acceso" (icono de candado abierto en color morado) ().
- Haz clic en la tarjeta para acceder a la gestión de dispositivos de control de accesos ().
3. Iniciar el emparejamiento
- En la página de Control de Accesos, haz clic en el botón "+" (Añadir dispositivo) en la esquina superior derecha ().
- Se abrirá el asistente de emparejamiento con 4 pasos claramente indicados en la parte superior.
Opción 2: Emparejar desde la Gestión de Recursos
1. Acceder a la gestión de recursos
- Desde el Dashboard en modo Admin, haz clic en la tarjeta "Recursos" o "View Resources" en la sección de Admin Tools ().
- Serás redirigido a la página de gestión de recursos de tu organización ().
2. Editar el recurso donde instalarás el dispositivo
- Localiza el recurso al que deseas asociar el ReservingLock que tengas en tu organización (por ejemplo, pista de tenis, piscina, sala, etc).
- Desliza la tarjeta del recurso hacia la derecha para revelar las opciones de edición. ().
- Haz clic en el icono de editar (lápiz) para abrir el modal de edición del recurso.
3. Acceder a la pestaña de Control de Accesos
- En el modal de edición del recurso, verás varias pestañas en la parte superior: General, Reglas, Imágenes y Control de Acceso ().
- Haz clic en la pestaña "Control de Acceso" (icono de candado abierto).
- En la sección de dispositivos, haz clic en el botón "Añadir Dispositivo" ().
Proceso de emparejamiento (4 pasos)
Una vez iniciado el emparejamiento desde cualquiera de las dos opciones anteriores, seguirás estos 4 pasos:
PASO 1: Escanear dispositivos Bluetooth
- En la primera pantalla del asistente verás el Paso 1: Escanear ().
- Haz clic en el botón "Iniciar escaneo" o "Start Scan".
- La aplicación comenzará a buscar dispositivos ReservingLock cercanos (verás un spinner girando mientras escanea).
- Tras unos segundos, aparecerá una lista con los dispositivos encontrados, mostrando:
- Nombre del dispositivo (ej: "ReservingLock-A7B3")
- ID del dispositivo (los primeros 8 caracteres)
- Señal (RSSI): Indicador de la calidad de la señal (verde = excelente, amarillo = bueno, naranja = aceptable, rojo = débil)
- Selecciona el dispositivo que deseas emparejar haciendo clic en su tarjeta. Aparecerá una marca de verificación verde ().
- Haz clic en el botón "Siguiente" para continuar al Paso 2.
💡 Consejo: Si no ves tu dispositivo, asegúrate de que esté encendido y en modo emparejamiento (LED parpadeando). Puedes pulsar "Iniciar escaneo" de nuevo para buscar otra vez.
PASO 2: Conectar con el dispositivo
- En la segunda pantalla verás el Paso 2: Conectar con la información del dispositivo seleccionado ().
- Haz clic en el botón "Conectar" para establecer la conexión Bluetooth.
- La aplicación mostrará "Conectando..." con un spinner. Esto puede tardar unos segundos.
- Una vez conectado, verás un badge verde que dice "Conectado" ().
- Opcionalmente, puedes hacer clic en "Obtener información del dispositivo" para ver detalles técnicos como:
- Versión de firmware
- Nivel de batería
- Número de serie
- Estado de hardware
- Cuando veas el estado "Conectado", haz clic en "Siguiente" para continuar al Paso 3.
⚠️ Importante: No cierres la aplicación ni te alejes del dispositivo durante el proceso de conexión.
PASO 3: Configurar el dispositivo
En la tercera pantalla verás el Paso 3: Configurar con varios campos que debes completar ().
Información básica:
Nombre del dispositivo (obligatorio):
- Introduce un nombre descriptivo (máximo 19 caracteres).
- Ejemplo: "Puerta Principal", "Cancela Parking", "Cerradura Sala A".
- Este nombre aparecerá en las notificaciones y logs de acceso.
Descripción (opcional):
- Añade más detalles sobre el dispositivo.
- Ejemplo: "Cerradura electrónica de la puerta principal del edificio".
Ubicación (opcional):
- Indica dónde está instalado físicamente.
- Ejemplo: "Planta baja, entrada principal".
Configuración Bluetooth avanzada (opcional):
Si necesitas ajustar parámetros técnicos avanzados, activa el toggle "Activar configuración Bluetooth avanzada":
Potencia de transmisión Bluetooth:
- Ajusta el alcance de la señal Bluetooth (valores típicos: -12dBm a +4dBm).
- Mayor potencia = mayor alcance pero mayor consumo de batería.
Intervalo de anuncio Bluetooth:
- Frecuencia con la que el dispositivo anuncia su presencia (en milisegundos).
- Valores típicos: 100ms - 1000ms.
💡 Consejo: Si no estás seguro, deja estos valores por defecto.
Configuración de política de acceso:
Esta sección te permite definir quién puede abrir el dispositivo y cuándo. Verás un formulario con las siguientes opciones ():
Modo de política de acceso:
- Público: Cualquier persona puede activar el dispositivo (no recomendado).
- Solo reservas: Solo usuarios con reserva activa pueden abrir.
- Lista blanca (Whitelist): Solo usuarios específicamente autorizados pueden abrir.
Ventana de tiempo (si seleccionaste "Solo reservas"):
- Minutos antes de la reserva: Tiempo de anticipación para abrir (ej: 15 minutos).
- Minutos después del inicio: Tiempo de gracia tras finalizar la reserva (ej: 5 minutos).
Gestión de lista blanca (si seleccionaste "Whitelist"):
- Añade usuarios específicos que siempre tendrán acceso.
- Busca por nombre o email y selecciónalos de la lista.
Configuración del relé:
- GPIO del relé: Pin de salida que activa la cerradura (típicamente GPIO 4).
- Duración de activación: Cuánto tiempo permanece activo el relé (típicamente 3000ms = 3 segundos).
🔐 Recomendación de seguridad: Para la mayoría de casos, usa el modo "Solo reservas" con una ventana de 15 minutos antes y 5 minutos después.
PASO 4: Completar el emparejamiento
- En la cuarta pantalla verás el Paso 4: Completar con un resumen de toda la configuración ().
- Revisa cuidadosamente todos los datos:
- Nombre del dispositivo
- Descripción y ubicación
- Política de acceso seleccionada
- Configuración Bluetooth (si se modificó)
- Si todo es correcto, haz clic en el botón "Completar configuración" ().
- La aplicación realizará los siguientes pasos automáticamente:
- Intercambio de claves ECDH: Establece un canal de comunicación cifrado.
- Envío de configuración: Transmite todos los ajustes al dispositivo de forma segura.
- Registro en el backend: Guarda las credenciales y asociación con el recurso.
- Verificación: Confirma que el dispositivo recibió y aplicó la configuración.
- Verás un mensaje de "Completando configuración..." con un spinner.
- Al finalizar con éxito, aparecerá un mensaje de confirmación: "Dispositivo emparejado correctamente".
- Serás redirigido automáticamente a la página de gestión de recursos o control de accesos, donde verás el nuevo dispositivo listado.
✅ ¡Listo! Tu dispositivo ReservingLock ya está emparejado y listo para usar.
Verificar que el dispositivo funciona correctamente
Desde la lista de dispositivos:
- Ve a Control de Accesos desde el Dashboard Admin ().
- Localiza el dispositivo que acabas de emparejar en la lista.
- Verás su estado:
- Badge verde "Activo": El dispositivo está operativo y conectado.
- Badge gris "Inactivo": El dispositivo está deshabilitado temporalmente.
- Puedes ver:
- Nombre del dispositivo
- Identificador Bluetooth
- Política de acceso configurada
- Número de usuarios en la lista blanca (si aplica)
- Recursos asociados
Probar el acceso:
- Si tienes una reserva activa (en modo "Solo reservas"), abre la app en tu móvil.
- Ve a tus próximas reservas en el Dashboard ().
- Si la reserva está activa y tienes el ReservingLock cerca, verás un botón "Abrir puerta" en la tarjeta de la reserva.
- Pulsa el botón para activar el relé y verificar que funciona.
💡 Nota: El botón de "Abrir puerta" solo aparece si:
- La reserva está confirmada
- Estás dentro de la ventana de tiempo configurada (15 min antes - 5 min después)
- Estás cerca del dispositivo (señal Bluetooth detectada)
Gestionar dispositivos emparejados
Editar un dispositivo:
- Ve a la lista de dispositivos en Control de Accesos ().
- Haz clic en el icono de editar (lápiz) junto al dispositivo.
- Se abrirá un modal donde podrás modificar:
- Nombre, descripción y ubicación
- Política de acceso
- Lista blanca de usuarios
- Estado (activar/desactivar)
- Guarda los cambios haciendo clic en "Guardar".
Eliminar un dispositivo:
- Localiza el dispositivo en la lista.
- Haz clic en el icono de eliminar (papelera) de color rojo.
- Confirma la eliminación en el diálogo que aparece.
- El dispositivo será desvinculado del sistema y deberás volver a emparejarlo si deseas usarlo de nuevo.
⚠️ Advertencia: Eliminar un dispositivo es una acción irreversible. Los usuarios con reservas activas perderán el acceso inmediatamente.
Solución de problemas comunes
El dispositivo no aparece en el escaneo:
- ✅ Verifica que el ReservingLock esté encendido (LED encendido).
- ✅ Asegúrate de que esté en modo emparejamiento (LED parpadeando rápidamente).
- ✅ Comprueba que el Bluetooth de tu móvil esté activado.
- ✅ Acércate más al dispositivo (menos de 5 metros para el escaneo inicial).
- ✅ Si el dispositivo ya está emparejado con otro teléfono, desconéctalo primero.
- ✅ Reinicia el dispositivo ReservingLock apagándolo y encendiéndolo de nuevo.
Error al conectar:
- ✅ Verifica que el dispositivo seleccionado sea el correcto.
- ✅ Asegúrate de no haberte alejado del dispositivo durante la conexión.
- ✅ Si falla la conexión, pulsa "Anterior" y vuelve a intentar el escaneo.
- ✅ Cierra otras apps que usen Bluetooth para evitar conflictos.
El nombre del dispositivo es demasiado largo:
- ✅ El nombre debe tener máximo 19 caracteres UTF-8.
- ✅ Si aparece el error "Nombre demasiado largo", acórtalo.
- ✅ Evita emojis y caracteres especiales que ocupan más bytes.
Error de seguridad al enviar la configuración:
- ✅ Este error puede ocurrir si hay interferencias Bluetooth.
- ✅ Aléjate de otros dispositivos Bluetooth cercanos.
- ✅ Asegúrate de tener buena señal (RSSI > -70 dBm).
- ✅ Reinicia el proceso de emparejamiento desde el inicio.
El botón "Abrir puerta" no aparece en mis reservas:
- ✅ Verifica que tu reserva esté confirmada (no pendiente).
- ✅ Comprueba que estés dentro de la ventana de tiempo configurada.
- ✅ Asegúrate de estar físicamente cerca del dispositivo.
- ✅ Revisa que el dispositivo esté activo (badge verde).
- ✅ Si la política es "Whitelist", confirma que tu usuario está en la lista.
Mejores prácticas de seguridad
🔒 Política de acceso recomendada:
- Usa "Solo reservas" para recursos con horarios definidos.
- Usa "Whitelist" para accesos permanentes (administradores, personal de mantenimiento).
- Nunca uses modo "Público" en producción.
🔋 Mantenimiento del dispositivo:
- Revisa el nivel de batería semanalmente.
- Reemplaza las baterías cuando el nivel sea inferior al 20%.
- Realiza pruebas periódicas de apertura para verificar el funcionamiento.
📊 Monitorización:
- Revisa los logs de acceso regularmente para detectar patrones inusuales.
- Configura notificaciones para intentos de acceso fallidos.
- Audita la lista blanca mensualmente y elimina usuarios que ya no necesiten acceso.
🔄 Actualizaciones:
- Mantén el firmware del ReservingLock actualizado.
- Revisa las notas de actualización para nuevas funcionalidades de seguridad.
- Realiza las actualizaciones durante horarios de baja actividad.
Preguntas frecuentes
P: ¿Puedo asociar un mismo ReservingLock a varios recursos?
R: No, cada dispositivo debe estar asociado a un único recurso físico (puerta, cancela, etc.). Si necesitas controlar múltiples accesos, deberás emparejar un dispositivo para cada uno.
P: ¿Qué pasa si pierdo el teléfono donde emparejé el dispositivo?
R: No hay problema. La configuración se guarda en el backend y cualquier administrador puede gestionar el dispositivo desde otro teléfono. Los usuarios también pueden abrir el dispositivo desde sus propios teléfonos si tienen reserva activa.
P: ¿Puedo cambiar la política de acceso después del emparejamiento?
R: Sí, puedes editar el dispositivo en cualquier momento y cambiar la política. Los cambios se aplican inmediatamente.
P: ¿Cuántos dispositivos puedo emparejar?
R: No hay límite técnico, pero tu suscripción PRO puede tener límites según el plan contratado. Consulta los detalles de tu plan en la sección de Configuración > Suscripción.
P: ¿El dispositivo ReservingLock necesita conexión a Internet o Wi-Fi?
R: No, el ReservingLock no necesita estar conectado a Internet ni a Wi-Fi. Funciona completamente con Bluetooth Low Energy (BLE) y criptografía de tokens firmados. Solo el móvil del usuario necesita conexión a Internet para:
- Obtener tokens de acceso firmados del servidor
- Sincronizar reservas y permisos
- Subir logs de acceso
Cómo funciona sin Internet:
- 🔐 Verificación local: El lock valida los tokens usando criptografía asimétrica sin consultar al servidor
- 📱 Móvil como puente: La app se conecta al servidor (4G/5G/Wi-Fi), obtiene permisos temporales y los transmite al lock por BLE
- ⏰ Sincronización horaria: El móvil actualiza la hora del lock por BLE periódicamente
- 🔋 Bajo consumo: Al no usar Wi-Fi, las baterías duran mucho más (típicamente 1-2 años)
- 📝 Registro inmediato de eventos: Cuando el usuario abre la puerta, su móvil envía el log de acceso al servidor en tiempo real (no hay almacenamiento local de eventos en el lock)
Ventajas de este diseño:
- ✅ Instalación en 5 minutos (sin necesidad de router o configuración de red)
- ✅ Funciona en lugares sin Wi-Fi o con señal débil
- ✅ Mayor seguridad (menos superficie de ataque, sin exposición a Internet)
- ✅ Menor consumo de batería
- ✅ Actualizaciones de firmware por BLE desde la app
Soporte adicional
Si tienes problemas que no se resuelven con esta guía:
📧 Email: support@reserving.app
Última actualización: 10 de enero de 2025
Versión de la guía: 1.0
Compatible con: Reserving App v1.0+ | ReservingLock firmware v1.2+