# Consideraciones sobre la conectividad para el endpoint de la API REST de Space Hospitality
> A partir de la versión 6.10, Space dispone de un endpoint de la API REST diseñado para gestionar solicitudes de llaves de Apple Wallet para el sector de la hostelería.


## Introducción {#overview}

A partir de la versión 6.10, Space incluye un endpoint de API REST diseñado para gestionar las solicitudes de {{< glossary_term "apple_wallet_key" >}}llave de Apple Wallet{{< /glossary_term >}} para el sector de la hostelería.
Esto garantiza que las solicitudes de los administradores de credenciales compatibles con Apple Wallet, ubicados fuera de las instalaciones del cliente, se atiendan de forma segura.

En esta documentación, el término **administrador de llaves de monedero de hostelería** se refiere al software administrador de credenciales que se conecta a Space a través de la Hospitality API para gestionar el ciclo de vida de la llave de monedero del guest (emisión, revocación, etc.).

{{% info-panel %}}\nLa funcionalidad de llave de Apple Wallet está sujeta a 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).
{{% /info-panel %}}

Esta sección describe cómo establecer una integración segura y fiable entre el software de Space y los administradores de credenciales mediante la realización de solicitudes directas a la IP pública o al dominio de la propiedad del cliente.

## Requisitos de configuración de red {#network-configuration-requirements}

La integración de la Hospitality API requiere una configuración de red específica para permitir conexiones entrantes desde el administrador de llaves de monedero de hostelería a tu instalación de Space.

### Reglas de firewall {#firewall-rules}

El firewall de tu red debe estar configurado para permitir conexiones entrantes al endpoint de la Space Hospitality API.
Para garantizar la seguridad, recomendamos **firmemente** permitir solicitudes únicamente desde las direcciones IP del administrador de llaves de monedero de hostelería.
Contacta a tu representante de Salto para conocer las direcciones IP específicas desde las cuales el administrador de llaves de monedero de hostelería realizará las solicitudes.

### Información requerida {#required-information}

Debes proporcionar la siguiente información a tu administrador de llaves de monedero de hostelería:

- **Dirección IP pública o dominio**: La dirección a la que el administrador de llaves de monedero de hostelería enviará las solicitudes
- **Número de puerto**: El puerto configurado para el endpoint de la Hospitality API en el ProAccess Space Configurator (consulta [Configuración de las llaves de monedero](/space/user-guide/operator/general-options/wallet-keys#api-configuration))
- **Llave de autenticación de la API**: Generada en Space y compartida con el administrador de llaves de monedero de hostelería (consulta [Configuración de las llaves de monedero](/space/user-guide/operator/general-options/wallet-keys#api-configuration))

## Configuración del certificado TLS {#tls-certificate-configuration}

La comunicación con la Hospitality API se basa en Transport Layer Security (TLS), lo que requiere un certificado.
Tienes varias opciones para la configuración del certificado:

### Certificado emitido por una CA con dominio personalizado {#ca-issued-certificate}

Si decides utilizar tu propio dominio para el endpoint de la Hospitality API, puedes utilizar un certificado TLS emitido por una Autoridad de Certificación (CA) con un nombre común (CN) que coincida con tu dominio.
El administrador de llaves de monedero de hostelería verificará este certificado.

**Ejemplo**: Si tu dominio es `space.myhotel.com`, el CN de tu certificado debe coincidir con este dominio.

### Certificado autofirmado {#self-signed-certificate}

Se permiten certificados autofirmados para el endpoint de la Hospitality API.
Sin embargo, ten en cuenta que los administradores de llaves de monedero de hostelería no verifican los certificados autofirmados.

### Certificado verificado por una CA con IP pública {#ca-verified-certificate-public-ip}

Puedes utilizar un certificado verificado por una CA incluso si las solicitudes se realizan a una dirección IP pública en lugar de a un dominio.
Sin embargo, los administradores de llaves de monedero de hostelería no pueden verificar estos certificados.

## Solicitudes directas a la IP pública o al dominio de la propiedad del cliente {#direct-requests-to-hotels-public-ip-or-domain}

El proceso de solicitud directa permite que el administrador de llaves de monedero de hostelería envíe solicitudes directamente a la dirección IP pública o al dominio de la propiedad del cliente.
Para habilitar esto, la propiedad del cliente debe aplicar configuraciones a nivel de red para aceptar conexiones entrantes del Hospitality wallet key manager.

### Pasos de configuración {#configuration-steps}

1. **Configurar las reglas de firewall**: Permite conexiones entrantes desde las direcciones IP del administrador de llaves de monedero de hostelería a tu endpoint de la Space Hospitality API.

2. **Configurar el puerto de la Hospitality API**: En el ProAccess Space Configurator, configura el número de puerto para el endpoint de la Hospitality API.
   Consulta [Configuración de las llaves de monedero](/space/user-guide/operator/general-options/wallet-keys#api-configuration) para obtener más detalles.

3. **Configurar el certificado TLS**: Configura la opción de certificado TLS elegida (consulta [Configuración del certificado TLS](#tls-certificate-configuration) arriba).

4. **Seleccionar el connection type**: En el ProAccess Space Configurator, asegúrate de seleccionar la opción **Cualquier origen** en **Connection type** para permitir que el administrador de llaves de monedero de hostelería realice solicitudes directas a la API.

!['Opción 'Cualquier origen' en el configurador de Space](images/wallet-keys-api-port-config.png "Asegúrate de seleccionar la opción 'Cualquier origen' en el configurador de Space")
{.border}

5. **Generar y compartir la llave de la API**: En Space, genera la llave de autenticación de la API y compártela con tu administrador de llaves de monedero de hostelería.
   Consulta [Configuración de las llaves de monedero](/space/user-guide/operator/general-options/wallet-keys#api-configuration) para obtener más detalles.

6. **Proporcionar información del endpoint**: Comparte tu dirección IP pública o dominio y el número de puerto con tu administrador de llaves de monedero de hostelería.

### Consideraciones importantes {#important-considerations}

- Si necesitas cambiar la IP pública, el puerto o el dominio al que el administrador de llaves de monedero de hostelería realiza solicitudes, debes notificarlo a tu administrador de llaves de monedero de hostelería para garantizar los ajustes adecuados en su configuración.
- Los siguientes caracteres no están permitidos al nombrar habitaciones y llaves: "?", "/", ":", "%", "#" y "\".
  También puede haber otros caracteres especiales que no estén permitidos.
- Asegúrate de que tu infraestructura de red pueda gestionar el volumen esperado de solicitudes de la API.
- En el **ProAccess Space Configurator**, asegúrate de seleccionar la opción **Cualquier origen** en **Connection type** para que el gestor de llaves de wallet para hostelería pueda realizar solicitudes directas a la API.
- A partir de Space v6.14, la pestaña **Advanced** del **ProAccess Space Configurator** incluye un botón **Verify** para la API de hostelería.
  Haz clic en **Verify** para enviar una solicitud HTTP a `localhost` en el puerto de la API configurado y confirmar que la API se está ejecutando y responde correctamente.

## Opciones de integración alternativas {#alternative-integration-options}

{{% info-panel %}}
Si las solicitudes directas a la IP pública o al dominio de tu propiedad no son viables, ponte en contacto con tu representante de Salto para explorar soluciones alternativas.
Una de estas alternativas es el uso de un **proveedor de llaves de monedero de terceros**, que gestiona el aprovisionamiento de llaves de monedero que se pueden utilizar en entornos de Space.
{{% /info-panel %}}

## Referencias adicionales {#additional-references}

- [Esquema de conectividad de Space](/space/user-guide/systems-admin/system-requirements#connectivity-scheme-for-space)
- [Cómo configurar Space para usar con llaves de wallet](/space/user-guide/operator/general-options/wallet-keys)
- [Documentación de la API de Hospitality en el portal para desarrolladores de Salto](https://developer.saltosystems.com/space/hospitality-api/)