Skip to main content
UniFi Access (Website) ist eine On-Premise-Lösung für elektronische Türzugänge. Mit der Integration vergibt anny automatisch zeitlich begrenzte Zutrittsrechte für Buchungen und Community-Mitglieder. Mit UniFi kannst du in anny:
  • Ressourcen mit einer oder mehreren UniFi-Türen verknüpfen
  • Community-Mitgliedern Zugang zu ausgewählten Türen gewähren
  • den Zutritt über die UniFi App, einen PIN-Code oder Remote Open ermöglichen
Besonders praktisch ist die Integration, wenn du UniFi bereits als Netzwerk- und Zutrittssystem nutzt und Erfahrung mit Netzwerkverwaltung hast.
Die UniFi-Integration ist ab dem Professional-Plan verfügbar.

Typische Anwendungsfälle

Wie die UniFi-Verbindung funktioniert

anny authentifiziert sich mit der Host-URL deines UniFi-Netzwerks und einem API-Token. Die Host-URL muss von außen erreichbar sein. Über die Verbindung ruft anny die in UniFi Access eingerichteten Türen und Nutzer:innen ab und verwaltet passende Zutrittsrechte. Standardmäßig erzeugt anny für jede Buchung einen Gastzugang mit PIN-Code. Aktivierst du in der Zutrittsregel die Option Berechtigungen für bestehende Benutzer erweitern, gleicht anny zuerst die Buchungs-E-Mail mit bestehenden UniFi-Accounts ab: Bei einer Übereinstimmung läuft der Zugang über die UniFi App, sonst wird ein PIN-Code erzeugt. App-Zugänge über bestehende UniFi-Accounts erstellt anny kurz vor Buchungsbeginn (Just-in-Time). anny fügt den Account dafür einer selbst verwalteten Zutritts-Richtlinie (Policy mit dem Zusatz „anny“) hinzu und entfernt ihn am Ende des Zeitraums wieder. Bis zur Erstellung hat der Zugang den Status Geplant.
Bearbeite oder lösche die von anny erstellten Zutritts-Richtlinien (Policies mit dem Zusatz „anny“) und den Zeitplan „always access“ nicht manuell in UniFi. anny verwaltet sie automatisch. Manuelle Änderungen können den zeitlich begrenzten Zugang stören.
Wenn du den API-Token widerrufst oder die Host-URL nicht mehr erreichbar ist, kann anny keine Türen abrufen und keine Zutrittsrechte über UniFi verwalten.

UniFi verbinden

Voraussetzungen

Bevor du UniFi verbindest, stelle sicher, dass du Folgendes hast:
  • ein eingerichtetes UniFi-Netzwerksystem mit UniFi Access und funktionsfähigen Türen
  • eine von außen erreichbare Host-URL für dein UniFi-Netzwerk
  • einen API-Token, den du in der UniFi Access App erstellst
  • den Professional-Plan oder höher in anny
  • mindestens eine Ressource oder Community für die Zutrittsregel

Verbindung einrichten

1

Integration öffnen

Öffne aus der Menüleiste die Integrationen und gehe zu UniFi.
2

Authentifizieren

Trage die Host-URL deines UniFi-Netzwerks und den API-Token ein. Hinweise zum externen Netzwerkzugang findest du in dieser Anleitung.
3

Konfigurieren

Lege die benötigten Zutrittsregeln an:
  1. Klicke bei Buchungen oder Communities auf Hinzufügen.
  2. Wähle die Ressource oder Community aus.
  3. Ordne eine oder mehrere UniFi-Türen zu.
  4. Lege bei Buchungsregeln Zugang vor der Buchung und Zugang nach der Buchung fest.
  5. Aktiviere bei Bedarf Fernöffnung verwenden oder Berechtigungen für bestehende Benutzer erweitern.
4

Verbindung prüfen

Erstelle eine Testbuchung und öffne ihre Detailansicht. Prüfe dort den Status, den Zugangszeitraum, die Tür und bei Gastzugängen den PIN-Code.
Sobald die Verbindung aktiv ist, erstellt und entfernt anny Zutrittsrechte automatisch anhand deiner Regeln. Das folgende Bild zeigt, wo du eine Zutrittsregel für Buchungen anlegst und eine Ressource mit UniFi-Türen verknüpfst. Zutrittsregel für Buchungen konfigurieren Die Detailansicht einer Buchungsregel zeigt die zugeordnete Ressource, die Türen sowie den zeitlichen Vor- und Nachlauf. Details einer Buchungsregel Für Communitys ordnest du einer Community eine oder mehrere Türen zu. So erhalten ihre Mitglieder die festgelegten Zutrittsrechte. Zutrittsregel für eine Community konfigurieren
Über die drei Punkte an einer Regel kannst du bestehende Zuordnungen bearbeiten oder löschen. Du kannst mehrere Türen einer Ressource zuordnen und umgekehrt.

Einstellungen & Optionen

Du kannst aktive und inaktive Smart-Lock-Zugänge in der Buchungsdetailansicht prüfen. Dort siehst du den Status, den Zugangszeitraum, die Tür, das Erstellungsdatum und bei Gastzugängen den PIN-Code. Smart-Lock-Zugänge in der Buchungsdetailansicht

Remote Open

Mit der Remote-Open-Funktion können Kund:innen Türschlösser per Knopfdruck öffnen: direkt über die anny Homepage oder die Buchungsansicht. Die Buchungsansicht zeigt den Button nur während des gültigen Zugangszeitraums. Tür über Remote Open in der Buchungsansicht öffnen Für Remote Open über eine Community aktivierst du die Option Fernöffnung verwenden in der Community-Regel. Remote Open für eine Community aktivieren

Einschränkungen

Die UniFi-Integration unterstützt nicht:
  • die Einrichtung, Wartung oder Absicherung deines UniFi-Netzwerks und deiner Türhardware
  • eine Verbindung ohne öffentlich erreichbare Host-URL
  • den Zugang über die UniFi App ohne aktivierte Option Berechtigungen für bestehende Benutzer erweitern und ohne UniFi-Account mit der Buchungs-E-Mail
  • einen Gastzugang per PIN ohne kompatible UniFi-Hardware mit Keypad
  • Remote Open über eine Community ohne aktivierte Option Fernöffnung verwenden in der Community-Regel

Verbindung trennen

Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
Beides findest du unter Integrationen: Deaktivieren über den Toggle oben rechts, Löschen über die drei PunkteLöschen.

FAQ

Standardmäßig erzeugt anny einen PIN-Code für den Gastzugang. Aktivierst du Berechtigungen für bestehende Benutzer erweitern und existiert ein UniFi-Account mit der Buchungs-E-Mail, läuft der Zugang über die UniFi App. Zusätzlich kann Remote Open verfügbar sein.
Der Zugang gilt für den Buchungszeitraum einschließlich des Vor- und Nachlaufs, den du in der Zutrittsregel festgelegt hast.
Ja. Du kannst einer Ressource mehrere Türen zuordnen und eine Tür mit mehreren Ressourcen verknüpfen.
Wenn eine Buchung storniert und ihr Zugang entfernt wird, kann die gebuchte Tür nicht mehr über dieses Zutrittsrecht geöffnet werden.
Erstelle den API-Token in der UniFi Access App. Trage ihn anschließend zusammen mit der Host-URL in anny ein.

Troubleshooting

Die Host-URL ist möglicherweise nicht von außen erreichbar oder der API-Token ist ungültig. Prüfe die Host-URL, den Token sowie die Netzwerk- und Firewall-Konfiguration.
UniFi hat das angeforderte Zutrittsrecht noch nicht bestätigt. Prüfe die Verbindung und die zugeordnete Tür in UniFi. Teste die Regel anschließend mit einer neuen Buchung.
Prüfe den gültigen Zugangszeitraum und die Türzuordnung. Bei Community-Zugängen muss Remote Open zusätzlich in den Community-Berechtigungen aktiviert sein.