Konnektivitätsaspekte für die Hospitality-API
Überblick
Ab Version 6.10 verfügt Space über einen REST-API-Endpunkt für die Bearbeitung von Apple Wallet-Schlüssel-Anforderungen für das Gastgewerbe. Dadurch wird sichergestellt, dass Anfragen von Apple Wallet-kompatiblen Credential-Managern, die sich außerhalb des Hotelgeländes befinden, sicher verarbeitet werden.
In this documentation, the term Hospitality wallet key manager refers to the credential manager software that connects to Space via the Hospitality API to manage the guest's wallet key lifecycle (issuance, revocation, etc.). The Hospitality wallet key manager offers a Hospitality credential manager software that, connected to Space through the Hospitality API, manages the guest wallet key lifecycle (issuance, revocation).
Die Funktion Apple Wallet Key ist lizenzabhängig. Siehe Space registrieren und lizenzieren für weitere Informationen.
Dieser Abschnitt beschreibt eine Möglichkeit, eine sichere und zuverlässige Integration zwischen der Space Software und den Credential-Managern herzustellen. Dabei werden direkte Anfragen an die öffentliche IP-Adresse oder Domäne des Kundenobjekts gestellt.
Direkte Anfragen an die öffentliche IP-Adresse oder Domäne der Kundenanlage
If this option is not feasible for you, please get in touch with your Salto representative to explore alternative solutions. One such alternative is using a third party wallet key provider, which handles the provisioning of wallet keys that can be used in Space environments.
The direct request process allows the Hospitality wallet key manager to send requests straight to the customer property's public IP address. To enable this, the customer property must apply network-level configurations to accept incoming connections from the Hospitality wallet key manager.
To ensure security, we strongly recommend allowing requests only from the Hospitality wallet key manager's IPs. We will provide the specific IPs from which the Hospitality wallet key manager will make requests to customer properties as needed.
Der Kunde hat die Möglichkeit zu entscheiden, ob Anfragen an eine öffentliche IP-Adresse oder an eine eigene Domäne gestellt werden sollen. If they choose to use a domain, they can use a TLS certificate issued by a Certificate Authority (CA) with a Common Name (CN) matching their domain, and the Hospitality wallet key manager will verify this certificate. Selbstsignierte Zertifikate sind ebenfalls zulässig. They can also use CA-verified certificates even if the requests are made to a public IP instead of a domain, but Hospitality wallet key managers cannot verify these certificates.
Wichtige Überlegungen
- The customer property must provide the public IP address and port or domain to which they want the Hospitality wallet key manager to send the requests.
- If the customer property wants to change the public IP, port, or domain to which the Hospitality wallet key manager makes requests, they must notify the appropriate party to ensure proper adjustments in the configuration.
- Make sure you select the Any source option in the configurator under Connection type to ensure the Hospitality wallet key manager can make direct requests to the API.
- Die folgenden Zeichen sind bei der Benennung von Zimmern und Schlüsseln nicht zulässig: "?", "/", ":", "%", "#" und "". Dies gilt sowohl für die Tunnellösung als auch für direkte Anfragen. Es kann auch weitere Sonderzeichen geben, die nicht erlaubt sind.
Stellen Sie sicher, dass Sie die Option 'Jede Quelle' im Space Konfigurator auswählen
Zusätzliche Informationen
Zurück
Versionen aktualisieren