# Bewährte Methoden zur Einrichtung von Salto Nebula Hospitality Anlagen > Empfohlene Vorgehensweisen bei der Einrichtung Ihres Zutrittsplans in der Salto Nebula Hospitality Zutrittskontrollplattform. {{% info-panel %}} Die grundsätzlich Vorgehensweise zur Einrichtung eines Nebula Hospitality Zutrittsplans entspricht der von Homelok. Weitere Details, insbesondere zur Gerätekonfiguration, finden Sie unter [Bewährte Methoden für die Einrichtung von Homelok](/homelok/user-guide/property-manager/getting-started/best-practices). {{% /info-panel %}} ## Überblick {#overview} Der Zweck dieser Anleitung ist es, Verwalter, Besitzer und Salto Technologiepartner in die Plattform Salto Nebula Hospitality einzuführen. Sie sollten diese lesen, bevor Sie zum ersten Mal eine Anlage in Nebula Hospitality einrichten. Die Art wie Sie den Zutrittsplan für Ihre {{< glossary_term "installation" >}}Anlage{{< /glossary_term >}} erstellen, kann von zahlreichen Faktoren abhängen. Zum Beispiel: - Der Größe Ihrer Immobilie - Der Art von Geräten, die Sie verwenden - Ob in Ihrer Anlage Zimmer verwendet werden Dieser Abschnitt zeigt Ihnen bewährte Methoden zur Einrichtung von Zutrittsplänen in Nebula Hospitality auf. Der Abschnitt gibt Ihnen konkrete Empfehlungen zur Reihenfolge, in der Sie die verschiedenen Systemobjekte anlegen sollten, um eine reibungslose Einrichtung und laufende Verwaltung zu ermöglichen. Systemobjekte umfassen dabei unter anderem Zutrittspunkte, Zutrittsrechte, Zimmer, Benutzer und Schlüssel. {{% info-panel %}} Diese Anleitung spiegelt unsere Meinung wider und erläutert nicht die einzige Möglichkeit, den Zutrittsplan einer Anlage einzurichten. Sie zeigt jedoch die empfohlene Vorgehensweise für die große Mehrheit der Anlagen auf, insbesondere für die Ersteinrichtung und in Anlagen, die Zimmer enthalten. {{% /info-panel %}} {{% info-panel %}} Bevor Sie den Zutrittsplan einer Anlage einrichten können, müssen Sie zuerst eine Anlage erstellen und ein Abonnement hinterlegen. {{% /info-panel %}} ## Objektbeziehungen {#entity-relationship} Das folgende Diagramm stellt vereinfacht die wichtigsten Objekte einer Nebula Hospitality Anlage und ihre Beziehungen zueinander dar. {{< mermaid src="entity-relationship" >}} ### Anlage {#installation} - Stellt die übergeordnete Struktur dar, wie zum Beispiel ein Hotel- oder Wohnkomplex. - Hauptattribute: Name, Adresse, Zeitzone, Gestaltung der digitalen Schlüssel, Rechnungsdetails. ### Zimmer {#rooms} - Untergruppierungen innerhalb einer Anlage. Zum Beispiel ein Hotel (Anlage), das eine Reihe einzeln buchbarer Zimmer oder Apartments (Zimmer) enthält. - Hauptattribute: Name, Zutrittsrechte, Aktivität, Datenschutzeinstellungen und zugehörige Verwaltungsrollen. ### Zutrittspunkte {#access-points} - Stellen physische oder logische Zugangspunkte dar, z. B. Türen oder Tore. - Hauptattribute: Name, Kalender, Verbindungstyp, Öffnungsmodus, übergeordnetes Gerät. Kann zu einer spezifischen Anlage oder einem Zimmer gehören und mit {{< glossary_term "digital_key" >}}digitalen Schlüsseln{{< /glossary_term >}} interagieren. ### Benutzer {#users} - Stellen Sie Personen dar, die als Benutzerdatensätze im System verwaltet werden, wie z. B. Mitarbeiter oder anderes autorisiertes Personal (keine Gäste). - Hauptattribute: Name, E-Mail, Zutrittsrechte und verknüpfte Schlüsseltypen wie {{< glossary_term "app_key" >}}App-Keys{{< /glossary_term >}}. ### Zutrittsrechte {#access-rights} - Legen die Berechtigungen fest, die Benutzern für den Zutritt zu Türen in der Anlage oder zu bestimmten Zimmern gewährt werden. - Hauptattribute: Rollen, zugehörige Zimmer und verknüpfte Schlüsseltypen. ### Beziehungen {#relationships} - Anlagen <-> Zimmer: Eine Anlage kann viele Zimmer haben. Es handelt sich also um eine Eins-zu-viele-Beziehung. - Anlagen <-> Zutrittspunkte: Eine Anlage kann mehrere Zutrittspunkte haben. Es liegt also eine Eins-zu-viele-Beziehung vor. - Benutzer <-> Zimmer: Benutzer können über Zutrittsrechte einem oder mehreren Zimmern zugeordnet werden. - Benutzer <-> Zutrittsrechte: Ein Benutzer kann mehrere Zutrittsrechte haben, die ihn mit bestimmten Berechtigungen oder Zutrittspunkten verbinden. - Zutrittspunkte <-> Zutrittsrechte: In Zutrittsrechten werden Berechtigungen für Zutrittspunkte erteilt. ## Konfiguration von Zutrittspunkten {#configuring-access-points} Der erste und wichtigste Schritt bei Einrichtung einer Anlage besteht im Erstellen und Konfigurieren der Zutrittspunkte (elektronische Türkomponenten und zugehörige Geräte). Es gibt zwei Wege Zutrittspunkte in Nebula Hospitality zu erstellen und einzurichten: 1. Erstellen Sie die Zutrittspunkte zuerst in Nebula Hospitality Web, richten Sie diese dann ein und konfigurieren Sie sie über die {{< glossary_term "salto_nebula_app" >}}Nebula App{{< /glossary_term >}}. 2. Erstellen, Einrichtung und Konfiguration der Zutrittspunkte rein über die Nebula App. Egal welchen Weg Sie bevorzugen, denken Sie daran zuerst die Zutrittspunkte zu erstellen und zu konfigurieren, bevor Sie die anderen Elemente des Zutrittsplans erstellen. Weitere Informationen zur Gerätekonfiguration finden Sie im [Abschnitt Errichter](/nebula/user-guide/installer). ## Zutrittsrechte erstellen {#creating-access-rights} Sie sollten Zutrittsrechte einrichten, bevor Sie Gäste oder Mitarbeitende zur Anlage hinzufügen. {{% info-panel %}} In Nebula Hospitality sind Gäste und Benutzer unterschiedliche Objekte. Gäste werden beim Check-in automatisch erstellt und ihnen wird eine generierte Kennung zugewiesen (zum Beispiel "Gast SZRKJ"). Für die Zwecke dieses Abschnitts bezieht sich „Benutzer“ auf Rezeptionsmitarbeiter und anderes Personal, das dauerhafte Zutrittsrechte benötigt, nicht auf Gäste. Benutzer mit Verwaltungsrollen (Verwalter, Besitzer) können zu Nebula Hospitality hinzugefügt werden, bevor Zutrittsrechte für das Personal erstellt werden. {{% /info-panel %}} Sie können Zutrittsrechte als Gruppe von Berechtigungen betrachten, die Benutzern zugewiesen werden, um die Verwaltung des Zutritts zu und innerhalb Ihrer Anlage zu vereinfachen. Folgend eine Liste mit Beispielen für Zutrittsrechte: - Zutritt zu allen Außentüren - Zutritt zu Parkplatz und Haupteingang - Zutritt zu Bereichen, zu denen nur das Personal Zutritt erhalten darf - Zutritt zu Fitnesseinrichtungen Das Löschen von Zutrittsrechten wird nicht als Aufgabe betrachtet, die Sie häufig erledigen. Allerdings ist nicht möglich ein Zutrittsrecht zu löschen, solange dies noch aktiv von Benutzern verwendet wird. ## Benutzer erstellen {#creating-users} Sie sollten Benutzern Zutrittsrechte zuweisen, **BEVOR** Sie diesen Schlüssel zuweisen. Wenn Sie zuerst einen Schlüssel zuweisen, erhalten Benutzer möglicherweise schon eine Benachrichtigung, dass sie über einen Schlüssel verfügen. Dieser funktioniert aber erst, nachdem Sie die Zutrittsrechte zugewiesen haben. Benutzer können über mehrere Arten von Schlüsseln verfügen. Die verfügbaren Schlüsselarten hängen von dem Abonnement ab, das Sie erwerben. ## Zimmer erstellen {#creating-rooms} Falls Ihre Anlage über Zimmer verfügt, müssen Sie darauf achten, diese erst nach der [Ersteinrichtung](/nebula-hospitality/user-guide/manager/getting-started/create-installation) zu erstellen. Eine bewährte Methode bei Erstellung von Zimmern besteht in der Aufteilung der Zutrittsrechte. Das heißt, trennen Sie Zutrittsberechtigungen für Gemeinschaftsbereiche (wie den Haupteingang, das Fitnessstudio oder den Parkplatz) von jenen, die zu einem bestimmten Zimmer gehören (wie die Zimmertür selbst). Dies gibt Ihnen mehr Kontrolle bei der Verwaltung des Gästezutritts und erleichtert die Handhabung von Szenarien wie Frühankunft, Zimmerwechsel und verlängerter Aufenthalt. ## PMS-Integration und Buchungen {#pms-integration} Wenn Sie ein Property Management System (PMS) nutzen, bietet der Nebula Booking Service eine spezielle API für die automatische Abwicklung des gesamten Gäste-Lebenszyklus. Sobald eine Buchung in Ihrem PMS erstellt wurde, kann die Plattform {{< glossary_term "digital_key" >}}digitale Schlüssel{{< /glossary_term >}} und Zutrittsrechte beim Check-in aktivieren und beim Check-out entziehen, ohne dass Sie händisch eingreifen müssen. {{% info-panel %}} Die PMS-Integration erfolgt über die Nebula API. Weitere Informationen finden Sie im [Leitfaden für Nebula-Buchungs- und Hospitality-Workflows](https://developer.saltosystems.com/nebula/guides/bookings) im Salto Developer Portal. {{% /info-panel %}} ## Systemeinschränkungen {#system-limitations} In der folgenden Tabelle finden Sie einige Systemeinschränkungen, die Sie bei der Einrichtung einer Anlage berücksichtigen müssen. Es ist wichtig den verfügbaren Speicher auf physischen Schlüsseln, wie Schlüsselanhängern oder -karten, sowie auf digitalen Schlüsseln, wie {{< glossary_term "app_key" >}}App-Schlüsseln{{< /glossary_term >}} zu berücksichtigen. | Einschränkung | Beschreibung | | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Maximum Tür- oder Türgruppen pro Schlüssel | Sowohl physische als auch digitale Schlüssel können höchstens entweder 100 Türen oder 100 Türgruppen in ihrem Speicher ablegen. | | Maximum Türen pro Türgruppe | Jede Türgruppe kann höchstens 100 einzelne Türen aufnehmen. Türgruppen fassen einzelne Türen zu einem Objekt zusammen und reduzieren so den Speicherbedarf von X Türen im Schlüssel auf eins. Das bedeutet, dass Sie insbesondere in großen Anlagen Türgruppen bevorzugen sollten, da Sie mit diesen die Anzahl der nutzbaren Türen pro Zutrittsrecht erhöhen können. | | Einzelne Türen in verschiedenen Türgruppen | Eine einzelne Tür kann höchstens zu 20 Türgruppen gehören. | | Maximum Türen oder Türgruppen pro Zutrittsrecht | Jedes Zutrittsrecht kann höchstens 100 einzelne Türen oder 100 Türgruppen enthalten, unabhängig davon, ob es sich auf Anlagen- oder Zimmerebene befindet. | | Maximum Zutrittsrechte pro Benutzer | Benutzern können höchstens fünf Zutrittsrechte gleichzeitig zugewiesen werden. | | Maximum Zutrittsrechte pro Buchung | Eine Buchung kann höchstens 10 Zutrittsrechte in `Booking.access_rights` haben. Ein Zimmer kann höchstens 10 Standard-Zutrittsrechte in `default_access_rights` haben. | {{% info-panel %}} Diese Einschränkungen können durch die Anzahl der Kalender, Zeitpläne und Öffnungsmodi beeinflusst werden, die mit der Tür oder dem Zutrittsrecht verknüpft sind. Beachten Sie, dass mit steigender Anzahl der Elemente die Sie hinzufügen, immer auch der Speicherbedarf auf dem Schlüssel steigt. {{% /info-panel %}} ## Öffnungen {#unlocking} ### Physische Schlüssel {#physical-keys} Wenn Benutzer in Ihrer Anlage physische Schlüssel (Karten oder Anhänger) verwenden, müssen diese ihren Schlüssel vor den Leser der Türkomponenten halten, bis der Leser grün (Zutritt gewährt) oder rot (Zutritt verweigert) blinkt. Es kann vorkommen, dass vor dem grünen Blinken (Zutritt gewährt) der LED erst ein gelbes Blinken erfolgt. ### Digitale Schlüssel {#digital-keys} {{< glossary_term "digital_key" >}}Digitale Schlüssel{{< /glossary_term >}}, zum Beispiel {{< glossary_term "app_key" >}}App-Schlüssel{{< /glossary_term >}} müssen nicht direkt an den Leser gehalten werden. Mobile Geräte können Türen aus größerer Entfernung öffnen. Der tatsächliche Abstand ist jedoch von verschiedenen Faktoren abhängig, wie z. B. dem Gerätetyp oder etwaigen Hindernissen zwischen Telefon und Leser. Eine große Rolle spielt auch, ob {{< glossary_term "nfc" >}}NFC{{< /glossary_term >}} oder {{< glossary_term "bluetooth_low_energy" >}}Bluetooth Low Energy{{< /glossary_term >}} für die Öffnung verwendet wird. Anders als bei physischen Schlüsseln, werden Daten drahtlos an das Mobiltelefon des Nutzers gesendet. Das führt unter anderem dazu, dass Änderungen an den Zutrittsrechten des Benutzers immer übertragen werden, wenn das Mobiltelefon eine Internetverbindung hat. ## Zusammenfassung {#summary} Der grobe Ablauf zur Erstellung von Zutrittsrechten in Nebula Hospitality lautet wie folgt: {{< mermaid src="best-practices" >}} ### Beispielkonfiguration {#example-set-up} Ein vereinfachtes Beispiel für die Einrichtung eines möglichen Zutrittsplans könnte wie folgt aussehen: 1. Benutzer mit Verwaltungsrollen erstellen (Verwalter, Besitzer) 2. Zutrittspunkte, wie elektronische Türkomponenten oder Gateways, konfigurieren – dies erfolgt im Normalfall durch einen [zertifizierten Errichter](/nebula/user-guide/installer) 3. Admin-Benutzern Zutrittsrechte zuweisen 4. Zimmer erstellen 5. Zutrittsrechte auf Zimmerebene hinzufügen 7. Benutzern Schlüssel zuweisen 8. Benutzer sperren, löschen oder auschecken, wenn ihr Aufenthalt endet ## Integrationen {#integrations} Wenn Sie eine Integration mit Nebula Hospitality aufbauen, sollten Sie die Nebula API verwenden. Weitere Informationen zu Integrationen finden Sie in der API-Dokumentation im [Salto Developer Portal](https://developer.saltosystems.com/nebula).