Eine UniFi-Access-Tür oder einen UniFi-Network-Controller anlegen

Um eine UniFi-Access-Tür oder eine UniFi-Network-Installation aus Link’nX zu steuern, legen Sie zuerst die Tür mit dem API-Token ihres Access-Controllers oder die UniFi-Network-Konsole mit einem lokalen Konto an. Diese Einträge werden anschließend von Aktionen, Szenario-Auslösern und KNX-Zuordnungen verwendet.

Für Administratoren und Installateure, die über das Projekt, das Gateway und die entsprechende Option verfügen. UniFi Access steuert Türen; UniFi Network verwaltet Netzwerkgeräte und -clients. UniFi Protect für die Videoüberwachung wird zusammen mit den Kameras angelegt.

Bevor Sie beginnen

• UniFi Access: Halten Sie Host und Port des Access-Controllers, ein für diese Installation autorisiertes API-Token und die zu steuernde Tür bereit. Der Installateur bestätigt die Erstellung des Tokens und die Erstkonfiguration des Controllers.
• UniFi Network: Halten Sie eine UniFi-OS-Konsole, deren Host und Port, den Site-Schlüssel von UniFi Network und die Zugangsdaten eines lokalen Kontos bereit, das zur Verwaltung des Controllers berechtigt ist.
• Geben Sie Token und Zugangsdaten nur im Link’nX-Formular ein, niemals in einer E-Mail.

Die Liste UniFi Access oder UniFi Network öffnen

1. Wählen Sie in Link’nX das Projekt und das Gateway aus.
2. Öffnen Sie in der Gerätenavigation Security & Access → UniFi Access (Sicherheit & Zutritt → UniFi Access) oder Smart Home → UniFi Network. Sie können auch nach dem Namen der Produktfamilie suchen. Auf einem kleinen Bildschirm öffnen Sie zuerst die Navigation.
3. Klicken Sie in der Liste auf Add (Hinzufügen).

Fehlt der Eintrag, prüfen Sie den Kontext und die verfügbare Option mit dem Leitfaden zur Navigation. Bei einer mit Soon (Demnächst) markierten Karte fragen Sie den Support nach Zugang, Lizenz oder Kompatibilität des Modells.

Eine UniFi-Access-Tür anlegen

Ein Eintrag steht für eine Tür.

1. Füllen Sie Name aus, bis zu 64 Zeichen, zum Beispiel Fiktiver Eingang.
2. Geben Sie unter Host (hostname or IP) (Host: Hostname oder IP) den Controller mit seinem Netzwerknamen oder seiner IP-Adresse an, bis zu 128 Zeichen.
3. Prüfen Sie Port, vorausgefüllt mit 12445, und behalten Sie den für die Installation bestätigten Port bei.
4. Füllen Sie API token (API-Token) aus; es wird verdeckt angezeigt. Unter diesem Feld erinnert das Formular daran, dass die Uhren des Access-Controllers und des Gateways per NTP synchronisiert sein müssen: Ein Ereignis, das älter als 2 Minuten ist, wird ignoriert.
5. Klicken Sie unter Controlled door (Gesteuerte Tür) auf Detect doors (Türen erkennen). Die Erkennung funktioniert schon vor dem ersten Speichern, sobald Host und Token ausgefüllt sind.
6. Warten Sie auf das Ergebnis und wählen Sie dann Ihre Tür unter Door (Tür) aus. Es wird keine Tür automatisch ausgewählt.
7. Klicken Sie unten rechts auf die runde Schaltfläche mit dem Diskettensymbol. Warten Sie auf Success! (Erfolg!) und suchen Sie den Eintrag dann in der Liste.

Legen Sie für mehrere Türen desselben Controllers je einen Eintrag pro Tür an. Bevor Sie die Tür eines Eintrags ersetzen, der von Automatisierungen verwendet wird, prüfen Sie deren Ziele.

Einen UniFi-Network-Controller anlegen

Das Formular verlangt das lokale Konto des Controllers, nicht Ihr Link’nX-Konto: Lassen Sie es vom Installateur bestätigen. Verwenden Sie kein Access-Token anstelle von Benutzername und Passwort.

1. Füllen Sie Name aus, bis zu 64 Zeichen.
2. Geben Sie Host (hostname or IP) ein, bis zu 128 Zeichen, zum Beispiel console.example.test, ein fiktiver Wert, den Sie ersetzen müssen.
3. Prüfen Sie Port, vorausgefüllt mit 443, entsprechend der installierten Konsole.
4. Füllen Sie Site aus, bis zu 64 Zeichen, vorausgefüllt mit default. Geben Sie den bestätigten Site-Schlüssel ein: Sein Anzeigename kann davon abweichen.
5. Füllen Sie Username (Benutzername), bis zu 128 Zeichen, und Password (Passwort) des lokalen Kontos aus. Beide Felder sind erforderlich. Das Passwort wird bei der Eingabe im Klartext angezeigt: Verdecken Sie es in jedem Screenshot.
6. Klicken Sie unten rechts auf das Diskettensymbol, warten Sie auf Success! und prüfen Sie dann die Liste.

Dieses Formular bietet weder eine Erkennung von Türen noch eine automatische Auswahl von Netzwerkclients. Bei einem älteren eigenständigen Controller an einem anderen Port lassen Sie das Vorgehen für Ihre Version bestätigen: Eine bloße Änderung des Ports reicht nicht aus, um seine Kompatibilität nachzuweisen.

Einen Eintrag ändern oder löschen

• Klicken Sie in der Zeile auf das Stiftsymbol Edit (Bearbeiten), ändern Sie die betreffenden Felder, speichern Sie und prüfen Sie den Eintrag. Bei UniFi Access wird die Türerkennung beim Öffnen der Bearbeitung erneut ausgeführt.
• Eine Änderung von Host oder Port kann die Türauswahl leeren: Führen Sie die Erkennung erneut aus und prüfen Sie das Ziel. Eine noch nicht gespeicherte manuelle Eingabe kann ebenfalls ersetzt werden, wenn die Erkennung gelingt.
• Wenn Sie das Formular mit nicht gespeicherten Änderungen verlassen, beachten Sie die Rückfrage beim Verlassen.
• In der Liste öffnet das Papierkorbsymbol Delete (Löschen) eine Bestätigung. Prüfen Sie zuerst die Automatisierungen, die den Eintrag verwenden: Rechnen Sie nicht mit einer automatischen Wiederherstellung. Siehe Listen und Bestätigungen.

Ergebnis prüfen

1. Öffnen Sie den Eintrag mit Edit erneut und prüfen Sie Host, Port und Tür (Access) oder Host, Port und Site (Network).
2. Testen Sie dann eine echte Funktion: Success! bestätigt das Speichern, nicht die Annahme eines Befehls durch den Controller. Folgen Sie je nach Produktfamilie den UniFi-Access-Aktionen, den UniFi-Access-Auslösern und KNX-Zuordnungen, den UniFi-Network-Aktionen oder der UniFi-Network-Anwesenheit und den KNX-Zuordnungen.

Fehlerbehebung

Die Türerkennung von UniFi Access zeigt eines der folgenden Ergebnisse an:

Meldung	Bedeutung	Maßnahme
Controller unreachable or invalid token… (Controller nicht erreichbar oder Token ungültig …)	Die Erkennung ist fehlgeschlagen, ohne anzugeben, ob Host, Port, Token oder Netzwerkzugriff die Ursache sind	Prüfen Sie diese vier Elemente von der Installation aus und klicken Sie dann auf Retry (Erneut versuchen). Geben Sie bei Bedarf unter Door ID (manual entry) (Tür-ID, manuelle Eingabe) die in der Access-Konsole bestätigte UUID ein, ohne sie zu erraten
No door on this controller… (Keine Tür auf diesem Controller …)	Der Controller hat mit einer leeren Liste geantwortet: Dieses Ergebnis unterscheidet sich von einem Fehlschlag und deutet nicht auf ein falsches Token hin	Prüfen Sie die Türen in der UniFi-Access-Konsole und klicken Sie dann auf Refresh (Aktualisieren). Dieses Ergebnis öffnet keine manuelle Eingabe; ein neuer Eintrag lässt sich ohne Tür nicht speichern
Not found on the controller (Auf dem Controller nicht gefunden), mit The saved door no longer exists on this controller — pick a detected door or check the Access console. (Die gespeicherte Tür existiert auf diesem Controller nicht mehr)	Die alte Tür wird weiterhin mit ihrer Kennung angezeigt, existiert aber möglicherweise nicht mehr oder ist nicht erreichbar	Prüfen Sie die Konsole und wählen Sie die gewünschte Tür aus, bevor Sie speichern. Eine vorübergehende Nichtverfügbarkeit rechtfertigt nicht, aufs Geratewohl eine andere Tür zu wählen

Bleiben bei UniFi Network Aktionen oder Rückmeldungen nicht verfügbar, prüfen Sie mit dem Installateur Host, Port, Site-Schlüssel und lokales Konto.

Wenn diese Prüfungen bereits erfolgt sind, schreiben Sie an support@can-nx.com und geben Sie den Kontext, die angezeigte Meldung und die durchgeführten Tests an. Verdecken Sie Token, Passwort und private Daten in jedem Screenshot und fügen Sie niemals die Zugangsdaten bei.