---
title: "2N-Türsprechanlage in Link’nX anlegen: HTTP-API-Konto und XML-Import"
description: "Legen Sie eine 2N-Türsprechanlage in Link’nX an: IPv4-Adresse, HTTP-API-Konto, Authentifizierung None, Basic oder Digest und XML-Import."
canonical: https://wiki.can-nx.com/de/guides/link-2n-device/
language: de
product: Link’nX
audience:
  - administrateur
  - installateur
context: "Link’nX Web: Geräte unter Security & Access, Anlage einer 2N-Türsprechanlage"
---

# 2N-Türsprechanlage in Link’nX anlegen: HTTP-API-Konto und XML-Import

Kontext: Link’nX Web: Geräte unter Security & Access, Anlage einer 2N-Türsprechanlage

Legen Sie eine 2N-Türsprechanlage in Link’nX mit ihrer IPv4-Adresse, einem HTTP-API-Konto und den Authentifizierungsmethoden ihrer Switch- und Logging-API an. Der Import ihrer XML-Konfiguration füllt die Anlage vor und liefert die Benutzerliste, die die [2N-Aktionen und -Auslöser](https://wiki.can-nx.com/de/guides/link-2n-automation/) verwenden.

Für den berechtigten Installateur oder Administrator.

## Bevor Sie beginnen

- Die IPv4-Adresse der Türsprechanlage und der Zugang zu ihrer Weboberfläche.
- Das auf dieser Türsprechanlage vorgesehene HTTP-API-Konto und sein Passwort.
- Die in der Türsprechanlage konfigurierten Authentifizierungsmethoden für die Schaltfunktion und für die Protokollierung der Ereignisse.
- Um die Anlage vorauszufüllen, die aus dieser Türsprechanlage exportierte XML-Konfiguration.

## Die 2N-Türsprechanlage vorbereiten

Link’nX steuert die Türsprechanlage und empfängt ihre Ereignisse über die HTTP-API von 2N. Geben Sie die IP-Adresse der Türsprechanlage in einen Browser ein, melden Sie sich an ihrer Weboberfläche an und öffnen Sie dann **Services → HTTP API** (Dienste → HTTP-API). Die genannten Bezeichnungen sind die der englischen 2N-Oberfläche.

1. Aktivieren Sie in der Registerkarte **Services** das Kontrollkästchen **Enable** (Aktivieren) für **Switch API**, mit der Link’nX die Schalter steuert, und für **Logging API**, die ihm die Ereignisse übermittelt: eingegebener Code, Anruf, Türöffnung usw.
2. Notieren Sie für jeden dieser beiden Dienste die unter **Authentication** (Authentifizierung) gewählte Methode: **None** (keine), **Basic** oder **Digest**. Die Anlage in Link’nX muss für jeden Dienst dieselbe Methode angeben; andernfalls kann Link’nX nicht mit der Türsprechanlage kommunizieren.

   ![2N-Weboberfläche, Services und dann HTTP API: Switch API und Logging API angehakt, mit ihrer Authentifizierungsmethode](https://wiki.can-nx.com/media/en/link-2n/services-api-http.webp)

3. Aktivieren Sie in einer Registerkarte **Account** (Konto) das Kontrollkästchen **Account Enabled** (Konto aktiviert), füllen Sie unter **User Settings** (Benutzereinstellungen) **Username** (Benutzername) und **Password** (Passwort) aus und haken Sie dann unter **User Privileges** (Benutzerrechte) die Rechte der Funktionen an, die Link’nX nutzt. Dieses Konto geben Sie anschließend in Link’nX an.

   ![2N-Weboberfläche, Registerkarte Account 1: Konto aktiviert, Zugangsdaten eingetragen und Rechte in den Spalten Monitoring und Control angehakt](https://wiki.can-nx.com/media/en/link-2n/compte-api-http.webp)

4. Um die Anlage vorauszufüllen, exportieren Sie die Konfiguration der Türsprechanlage über **System → Maintenance → Back Up configuration** (System → Wartung → Konfiguration sichern). Die erhaltene XML-Datei wird in das Link’nX-Formular importiert.

## Formular zum Anlegen öffnen

1. Prüfen Sie in Link’nX das Projekt und das Gateway. Öffnen Sie **Devices → Security & Access → 2N** (Geräte → Sicherheit & Zutritt → 2N) oder suchen Sie in **Search a device...** (Gerät suchen...) nach **2N**. Auf dem Mobilgerät öffnen Sie zuerst das Menü mit den drei Strichen. Die [Anleitung zur Navigation](https://wiki.can-nx.com/de/guides/link-navigation/) behandelt fehlende oder gesperrte Karten.
2. Klicken Sie auf **Add** (Hinzufügen). Der Bildschirm **2N Declaration** (Anlage einer 2N-Anlage) öffnet sich.
3. Wenn Sie die XML-Konfiguration haben, importieren Sie sie zuerst und vervollständigen Sie dann die Felder. Andernfalls füllen Sie die Verbindung direkt aus.

## XML-Konfiguration importieren

1. Klicken Sie unten im Formular auf **Import configuration** (Konfiguration importieren) und wählen Sie dann die **.xml**-Datei der betreffenden Türsprechanlage aus.
2. Prüfen Sie den angezeigten Dateinamen und dann **Name**, **IP address** (IP-Adresse) und die beiden Authentifizierungsmethoden. Der Import kann bereits eingegebene Werte ersetzen, auch einen eigenen Namen.
3. Prüfen Sie **Username** (Benutzername) oder wählen Sie ihn aus den verfügbaren Vorschlägen aus und füllen Sie dann **Password** (Passwort) aus: Die Datei allein füllt nicht alle Pflichtfelder aus.
4. Speichern Sie die Anlage mit dem Diskettensymbol, sobald die Verbindung vollständig ist (nächster Abschnitt). Eine importierte Datei wird ohne Speichern nicht in Link’nX übernommen.

Die aus der Datei übernommenen Benutzer werden anschließend in den Filtern der [2N-Ereignisse](https://wiki.can-nx.com/de/guides/link-2n-automation/) dieses Geräts angeboten. Der Import bereitet die Anlage in Link’nX vor; er ist kein Verfahren zur Wiederherstellung der 2N-Türsprechanlage. Die Datei kann Namen und Zugangsdaten enthalten: Importieren Sie sie nur in diesem Formular.

## Verbindung ausfüllen und speichern

| Feld | Erwartete Eingabe |
| --- | --- |
| **Name** | Name, unter dem Sie die Türsprechanlage wiederfinden; erforderlich und auf 64 Zeichen begrenzt. Fiktives Beispiel: „Empfang 2N“. |
| **IP address** | Tatsächliche IPv4-Adresse der Türsprechanlage. Eine leere oder fehlerhafte Adresse verhindert das Speichern; das Beispiel im Feld ist nicht die Adresse Ihrer Installation. |
| **Username** | Auf dieser Türsprechanlage vorgesehenes HTTP-API-Konto. Nach dem Import der Konfiguration können Vorschläge erscheinen. |
| **Password** | Passwort dieses Kontos; geben Sie es nur in der Oberfläche ein. |
| **Switch API authentication method** (Authentifizierungsmethode der Switch-API) | **None** (keine), **Basic** oder **Digest**, je nachdem, wie diese Funktion in der Türsprechanlage konfiguriert ist. |
| **Logging API authentication method** (Authentifizierungsmethode der Logging-API) | **None**, **Basic** oder **Digest**, je nachdem, wie der Empfang der Ereignisse konfiguriert ist. Diese Einstellung ist von der vorherigen getrennt. |

Alle diese Felder sind erforderlich. Wählen Sie nicht **None**, um einen Authentifizierungsfehler zu umgehen; lassen Sie den vorgesehenen Modus bestätigen, wenn Sie ihn nicht kennen.

Klicken Sie anschließend auf das **Diskettensymbol unten rechts** und warten Sie auf **Success!** (Erfolg!) und die Rückkehr zur Liste.

## Ergebnis prüfen

1. Suchen Sie die Zeile anhand von **Name**, **IP address** und **Username** und klicken Sie dann auf ihr Stiftsymbol **Edit** (Bearbeiten).
2. Prüfen Sie in **2N Modification** (Bearbeitung der 2N-Anlage) die gespeicherten Einstellungen.
3. Testen Sie die Türsprechanlage anschließend mit den [2N-Aktionen und -Auslösern](https://wiki.can-nx.com/de/guides/link-2n-automation/): Ein Schaltbefehl prüft die Antwort der Türsprechanlage und die Switch-API, ein empfangenes Ereignis prüft die Logging-API. Testen Sie beides, denn jede API hat ihre eigene Authentifizierung.

## Anlage bearbeiten oder löschen

- Wenn Sie **Password** ändern, erscheint das Feld **Confirm password** (Passwort bestätigen): Geben Sie in beiden Feldern denselben neuen Wert ein. **Passwords do not match** (Passwörter stimmen nicht überein) fordert Sie auf, diese Bestätigung zu korrigieren. Speichern Sie mit dem Diskettensymbol, warten Sie auf **Updated!** (Aktualisiert!) und prüfen Sie dann die Anlage.
- Um eine Änderung zu verwerfen, verlassen Sie das Formular; in **Unsaved changes** (nicht gespeicherte Änderungen) bleibt **Cancel** (Abbrechen) auf der Seite und **Don't save** (Nicht speichern) verwirft die Änderungen.
- Bevor Sie die Anlage löschen, lassen Sie die Aktionen und Szenarien prüfen, die sie verwenden. Sind die Folgen unklar, wenden Sie sich vor dem Löschen an den Support.

## Fehlerbehebung

- Das Diskettensymbol bleibt ausgegraut: Prüfen Sie die Pflichtfelder, das IPv4-Format und nach einer Passwortänderung dessen Bestätigung. Prüfen Sie die beiden Authentifizierungsmethoden getrennt.
- Die Datei ist ausgewählt, aber erwartete Werte oder Benutzer fehlen: Prüfen Sie, ob es der richtige Export und die richtige Türsprechanlage ist, und dann die tatsächlich ausgefüllten Felder. Dateiname und Konfigurationssymbol zeigen einen Import an, nicht die Übernahme aller Daten. Ändern Sie die XML-Datei nicht auf gut Glück.
- Weder Befehle noch Ereignisse: Prüfen Sie in der 2N-Oberfläche, ob **Switch API** und **Logging API** angehakt sind, ob ihre Authentifizierungsmethode der in der Anlage entspricht und ob das Konto mit den nötigen Rechten aktiviert ist.
- Befehle funktionieren, Ereignisse aber nicht: Prüfen Sie **Logging API** in der Türsprechanlage und dann die **Logging API authentication method** und die [Filter des Auslösers](https://wiki.can-nx.com/de/guides/link-2n-automation/).

## Support kontaktieren

Besteht das Problem nach diesen Prüfungen weiter, schreiben Sie an support@can-nx.com und nennen Sie das Modell der Türsprechanlage, Projekt und Gateway, das Ziel, das angezeigte Ergebnis und die durchgeführten Schritte. Hängen Sie keine Datei mit sensiblen Daten an und übermitteln Sie niemals das Passwort.

Französische Bezeichnungen: **2N → Ajouter → Déclaration d'un 2N**, **Nom**, **Adresse IP**, **Nom utilisateur**, **Mot de passe**, **Méthode d'authentification de l'API d'interrupteur**, **Méthode d'authentification de l'API d'enregistrement**, **Importer une configuration**, dann **Modification du 2N**, **Éditer** und **Confirmer le mot de passe**.