---
title: Eine UniFi-Access-Tür oder einen UniFi-Network-Controller anlegen
description: Legen Sie in Link’nX eine UniFi-Access-Tür (Host, Port 12445, API-Token, Türerkennung) oder eine UniFi-Network-Konsole (Site, lokales Konto) an.
canonical: https://wiki.can-nx.com/de/guides/link-unifi-devices/
language: de
product: Link’nX
audience:
  - administrateur
  - installateur
context: "Link’nX Web: Devices, Security & Access oder Smart Home, Eintrag für UniFi Access oder UniFi Network"
---

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

Kontext: Link’nX Web: Devices, Security & Access oder Smart Home, Eintrag für UniFi Access oder UniFi Network

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](https://wiki.can-nx.com/de/guides/link-camera-devices/) 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](https://wiki.can-nx.com/de/guides/link-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](https://wiki.can-nx.com/de/guides/link-lists/).

## 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](https://wiki.can-nx.com/de/guides/link-unifi-access-actions/), den [UniFi-Access-Auslösern und KNX-Zuordnungen](https://wiki.can-nx.com/de/guides/link-unifi-access-events-knx/), den [UniFi-Network-Aktionen](https://wiki.can-nx.com/de/guides/link-unifi-network-actions/) oder der [UniFi-Network-Anwesenheit und den KNX-Zuordnungen](https://wiki.can-nx.com/de/guides/link-unifi-network-presence-knx/).

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