# Pestaña de llaves Wallet en las opciones generales de Salto Space > Descubre cómo configurar los ajustes de las llaves Wallet en Salto Space. ## Introducción {#overview} Las llaves Wallet hacen referencia a las llaves digitales que residen en la aplicación Wallet correspondiente de tu teléfono móvil. Al utilizar {{< glossary_term "nfc" >}}NFC{{< /glossary_term >}} para comunicarse con cerraduras electrónicas, la misma tecnología que utilizan los llaveros o tarjetas de proximidad, ofrecen una experiencia de llave digital rápida y fiable en dispositivos Android y Apple. Puedes seleccionar las siguientes opciones en la pestaña **Llaves Wallet**: - **Transact**: selecciona solo cuando te integres con el sistema Transact. - **Hospitality API**: selecciónala al integrar con un **gestor de llaves de Apple Wallet para hotelería** mediante el [protocolo Hospitality API](/space/user-guide/systems-admin/hospitality-api) (solo se admiten llaves de Apple Wallet (iOS)). {{% info-panel %}} La opción **Hospitality API** solo es compatible con llaves de Apple Wallet para habitaciones de huéspedes de hoteles. {{% /info-panel %}} Al configurar estas opciones, Space podrá comunicarse con los entornos de Transact y Hospitality API, por lo que podrán estar sincronizados en todo momento. Consulta [Configuración de los ajustes de las llaves Wallet en Space](/space/user-guide/operator/sam-and-issuing-options/wallet) para obtener más información sobre cómo configurar las opciones de SAM y de emisión de llaves Wallet. Selecciona **Sistema** > **Opciones generales** > **Llaves Wallet** para ver la pestaña. ![Captura de pantalla que muestra algunas de las opciones disponibles en la pestaña 'Llaves Wallet'](images/wallet-keys-tab.png "Captura de pantalla que muestra algunas de las opciones disponibles en la pestaña 'Llaves Wallet'") {{% info-panel %}} Se asume que los operadores que configuran los ajustes de las **Llaves de wallet** están familiarizados con las tecnologías y términos asociados mencionados en esta sección. {{% /info-panel %}} ## Requisitos previos {#prerequisites} Antes de configurar las llaves de cartera, asegúrate de que se cumplan los siguientes requisitos: ### Requisitos de hardware {#hardware-requirements} La funcionalidad de llaves de cartera requiere versiones específicas de hardware y firmware. Consulta con tu contacto habitual de Salto para conocer el hardware con el que funciona esta funcionalidad y verificar que tu instalación cumple con los requisitos necesarios. Además, debes tener instalado al menos un {{< glossary_term "encoder" >}}NCoder{{< /glossary_term >}} que funcione en modo de llave electrónica para el suministro de llaves de cartera. Se recomiendan varios adaptadores NCoder en entornos con un tráfico intenso de emisión de credenciales. Consulta [Cómo añadir editores de tarjetas a la red Salto](/space/user-guide/operator/salto-network/encoders) para obtener más información. ### Requisitos de licencia {#licensing-requirements} La funcionalidad de llaves de cartera requiere un complemento de licencia independiente. {{% info-panel %}} Ten en cuenta que las funcionalidades de Hotel y Hospitality API dependen de la licencia. {{% /info-panel %}} ### Configuración de red {#network-configuration} Para las integraciones de Hospitality API, el cortafuegos de tu red debe estar configurado para permitir conexiones entrantes al punto de conexión de Space Hospitality API. Consulta [Consideraciones de conectividad para la Hospitality API](/space/user-guide/systems-admin/hospitality-api) para obtener información detallada sobre los requisitos de red. ## Transact {#transact} Transact se comunica con Azure Event Grid para sincronizar eventos de Space y Transact, tales como eventos en la nube, creación de usuarios y Llaves, etc. Consulta [Servidor Space](/space/user-guide/systems-admin/system-requirements#space-server) y [Esquema de conectividad para Space](/space/user-guide/systems-admin/system-requirements#connectivity-scheme-for-space) para más información. ![Opciones de Transact en Space](images/transact.png "Los detalles de la 'Cadena de conexión' los proporciona Transact") {.border} Para configurar los ajustes de **Transact**, haz lo siguiente: 1. Selecciona **Sistema** > **Opciones generales** > **Llaves de monedero**. 2. Selecciona el tipo de integración **Transact** de la lista desplegable. 3. En el panel **Configuración de Transact**, haz clic en el botón de edición con forma de lápiz. Se muestra el cuadro de diálogo **Configuración de cadena de conexión**. ![Configuración de cadena de conexión](images/connection-string-config.png "Cuadro de diálogo de configuración de cadena de conexión") {.border} 4. Rellena todos los campos del cuadro de diálogo **Configuración de cadena de conexión**. Estos datos los proporciona Transact. Una vez introducidos todos estos detalles, se genera automáticamente una cadena de conexión. 5. Haz clic en **OK**. 6. Haz clic en **Guardar**. La integración con Transact ya está configurada. ## Hospitality API {#hospitality-api-salto} La opción **Hospitality API** solo se utiliza en instalaciones hoteleras de Space. Consulta [Hoteles](/space/user-guide/operator/hotel) para más información sobre las funciones de hotel en Space. En este contexto, el **gestor de llaves de wallet de Hospitality** es el software que se conecta a Space a través de la API de Hospitality para gestionar el ciclo de vida de la llave de wallet del guest. {{% info-panel %}} Ten en cuenta que las funcionalidades de Hotel y Hospitality API dependen de la licencia. Para más información, consulta [Cómo registrarse y obtener la licencia de Space](/space/user-guide/systems-admin/register#registering-and-licensing-space) o ponte en contacto con tu representante de Salto. {{% /info-panel %}} ![Ajustes de integración de la API de Hospitality](images/hospitality-wallet.png "Ajustes de integración de la API de Hospitality") {.border} Para configurar los ajustes de la **Hospitality API**, sigue estos pasos: 1. Selecciona **Sistema** > **Opciones generales** > **Llaves de monedero**. 2. Selecciona el tipo de integración **Hospitality API** en la lista desplegable. ### Configuración de la API {#api-configuration} 3. En el panel **API**, haz clic en **Generar**. La **Autenticación (clave de API)** se genera automáticamente. Esta llave de autenticación permite la conexión entre Space y el **gestor de llaves de wallet de Hospitality**. Debes compartir esta llave con el **gestor de llaves de wallet de Hospitality**. 4. Configura el puerto de la **Hospitality API** desde la pestaña **Avanzado** en el **ProAccess Space Configurator**. Puedes encontrarla en el mismo [cliente Space](/space/user-guide/operator/getting-started/system-overview#network-component-icons) en el que se ha instalado Space. 5. Configura el certificado TLS para el punto de conexión de la Hospitality API. La comunicación con la API de Hospitality se basa en Transport Layer Security (TLS), lo que significa que se requiere un certificado. Puedes usar: - Un certificado TLS emitido por una CA con un CN coincidente para dominios personalizados (el administrador de credenciales lo verificará) - Un certificado autofirmado - Un certificado verificado por una CA para IPs públicas (nota: los administradores de credenciales no pueden verificar estos certificados) Consulta la sección sobre [consideraciones de conectividad para la API de Hospitality](/space/user-guide/systems-admin/hospitality-api) para obtener más detalles sobre esta configuración. ![Configura el puerto de la 'Hospitality API' desde el ProAccess Space Configurator](images/wallet-keys-api-port-config.png "Configura el puerto de la 'Hospitality API' desde el ProAccess Space Configurator") {.border} A partir de Space 6.14, la pestaña **Advanced** en el **ProAccess Space Configurator** incluye un botón **Verify** para la Hospitality API. Haz clic en **Verify** para enviar una solicitud HTTP a `localhost` en el puerto de API configurado y confirmar que la API está ejecutándose y respondiendo correctamente. ### Configuración de WebHook (opcional) {#webhook-configuration} 6. (Opcional) Selecciona la casilla de verificación **Habilitar** en el panel **WebHook** de la pestaña **Llaves de wallet** en **Opciones generales** para activarlo. 7. Completa los campos **URL de WebHook**, **Nombre de usuario** y **Contraseña**. Estos datos los proporciona tu **administrador de llaves de cartera de Hospitality**. 8. Haz clic en **Guardar**. 9. Haz clic en el botón **Probar conexión** para verificar que los datos del WebHook que has introducido son correctos. Puedes utilizar el webhook para enviar notificaciones a los administradores de llaves de cartera de Hospitality que implementen esta opción sobre cambios que afecten a las llaves de cartera emitidas. Sin embargo, ten en cuenta que estas notificaciones siguen un enfoque de máximo esfuerzo; no hay garantía de que funcionen de forma fiable en todos los escenarios. ### Configuración de WalletHub {#wallethub-configuration} 10. En el panel **WalletHub**, introduce el nombre de usuario y la contraseña. Estos detalles los proporciona Salto. Ponte en contacto con tu socio de Salto o con tu contacto habitual de soporte técnico de Salto para obtener estas credenciales. {{% info-panel %}} Si aún no tienes credenciales de WalletHub válidas, puedes introducir temporalmente valores de marcador de posición (por ejemplo, "Test" y "test1234") para habilitar el botón **Guardar** y continuar con la configuración. Sustitúyelos por credenciales válidas antes de activar la integración. {{% /info-panel %}} 11. Haz clic en **Guardar**. 12. Haz clic en el botón **Probar conexión** para verificar que los datos de {{< glossary_term "wallethub" >}}WalletHub{{< /glossary_term >}} que has introducido son correctos. 13. Una vez que la prueba de conexión se realice correctamente, haz clic en **Activar**. La integración de la Hospitality API (Salto) ya está configurada y el punto de conexión está listo para el suministro de llaves de cartera. ## Resolución de problemas {#troubleshooting} Si encuentras problemas al configurar las llaves de cartera, prueba lo siguiente: ### La prueba de conexión falla {#test-connection-fails} Si el botón **Probar conexión** en el panel de **WalletHub** falla: 1. Verifica que has introducido el nombre de usuario y la contraseña correctos proporcionados por Salto. 2. Comprueba que tu red permite conexiones salientes al servicio WalletHub. 3. Asegúrate de que tienes el complemento de licencia requerido activo en tu instalación de Space. 4. Ponte en contacto con tu partner de Salto o con el contacto de soporte técnico para obtener asistencia. ### La activación falla después de una prueba exitosa {#activation-fails} Si la **Prueba de conexión** se realiza correctamente pero al hacer clic en **Activar** se produce un error: 1. Verifica que se hayan completado todos los pasos de configuración, incluidos los siguientes: - Generación de la clave de API y su compartición con el administrador de llaves de cartera de Hospitality - Configuración del puerto de la Hospitality API en ProAccess Space Configurator - Configuración del certificado TLS - Reglas del cortafuegos de red que permiten conexiones entrantes 2. Comprueba que los complementos de licencia requeridos estén activos. 3. Verifica que al menos un adaptador NCoder esté conectado correctamente y funcionando. ### No se pueden suministrar llaves de cartera {#unable-to-provision-keys} Si las llaves de cartera no se pueden suministrar después de una activación exitosa: 1. Verifica que tus opciones de SAM y emisión estén configuradas correctamente con el valor {{< glossary_term "tci" >}}TCI{{< /glossary_term >}} proporcionado por tu administrador de credenciales. Para obtener más información, consulta [Configuración de las opciones de llaves de cartera en Space](/space/user-guide/operator/sam-and-issuing-options/wallet). 2. Asegúrate de que al menos un adaptador NCoder esté conectado y funcione correctamente. 3. Verifica que el hardware de tu instalación cumpla con los requisitos de las llaves de cartera. Ponte en contacto con tu partner de Salto para obtener asistencia con la verificación del hardware. 4. Comprueba que el firmware del lector se haya actualizado a las versiones requeridas. ### Obtener ayuda {#getting-help} Si sigues experimentando problemas, [ponte en contacto con el soporte técnico de Salto](https://saltosystems.com/en/contact/) y proporciona la siguiente información: - Capturas de pantalla de la configuración completa de las **Llaves de cartera** (con todos los paneles expandidos y visibles) - Capturas de pantalla de cualquier mensaje de error mostrado - Tu versión de Space e información de licencia - Detalles sobre tu instalación de hardware Esta información ayudará al soporte técnico a diagnosticar y resolver el problema.