Guía de puesta en marcha del servicio de llaves de cartera para huéspedes de hotel

Descripción general

La puesta en marcha de la solución de llaves de cartera para huéspedes de hotel es un esfuerzo colaborativo entre el proveedor de servicios de llaves de cartera del hotel (es decir, Gestor de credenciales), el socio comercial de Salto y el equipo de Salto.

Esta guía proporciona instrucciones paso a paso para configurar y poner en marcha los componentes específicos de Salto del servicio de llaves de cartera para huéspedes de hotel de Space. La solución permite a los huéspedes del hotel usar llaves de cartera digitales - como Room Keys en Apple Wallet - para acceder a sus habitaciones a través de puntos de acceso de Salto.

Al seguir esta guía, podrás:

• Verificar los requisitos de compatibilidad de hardware y firmware
• Configurar las licencias de Space y los ajustes de software necesarios
• Configurar la conexión de la API de hostelería entre Salto Space y tu sistema
• Configurar las reglas de red y firewall para una conectividad entrante segura
• Conectar Space al WalletHub de Salto (entorno de desarrollo o de producción)
• Configurar las cerraduras y lectores para el aprovisionamiento de llaves de cartera

Esta guía está destinada a socios comerciales de Salto o equipos de Salto que deseen poner en marcha y desplegar la solución de llaves de cartera en una propiedad.

Configuración de la puesta en marcha

Para garantizar una configuración de puesta en marcha exitosa, deben abordarse los siguientes aspectos:

• Cumplimiento de hardware
  • Asegúrate de que las versiones de hardware y firmware sean compatibles.
• Instancia de Space
  • Todos los complementos de licencia requeridos deben estar activos dentro de Space.
    • SPACE-OPT-0041 Llaves de cartera de invitado
    • (Solo para desarrolladores) SPACE-OPT-0030 Servicios web definidos por el usuario - consulta las notas al pie del integrador para más detalles
  • La instancia de Space debe estar configurada correctamente.
  • El servidor de Space debe ser accesible por la instancia de software que llama a la API de hostelería (entrante).
• Configuración de Space
  • Configuración adecuada de los puntos finales tanto de salida como de entrada.
  • Las credenciales de autenticación deben estar correctamente configuradas y gestionadas de forma segura.

Arquitectura de la solución

Arquitectura de la solución

Cumplimiento de hardware

Por favor, contacta con tu representante habitual de Salto para confirmar las versiones de hardware y firmware requeridas para fines de cumplimiento del producto y pruebas.

Configuración paso a paso: activos

Antes de comenzar la configuración en Space, necesitarás lo siguiente:

• TCI: identificador único de 3 bytes (un valor hexadecimal compuesto por 6 caracteres) para la identificación del pase de cartera proporcionado por el proveedor del servicio de llaves de cartera.
• La información del punto final de la API de hostelería del proveedor del servicio de llaves de cartera (dirección IP y puerto) será necesaria para configurar el firewall que protege la propiedad y las reglas del servidor Windows para permitir conexiones entrantes.
• A nivel de propiedad, el cliente final (por ejemplo, el equipo de TI de la propiedad) deberá configurar tanto el firewall de la propiedad como el servidor Windows que aloja Space para permitir conexiones entrantes.
• La dirección IP y el número de puerto de alojamiento de Space deberán compartirse con el proveedor del servicio de llaves de cartera.
• Credenciales de WalletHub deben obtenerse de Salto: serán proporcionadas de forma segura a los proveedores del servicio de llaves de cartera por Salto.

Configuración paso a paso: general

1. El hardware debe ser compatible y el firmware debe actualizarse para garantizar el cumplimiento. Además, el hardware debe estar correctamente configurado con SAM durante la instalación.
2. Instala un NCoder dedicado:
   • Número de firmware: 0172
   • Versión de firmware: v01.15 o superior
3. El software y la infraestructura (instancia de Space, configuración de red, etc.) deben cumplir con los requisitos especificados en la documentación de la API de hostelería.

Configuración de red

Consulta los requisitos de configuración de red en la documentación de la API de hostelería de Space.

Llave electrónica NCoder

Se requiere un NCoder trabajando en modo llave electrónica (dongle) para el aprovisionamiento de llaves de cartera (check-in, etc.).

Consulta la sección sobre cómo añadir editores de tarjetas a la red Salto en Salto Space para obtener más detalles.

Configuración paso a paso: Space

Debes configurar Space de la siguiente manera:

Complementos de licencia de Space

SPACE-OPT-0041

El complemento activa la función necesaria de Llaves de cartera de invitado. Asegúrate de que la función esté activa antes de continuar.

SPACE-OPT-0030

Solo los integradores necesitan este complemento de licencia para fines de prueba, no el cliente final.

Consulta las notas al pie para más detalles.

Opciones generales

Opciones generales > Llaves de cartera

1. Selecciona Sistema > Opciones generales > Llaves de cartera
2. Selecciona el tipo de integración API de hostelería en el menú desplegable.

Opciones generales - generación de llave API

Generación de llave API

1. En el panel API, haz clic en Generar. La Autenticación (llave API) se genera automáticamente. Esta llave de autenticación permite la conexión entre Space y los proveedores de servicios de llaves de cartera.
2. Comparte la llave API con el proveedor del servicio de llaves de cartera: la misma llave de autenticación generada también debe utilizarse en el entorno del proveedor del servicio de llaves de cartera (por ejemplo, Alliants).

Configurador de Space

Configurador de Space

Configura el puerto de la API de hostelería desde la pestaña Avanzado en el Configurador de ProAccess Space. El icono del Configurador de ProAccess Space se encuentra en el escritorio del equipo donde está instalado Space.

Certificados a utilizar:

• a) El cliente puede elegir enviar solicitudes a una IP pública o a su propio dominio, utilizando un certificado TLS emitido por una CA con un nombre común (CN) coincidente, que el integrador verificará.
• b) También se permiten certificados autofirmados.
• c) También puedes usar certificados verificados por CA incluso si las solicitudes se realizan a una IP pública en lugar de a un dominio, pero los integradores no pueden verificar estos certificados.

Consulta también Consideraciones de conectividad para la API de hostelería

Webhook

Configuración de webhook

(Opcional) Selecciona la casilla de verificación Habilitar en el panel WebHook de la pestaña Llaves de cartera en Opciones generales para activarlo. Puedes usar el webhook para recibir notificaciones sobre cambios que afecten a las llaves de cartera emitidas. Sin embargo, ten en cuenta que estas notificaciones siguen un enfoque de mejor esfuerzo y no se garantiza que se entreguen en todos los escenarios.

Deberás proporcionar la siguiente información para recibir notificaciones de webhook:

• URL de Webhook: URL donde quieres recibir las notificaciones.
• Nombre de usuario de Webhook: nombre de usuario para la autenticación básica.
• Contraseña de Webhook: contraseña para la autenticación básica.

WalletHub

WalletHub es el componente de Salto responsable de gestionar las credenciales de llaves de cartera y aprovisionarlas en las cerraduras y lectores.

Configuración de WalletHub

1. En el panel WalletHub, introduce el nombre de usuario y la contraseña. Estos detalles son proporcionados por Salto.
2. Haz clic en Guardar.
3. Haz clic en el botón Probar conexión para verificar que los datos de WalletHub que has introducido son correctos.
4. Una vez verificado, haz clic en Activar. Las llaves de cartera ya están configuradas y listas para su uso.

SAM y emisión

La configuración de SAM y emisión es necesaria para habilitar el aprovisionamiento de llaves de cartera en las cerraduras y lectores.

Configuración de SAM y emisión

• Selecciona Sistema > Opciones de SAM y emisión
• En la lista Llaves activas, marca Cartera
• En Proveedor de credenciales selecciona Salto
• Introduce el valor TCI (un valor hexadecimal compuesto por 6 caracteres). El valor TCI es proporcionado por el proveedor del servicio de llaves de cartera.
• Haz clic en Generar llave para generar la llave que se utilizará para el aprovisionamiento de llaves de cartera.
• Configura los lectores Salto con un PPD (dispositivo de programación portátil)

Consulta la sección completa de opciones de SAM y emisión para llaves de cartera para obtener más detalles.

Recursos adicionales

• Opciones generales de Space para llaves de cartera
• Opciones de SAM y emisión para llaves de cartera
• Consideraciones de conectividad para la API de hostelería
• Documentación de la API de hostelería

Notas al pie

Complemento de licencia SPACE-OPT-0030