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 Partners 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.

Indem Sie dieser Anleitung folgen, werden Sie in der Lage sein:

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

Dieser Leitfaden richtet sich an Salto Partner oder Salto Teams, die die Wallet-Key-Lösung an einem Standort 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 über Hospitality API erreichbar sein, die die Software-Instanz aufruft (eingehend).
• Einrichtung Space
  • Ordnungsgemäße Konfiguration sowohl ausgehender als auch eingehender Endpunkte.
  • Authentifizierungsdaten müssen korrekt eingerichtet 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 (beispielsweise 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 sein und die Firmware muss aktualisiert werden, um die Compliance sicherzustellen. Zusätzlich muss die Hardware während des Setups korrekt SAM-konfiguriert werden.
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 spezifizierten 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 Add-ons

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. Die 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

Konfigurieren Sie im ProAccess Space Configurator, auf der Registerkarte Erweitert den Port für die Hospitality API. Das ProAccess Space Configurator Symbol befindet sich 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 Schlösser 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