> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.
# UniFi mit anny verbinden
> Automatisiere zeitlich begrenzte Türzugänge mit UniFi Access für Buchungen und Community-Mitglieder.
UniFi Access ([Website](https://ui.com/eu/de/physical-security/door-access)) 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
| Anwendungsfall | Beschreibung |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Buchbare Räume | **Automatischer Zugang pro Buchung:** Kund:innen erhalten nur für den festgelegten Zeitraum Zugang zu den Türen der gebuchten Ressource. |
| Mitgliederbereiche | **Zugang für Community-Mitglieder:** Mitglieder einer Community können die zugeordneten Türen öffnen. |
| Zugang ohne Schlüssel | **Flexible Türöffnung:** Kund:innen öffnen Türen über die UniFi App, einen PIN-Code am Keypad oder Remote Open in anny. |
## 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.
| Daten | Richtung | Häufigkeit |
| ---------------------- | ------------ | ------------------------------------------------------ |
| Türen und Nutzer:innen | UniFi → anny | Beim Laden und Konfigurieren der Integration |
| Zutrittsrechte | anny → UniFi | Bei Erstellung, Änderung oder Entfernung eines Zugangs |
| Türentriegelung | anny → UniFi | Bei Nutzung von Remote Open |
## 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
Öffne aus der Menüleiste die **Integrationen** und gehe zu **UniFi**.
Trage die Host-URL deines UniFi-Netzwerks und den API-Token ein. Hinweise zum externen Netzwerkzugang findest du in [dieser Anleitung](https://artofwifi.net/blog/how-to-access-the-unifi-controller-by-wan-ip-or-hostname-on-a-udm-pro).
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**.
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.
Die Detailansicht einer Buchungsregel zeigt die zugeordnete Ressource, die Türen sowie den zeitlichen Vor- und Nachlauf.
Für Communitys ordnest du einer Community eine oder mehrere Türen zu. So erhalten ihre Mitglieder die festgelegten Zutrittsrechte.
Ü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
| Einstellung | Wirkung |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ressource | Erstellt ein Zutrittsrecht, wenn die Ressource gebucht wird. |
| Community | Gewährt Mitgliedern der ausgewählten Community Zugang zu den zugeordneten Türen. |
| Tür | Legt fest, welche UniFi-Tür geöffnet werden darf. |
| Zugang vor der Buchung / Zugang nach der Buchung | Erweitert den Zutrittszeitraum um die konfigurierte Zeit. |
| Berechtigungen für bestehende Benutzer erweitern | Findet anny einen UniFi-Account mit der Buchungs-E-Mail, läuft der Zugang über die UniFi App. Ohne Treffer und ohne diese Option erhält die Person einen Gastzugang per PIN-Code. |
| Fernöffnung verwenden | Ermöglicht die Türöffnung über die Buchungsansicht in der anny App oder im Browser (Remote Open). |
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.
| Status | Bedeutung |
| -------------- | ----------------------------------------------------------------------------------------------- |
| In Bearbeitung | anny hat den Zugang angefordert, UniFi hat ihn aber noch nicht vergeben. |
| Geplant | Der App-Zugang für einen bestehenden UniFi-Account wird kurz vor Beginn automatisch erstellt. |
| Erfolgreich | Der Zugang ist aktiv und kann im angezeigten Zeitraum verwendet werden. |
| Entfernt | Das System oder ein:e Admin hat den Zugang entfernt. Die Person kann die Tür nicht mehr öffnen. |
### 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.
| Ort | Wo öffnest du die Tür? |
| -------- | ---------------------------------------------------------------------------------------------------------- |
| E-Mail | Der Link **Öffnen** leitet in den Browser weiter. Dort erscheint der Button **Tür entriegeln**. |
| anny App | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** sowie in der Buchung. |
| Browser | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** sowie in der Buchung. |
Die Buchungsansicht zeigt den Button nur während des gültigen Zugangszeitraums.
Für Remote Open über eine Community aktivierst du die Option **Fernöffnung verwenden** in der Community-Regel.
## 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 Punkte** → **Lö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.
> Wichtige Informationen für Agenten:
>
> **Einordnung:** UniFi (Ubiquiti UniFi Access) ist eine Smart-Lock-Integration (Zutritt/Türöffnung), gehört zur Feature-Gruppe der Smart-Locks (Feature INTEGRATIONS\_SMART\_LOCKS, laut Artikel ab Professional-Plan; Plan-Zuordnung liegt in der Datenbank und ist nicht aus dem Code verifizierbar). Bei Fragen zur Auswahl oder zum Vergleich anderer Schließsysteme auf den Artikel „Smart-Lock-Integrationen“ unter `/smart-locks-uebersicht` verweisen. Fragen zur Kompatibilität einzelner UniFi-Geräte anhand der offiziellen UniFi-Dokumentation klären, nicht aus der anny Integrationslogik ableiten.
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **UniFi** → Felder **Host-URL** + **API-Token** → Button **Authentifizierung überprüfen**. Regeln: gleiche Seite, Panels **Zugang durch Buchungen** und **Zugang durch Communities** → **Hinzufügen**. Felder im Regel-Editor: Ressource bzw. Community, Türauswahl (in der generischen UI **Zylinder auswählen** / Spalte **Schlösser**; für UniFi sind das Türen), **Zugang vor der Buchung**, **Zugang nach der Buchung**, Schalter **Fernöffnung verwenden** (Spalte **Fernöffnung**) und — nur bei Buchungsregeln — **Berechtigungen für bestehende Benutzer erweitern**. Deaktivieren/Aktivieren über den **Toggle** oben rechts; Löschen über die **drei Punkte** → **Löschen**.
>
> **Verbindung:** anny spricht die UniFi-Schnittstelle über die Host-URL auf Port 12445 an. Die Host-URL muss von außen erreichbar sein und sollte keinen eigenen Port enthalten. Zugangsdaten (Host-URL/API-Token) lassen sich nur bei deaktivierter Integration ändern; schlägt die Prüfung fehl, verwirft anny den Token.
>
> **Quirks:** (1) Standardweg ist der Gastzugang per PIN (UniFi-„Visitor“). App-Zugang (Zuordnung zum bestehenden UniFi-Account) erfolgt nur, wenn die Buchungsregel **Berechtigungen für bestehende Benutzer erweitern** aktiviert hat UND ein UniFi-Account mit der Buchungs-E-Mail existiert. (2) App-Zugänge werden Just-in-Time erstellt: rund 10 Minuten vor Beginn hinzugefügt, am Ende entfernt; bis dahin Status **Geplant**. anny nutzt dafür pro Tür eine Policy mit dem Namenszusatz „anny“ und den UniFi-Zeitplan „always access“; fehlende Policies werden automatisch neu erstellt. (3) Nur bestätigte Buchungen mit Kund:in lösen Zugänge aus; Blocker und angefragte/abgelehnte/stornierte Buchungen nicht. (4) Regeln auf einer übergeordneten Ressource greifen auch für Unterressourcen; die spezifischere Regel gewinnt. (5) Ändern der Türen/Ressource einer Regel bei aktiver Integration erstellt künftige Zugänge neu. (6) Es gibt keinen URL-Zugangstyp und keine externe Anzeige-URL („Zugang beim Anbieter anzeigen“ ist für UniFi leer). (7) Fehlgeschlagene Zugänge: bei 429/503 Wiederholung nach kurzer Zeit; endgültige Fehlschläge → Status **Fehlgeschlagen** und E-Mail an die hinterlegten Personen; liegt der Start > 48 h in der Zukunft, wird neu geplant.
>
> **Statuslabels (Buchungsdetail):** **In Bearbeitung** (pending), **Geplant** (scheduled), **Erfolgreich** (successful), **Entfernt**, **Fehlgeschlagen**, **Aufräumen**, **Nicht autorisiert**. Feldname der Tür in der Detailansicht: **Türschloss**.
>
> **Remote Open (Fernöffnung):** Kundenbutton heißt **Tür entriegeln** (Home-Seite unter **Heutige Zugänge** und in der Buchung), E-Mail-Link heißt **Öffnen** und führt in den Browser; Admin-Aktion in der Buchungsdetailansicht heißt **Schloss entsperren**. Button nur im gültigen Zugangszeitraum aktiv. Community-Remote-Open über die Option **Fernöffnung verwenden** in der Community-Regel.
>
> **Aktivitätsprotokoll:** „hat den Zugang zu {Türen} eingerichtet“ / „hat den Zugang zu {Türen} entfernt“.