Inbetriebnahmeanleitung für den Wallet-Key-Service für Hotelgäste

Überblick

Die Inbetriebnahme der Wallet-Key-Lösung für Hotelgäste muss gemeinsam durch den Wallet-Key-Serviceanbieter des Hotels (d. h. Credential Manager), den Salto Partner und das Salto Team erfolgen.

Dieser Leitfaden bietet Schritt für Schritt Anweisungen für die Einrichtung und Inbetriebnahme der Salto spezifischen Komponenten der Walle-Key-Service-Lösung für Hotelgäste in Space. Der Service ermöglicht es Hotelgästen digitale Wallet-Keys, wie Zimmerschlüssel in Apple Wallet zu verwenden, um Zutritt zu ihren Zimmern über Salto Zutrittspunkte zu erhalten.

Wenn Sie dieser Anleitung folgen, können Sie:

• Kompatibilitätsanforderungen hinsichtlich Hardware- und Firmware überprüfen
• Die benötigten Space Lizenzen und Softwareeinstellungen einrichten
• Die Verbindung über die Hospitality API zwischen Salto Space und Ihrem System herstellen
• Die Netzwerk- und Firewallregeln für sichere eingehende Verbindungen einrichten
• Space mit dem Salto WalletHub (Umgebung Dev oder Prod) verbinden
• Türkomponenten und Leser für die Ausgabe von Wallet-Keys einrichten

Dieser Leitfaden richtet sich an Salto Partner und Salto Teams, die die Wallet-Key-Lösung in einer Anlage in Betrieb nehmen und bereitstellen möchten.

Inbetriebnahme-Setup

Um ein erfolgreiches Inbetriebnahme-Setup zu gewährleisten, müssen folgende Punkte berücksichtigt werden:

• Hardware-Kompatibilität
  • Stellen Sie sicher, dass die Hard- und Firmware-Versionen kompatibel sind.
• Space-Installation
  • Alle erforderlichen Lizenzen müssen in Space aktiv sein.
    • SPACE-OPT-0041 Wallet Guest Keys
    • (Nur für Entwickler) SPACE-OPT-0030 benutzerdefinierte Web-Services - siehe Integrator-Fußnoten für weitere Details
  • Die Space-Installation muss korrekt konfiguriert sein.
  • Der Space Server muss für die Hospitality API aufrufende Softwareinstanz erreichbar sein (eingehend).
• Einrichtung Space
  • Ordnungsgemäße Konfiguration ausgehender und eingehender Endpunkte.
  • Authentifizierungsdaten müssen korrekt eingerichtet sein und sicher verwaltet werden.

Architektur der Lösung

Lösungsarchitektur

Hardware-Kompatibilität

Bitte kontaktieren Sie Ihren zuständigen Salto Ansprechpartner, um die für die Produktkonformität und Testzwecke erforderlichen Hardware- und Firmware-Versionen zu erfragen.

Schritt-für-Schritt Konfiguration: Assets

Bevor Sie mit der Konfiguration in Space beginnen, benötigen Sie Folgendes:

• TCI: Eindeutige 3-Byte-Kennung (ein hexadezimaler Wert aus 6 Zeichen) für die Wallet-Pass-Identifikation. Muss vom Wallet-Key-Dienstanbieter bereitgestellt werden.
• Informationen zum Hospitality-API-Endpunkt des Wallet-Key-Dienstanbieters: IP-Adresse und Port werden benötigt, um die Regeln für die Firewall zum Schutz des Objekts und den Windows-Server zu konfigurieren, damit eingehende Verbindungen zugelassen werden.
• Auf Objektebene muss der Endkunde (zum Beispiel das IT-Team des Objekts) sowohl die Firewall des Objekts als auch den Windows-Server, auf dem Space gehostet wird, konfigurieren, um eingehende Verbindungen zuzulassen.
• Space-Hosting IP-Adresse und Port-Nummer müssen dem Wallet-Key-Dienstanbieter mitgeteilt werden.
• WalletHub Zugangsdaten müssen von Salto bezogen und sicher mit den Wallet-Key-Dienstanbietern geteilt werden.

Schritt-für-Schritt-Konfiguration: Allgemein

1. Die Hardware muss kompatibel und die Firmware aktuell, um die Konformität sicherzustellen. Zusätzlich muss die Hardware während des Setups die korrekte SAM-Konfiguration erhalten.
2. Einen dedizierten NCoder einrichten:
   • Firmware-Nummer: 0172
   • Firmware-Version: v01.15 oder neuer
3. Software und Infrastruktur (Space Instanz, Netzwerkkonfiguration usw.) müssen den in der Hospitality API Dokumentation angegebenen Anforderungen entsprechen.

Netzwerkkonfiguration

Siehe die Anforderungen an die Netzwerkkonfiguration in der Space Hospitality API Dokumentation.

Dongle NCoder

Für die Verwendung und Ausgabe von Wallet-Keys wird ein NCoder im Dongle-Modus benötigt (Check-in usw.).

Weitere Informationen finden Sie im Abschnitt Wie man Encoder zum Salto Netzwerk in Salto Space hinzufügt.

Schritt-für-Schritt-Konfiguration: Space

Sie müssen Space wie folgt konfigurieren:

Space Lizenz Optionen

SPACE-OPT-0041

Die Option aktiviert die erforderliche Funktion Wallet Guest Keys. Stellen Sie sicher, dass die Funktion aktiv ist, bevor Sie fortfahren.

SPACE-OPT-0030

Nur Integratoren benötigen dieses Lizenz-Add-on für Testzwecke. Für Endkunden ist dieses Add-On nicht erforderlich.

Siehe Fußnoten für weitere Details.

Allgemeine Optionen

Allgemeine Optionen > Wallet-Keys

1. Gehen Sie auf System > Allgemeine Optionen > Wallet-Keys
2. Wählen Sie als Integrationstyp Hospitality API aus der Dropdown-Liste.

Allgemeine Optionen - Erstellung API-Schlüssel

Erstellung API-Schlüssel

1. Klicken Sie im Abschnitt API auf Erstellen. Der Wert Authentifizierung (API-Schlüssel) wird automatisch erstellt. Dieser Authentifizierungsschlüssel ermöglicht die Verbindung zwischen Space und Wallet-Key-Dienstanbietern.
2. Teilen Sie den API-Schlüssel mit dem Wallet-Key-Dienstanbieter: Dieser erstellte Authentifizierungsschlüssel muss in der Umgebung des Wallet-Key-Dienstanbieters verwendet werden (z. B. Alliants).

Space Configurator

Space Configurator

Legen Sie im ProAccess Space Configurator, auf der Registerkarte Erweitert den Port für die Hospitality API fest. Sie finden den ProAccess Space Configurator auf dem Desktop der Maschine, auf der Space installiert ist.

Zu verwendende Zertifikate:

• a) Der Kunde kann wählen, ob Anfragen an eine öffentliche IP oder die eigene Domain gesendet werden sollen. Dies erfolgt unter Verwendung eines von einer CA ausgestellten TLS-Zertifikats mit einem passenden CN, das der Integrator verifizieren wird.
• b) Selbstsignierte Zertifikate sind ebenfalls zulässig.
• c) Auch wenn Anforderungen nicht an die Domäne, sondern an eine öffentliche IP-Adresse gestellt werden, können Sie auch CA-verifizierte Zertifikate verwenden, allerdings können Integratoren diese Zertifikate nicht verifizieren.

Siehe auch Konnektivitätsaspekte für die Hospitality API

Webhook

Konfiguration Webhook

(Optional) Aktivieren Sie bei Bedarf das Kontrollkästchen Aktivieren im Abschnitt WebHook der Registerkarte Wallet Keys in den allgemeinen Optionen, um diese Funktion zu verwenden. Sie können Webhooks verwenden, um bei Änderungen benachrichtigt zu werden, die ausgegebene Wallet-Keys betreffen. Beachten Sie jedoch, dass diese Benachrichtigungen einem Best-Effort-Ansatz folgen. Es kann nicht sichergestellt werden, dass sie in allen Fällen zuverlässig funktionieren.

Sie müssen die folgenden Daten angeben, um Webhook-Benachrichtigungen zu erhalten:

• Webhook URL: URL, auf der Sie die Benachrichtigungen erhalten möchten.
• Webhook Benutzername: Benutzername für einfache Authentifizierung.
• Webhook Passwort: Passwort für einfache Authentifizierung.

WalletHub

Die Salto Komponente WalletHub ist für die Verwaltung der Wallet-Keys verantwortlich und verteilt diese an Türkomponenten und Leser.

Konfiguration WalletHub

1. Geben Sie im Abschnitt WalletHub den Benutzernamen und das Passwort ein. Diese Daten werden von Salto zur Verfügung gestellt.
2. Klicken Sie auf Speichern.
3. Klicken Sie auf Verbindung testen, um zu überprüfen, ob die eingegebenen WalletHub Daten korrekt sind.
4. Klicken Sie nach der Bestätigung auf Aktivieren. Die Wallet-Keys sind damit konfiguriert und einsatzbereit.

SAM & Issuing

Die SAM- & Issuing Konfiguration wird benötigt, um die Bereitstellung von Wallet-Keys für die Türkomponenten und Leser zu ermöglichen.

SAM & Issuing Konfiguration

• Gehen Sie auf System > SAM & Issuing Daten
• Wählen Sie in der Liste der aktiven Schlüssel die Option Wallet aus
• Wählen Sie im Bereich Credential-Provider die Option Salto aus
• Geben Sie den TCI-Wert ein. Dabei handelt es sich um einen 6-stelligen hexadezimalen Wert. Der TCI Wert wird vom Wallet-Key-Dienstanbieter bereitgestellt.
• Klicken Sie auf Schlüssel erstellen, um den Schlüssel zu erstellen. Dieser wird für die Bereitstellung der Wallet-Schlüssel verwendet.
• Konfigurieren Sie die Salto Leser mit einem PPD (tragbares Programmiergerät)

Weitere Informationen finden Sie im Abschnitt SAM und Issuing Optionen für Wallet-Keys.

Weitere Ressourcen

• Space - Allgemeine Optionen - Wallet-Keys
• SAM und Issuing Optionen für Wallet-Keys
• Konnektivitätsaspekte für die Hospitality API
• Hospitality API Dokumentation

Fußnoten

SPACE-OPT-0030 Lizenz Add-on