Cómo configurar Spaxx
Antes de configurar Spaxx, primero debes configurar la conexión Salto Host Interface Protocol (SHIP) en Salto Space y la interfaz JSON en eLoxx Relaxx. Aunque Spaxx utiliza la conexión SHIP, no es necesaria la opción de licencia SHIP completa. La opción de licencia SPACE-OPT-0039 (función Spaxx Connector) no habilita la conectividad SHIP completa para otras aplicaciones. SPACE-OPT-0039 solo habilitará la conexión a los puntos finales utilizados para la sincronización de Space-Relaxx.
Configuración de Space
Configuración de la conexión SHIP
Para configurar la conexión SHIP en Space, ve a Sistema > Opciones generales > SHIP.
Menú de opciones generales de Space
Tendrás que configurar la opción Salto SHIP Server con los ajustes correctos. Consulta la sección sobre SHIP para obtener más información.
Pantalla de configuración de Space SHIP
Spaxx permite utilizar una conexión SHIP segura. Puedes usar Básico (HTTP), protegido por un inicio de sesión de usuario y contraseña para autenticar la conexión, o Personalizado (HTTPS), que utiliza un certificado de servidor para autenticar la comunicación. Al elegir el protocolo de transporte HTTP, en Space necesitarás cambiar el puerto al que se haya seleccionado para gestionar esas comunicaciones.
Spaxx permite utilizar una conexión SHIP segura
Para más información sobre cómo usar conexiones seguras, ponte en contacto con tu equipo de soporte técnico de Salto.
Configuración de identificación de usuario
Spaxx te permite utilizar el UID de la tarjeta o datos específicos almacenados en un sector de terceros de la tarjeta (datos en memoria) para identificar al usuario cuando presente una llave en una taquilla de Gantner.
UID de la credencial
Por defecto, Spaxx utiliza el UID para identificar al usuario que presenta su credencial RFID en la taquilla y luego envía el UID a Relaxx a través del controlador.
La configuración en Space no requiere ningún ajuste específico.
Aunque la configuración en Relaxx tampoco requiere ningún ajuste específico, el controlador o GT7 debe configurarse para leer el UID como se explica en la sección sobre controladores.
Datos en memoria
El modo de identificación de usuario por datos en memoria (In-memory code) requiere tener en la credencial RFID un sector específico (no un sector de Salto) con sus propias Llaves SAM, y un número decimal único para identificar a cada usuario.
Al presentar esta credencial en un grabador o a través de la asignación automática de llaves, los dispositivos de Salto leerán este número de identificación y lo asociarán al usuario en la base de datos de Space, que luego lo compartirá a través de Spaxx con Relaxx.
El uso de esta función requiere una configuración específica en Space.
En Sistema > Opciones generales > Puntos de acceso > se debe seleccionar Tipo de UID de llave para taquillas Gantner.
'Tipo de UID de llave' para taquillas Gantner
En Sistema > Opciones de SAM y emisión, tendrás que configurar un Código en memoria con los valores para leer correctamente el sector donde se almacena el ID del usuario.
'Opciones de SAM y emisión' en Space
Configuración de niveles de acceso de Space
El conector Space-Relaxx se basa en la sincronización de los niveles de acceso de usuarios, huéspedes y visitantes con los derechos de acceso dentro del sistema Relaxx. Por eso, necesitas crear la misma cantidad de niveles de acceso que grupos de autorización tengas en Relaxx para asegurar el mapeo correcto y permitir la creación de usuarios en Space.
Lista de niveles de acceso de usuario en Space
El mismo principio se aplica a los niveles de acceso de huéspedes y visitantes. The Spaxx connector allows the synchronization of guest access levels for guest rooms and visitor access levels, to allow both guests and visitors to use the Gantner GAT NET. Locks.
Relaxx permite que los usuarios, huéspedes o visitantes pertenezcan a un solo grupo de autorización. Por eso, en el plan de acceso de usuario, los usuarios deben tener solo un nivel de acceso relacionado con cada grupo de autorización de Gantner. Si un usuario necesita tener acceso a varios grupos de taquillas, tendrás que crear un grupo de autorización que tenga acceso a varios grupos de taquillas.
Opción de niveles de acceso de usuario de Space para un usuario individual
Configuración de eLoxx Relaxx
Para usar el conector Space-Relaxx, necesitas usar la versión Enterprise de eLoxx Relaxx que permite la integración de la interfaz JSON. Asegúrate de que la licencia de Relaxx que tienes es la correcta para que puedas conectar los diferentes sistemas.
Configuración de la interfaz JSON de Relaxx
Para configurar la interfaz JSON, debes acceder al cliente de escritorio de Relaxx. La interfaz web de Relaxx no permite realizar ninguna configuración. Solo está diseñada para la gestión de taquillas.
Accede a las opciones generales de Relaxx y selecciona las siguientes opciones de JSON:
- Usar tokens de acceso
- Usar codificación de contraseña ASCII
Opciones generales de Relaxx: ajustes de JSON
Configuración de Relaxx
En Relaxx, necesitas crear los grupos de taquillas que se asignarán a los grupos de autorización. Los grupos de autorización son los elementos que se mapearán a través de Space-Relaxx y otorgarán a los usuarios acceso a las taquillas correspondientes.
En la pestaña Autorizaciones > opción Grupos de autorización, puedes crear los diferentes grupos de autorización e incluir los grupos de taquillas a los que tendrán acceso dichos grupos de autorización.
Grupos de autorización de Relaxx
Para facilitar el mapeo, recomendamos utilizar el mismo nombre tanto para los niveles de acceso de Space como para los grupos de autorización de Relaxx.
Ejemplo de grupo de autorización de Relaxx
Relaxx solo permite que los usuarios pertenezcan a un solo grupo de autorización. Si necesitas que algunos usuarios tengan acceso a diferentes grupos de taquillas, recomendamos crear grupos de autorización que incluyan los diferentes grupos de taquillas.
Configuración de los controladores Gantner
To allow the GAT NET. Locks to read Salto SVN Cards, the controllers or the GT7 terminal have to be set up with a specific setting that allows the usage of third party non-coded cards to correctly read the UID of the cards.
Subcontroladores GAT Net
En la configuración avanzada, introduce los siguientes parámetros en Configuración de segmento:
- SubFID=0
- SegID = NOT_USED
- SendToHost = Disabled
- HandleLockerGroupId = 0
- KeySet = 00000000000000000000000000000000000000000000000000000000000000000000
Configuración de segmentos del configurador GAT
GT7 como controlador principal
Valores del soporte de datos en el GT7
El GT7 se puede utilizar como controlador principal. También se necesita una configuración específica para permitir que se usen tarjetas Salto en esta configuración. Asegúrate de que el campo Check certificate esté desmarcado en el tipo de soporte (p. ej., Mifare Classic o Mifare DESFire) que estés utilizando en la instalación.
Campo de certificado de comprobación del soporte de datos
Ajuste de RFID para subcontroladores
Para usar una tarjeta Salto en una subcontroladora gestionada por un GT7, tienes que especificar los valores para que las cerraduras de las taquillas puedan leer tarjetas RFID de Salto. Estos ajustes pueden programarse a través de la interfaz en la nube G7 Connect o accediendo a la interfaz del navegador web del GT7.
Especifica los valores para que las cerraduras de las taquillas puedan leer tarjetas RFID de Salto
Configuración de Spaxx
Para configurar Spaxx, ten en cuenta que previamente debes haber configurado la conexión SHIP en Space y la interfaz JSON en Relaxx.
Inicio de sesión y contraseña predeterminada de Spaxx
Para acceder a la interfaz de usuario de Spaxx, debes introducir un nombre de usuario y una contraseña válidos.
Pantalla de inicio de sesión de Spaxx
El nombre de usuario y la contraseña predeterminados son:
- Nombre de usuario: admin
- Contraseña: SpaceGat
Debes cambiarlos después de iniciar sesión por primera vez.
Asegúrate de que el Space Relaxx SyncAgent esté detenido antes de configurar el conector Spaxx.
Pantalla de configuración
Para permitir que Spaxx se sincronice entre Salto Space y eLoxx Relaxx, accede a la sección Settings y establece la configuración para Space Host Interface Protocol (SHIP), Relaxx REST API y los ajustes para Spaxx SyncAgent.
Pantalla de ajustes de Spaxx
Ajustes de Space
En la pantalla de ajustes de Space en Spaxx, debes añadir los mismos valores que en los ajustes de la conexión SHIP en Space. Estos indican la IP del host SHIP y el puerto para la comunicación.
Ajustes de SHIP en Spaxx y Space
El conector Spaxx te permite comprobar si la conexión con el host SHIP se ha establecido correctamente. Después de introducir los valores y guardar, haz clic en el botón Probar conexión para verificar que la conexión se ha establecido correctamente, como se muestra a continuación.
Prueba de conexión correcta
Spaxx te permite utilizar el UID de la tarjeta o datos específicos almacenados en un sector de terceros de la tarjeta (datos en memoria) para identificar al usuario cuando presente una llave en una taquilla de Gantner. Dependiendo de la opción que quieras usar, asegúrate de que el ajuste de Space esté configurado correctamente.
Tipo de identificador de usuario
Spaxx permite utilizar una conexión SHIP segura. Puedes usar Básico (HTTP), protegido por un inicio de sesión de usuario y contraseña para autenticar la conexión, o Personalizado (HTTPS), que utiliza un certificado de servidor para autenticar la comunicación. Dependiendo de la opción que quieras usar, asegúrate de que el ajuste de Space esté configurado correctamente.
Opciones de conexión SHIP
Resolución de problemas de la prueba de conexión
La conexión puede fallar si la función de licencia de Space correcta SPACE-OPT-0039 no está activada. En este caso, se mostraría un mensaje como el siguiente:
Error de conexión debido a una licencia no compatible
Ajustes de Relaxx
En la sección de ajustes de Relaxx en Spaxx, debes usar los mismos valores que los utilizados en el software Relaxx.
Esto significa incluir la siguiente información:
- Relaxx API Host: IP o nombre del servidor donde está instalado el servicio eLoxx Relaxx.
- Puerto API de Relaxx: 8241 (puerto predeterminado de la interfaz REST de Relaxx)
- Cuenta API de Relaxx: usuario de Relaxx que realizará los cambios. Se recomienda utilizar el usuario predeterminado
system(usuario predeterminado con capacidades de gestión). - Contraseña API de Relaxx: contraseña del usuario que realizará los cambios.
Sección de ajustes de Relaxx en Spaxx
Ajustes de Relaxx
El conector Spaxx te permite comprobar si la conexión con el host SHIP se ha establecido correctamente. Después de introducir los valores y guardar, haz clic en el botón Probar conexión para verificar que la conexión se ha establecido correctamente.
Si la conexión no se establece correctamente, comprueba que el nombre de usuario y la contraseña de la cuenta API de Relaxx sean correctos.
A continuación, accede a la carpeta C:\Program Files (x86)\GAT\GAT Relaxx\ApplicationLogger.log4net y cambia el valor de nivel a "ALL" en la línea <root> <level value “/> y en la línea logger name=”relaxxbasicinterfaceconfiguration”.
Consulta la siguiente captura de pantalla para más detalles:
Ajustes de ApplicationLogger
Si la conexión no se establece, asegúrate de que la autenticación de SQL Server permite inicios de sesión a través del modo de autenticación de SQL Server y Windows, como se muestra en la siguiente captura de pantalla.
Permitir inicios de sesión a través del modo de autenticación de Windows y SQL Server
Ajustes de sincronización
Los ajustes de sincronización permiten personalizar los valores que definirán el rendimiento de la sincronización de usuarios y niveles de acceso entre Space y Relaxx.
Ajustes de sincronización de Spaxx
Sincronización manual
Esta opción te permite ejecutar una sincronización manual e inmediata.
- Haz clic en el botón Sincronización manual.
- Se forzará la sincronización de los usuarios y de los derechos de acceso.
Opción de sincronización manual de Spaxx
Limpiar registros automáticamente
Esta opción permite purgar el registro de los logs generados durante cada sincronización para aquellos logs que tengan una antigüedad superior al número de días especificado.
Dependiendo del número de usuarios y transacciones que tengas en Space, el tamaño del archivo de log puede aumentar, lo que posiblemente requiera más espacio en el disco duro. Podría ser necesaria una purga periódica para optimizar la memoria del disco duro.
Opción de limpieza automática de logs
Puedes configurar Spaxx para que limpie automáticamente los archivos de log tras un periodo de tiempo específico definido en días.
También puedes forzar una limpieza inmediata haciendo clic en el botón Limpieza manual. Los logs más recientes se borrarán en función del periodo de frecuencia definido.
Opción de limpieza manual de logs
Frecuencia de actualización de autorizaciones
Frecuencia de actualización de autorizaciones
Define la frecuencia de la sincronización de usuarios. Valor definido en segundos.
Una frecuencia corta podría requerir más recursos del sistema para instalaciones grandes y podría sobrecargar el sistema, resultando en una degradación del rendimiento. Para instalaciones grandes, recomendamos usar un valor de 1200 segundos.
Frecuencia de actualización de niveles de acceso / grupos
Define la frecuencia con la que se actualiza la creación o eliminación de los niveles de acceso y los grupos de autorización. Se utiliza para fines de configuración.
Valor definido en horas.
Sincronización de permisos de acceso del sistema
Periodo de desactivación
Define la duración durante la cual se desactivarán las autorizaciones de Gantner antes de su eliminación si no se encuentran en Space.
Periodo de desactivación de Relaxx
Esto se utiliza para definir el periodo de tiempo que una tarjeta eliminada en Space mantendrá la autorización activa en Relaxx. Esto significa que si hay que emitir una nueva tarjeta, el usuario podrá seguir manteniendo la taquilla ocupada.
Si un usuario ya ha ocupado o se le ha asignado una taquilla, y se pierde la tarjeta, el periodo de desactivación mantendrá la autorización deshabilitada en Space, pero aún disponible en Relaxx, durante este periodo. Valor definido en minutos.
Si se emite una nueva tarjeta durante este periodo de tiempo, el usuario podrá acceder a su taquilla con la nueva tarjeta.
Si se emite una nueva tarjeta después de este periodo de tiempo, el usuario no podrá abrir su taquilla con la nueva tarjeta. Se requerirá la ayuda del administrador de Relaxx, ya sea abriendo la taquilla de forma remota o con una tarjeta maestra.
Ocultar información personal de los registros
Al habilitar esta opción, los logs generados en el panel de control de Spaxx ocultarán cualquier dato personal del usuario.
Casilla de verificación para ocultar información personal
Datos personales no ocultos
Ejemplo de log cuando la casilla de verificación no está marcada
Datos personales ocultos
Ejemplo de log cuando la casilla de verificación está marcada
Propagar derechos de taquilla
Al habilitar esta opción en taquillas dinámicas, los huéspedes con copias de tarjeta podrán acceder a la misma taquilla (opción Family).
Tan pronto como cualquiera de las copias de los huéspedes acceda a una taquilla, Spaxx asignará la misma taquilla al resto de las copias de la tarjeta del huésped.
Opción de propagar derechos de taquilla
Atrás
Instalación
Opciones de la interfaz