Captive Portal mit Ihrer UniFi-Konsole verbinden

Damit Captive Portal Gäste autorisieren kann, muss es mit Ihrer UniFi-Konsole kommunizieren. Dafür brauchen Sie drei Dinge: einen API-Schlüssel, eine Portweiterleitung zur Konsole und die Standortdaten im Dashboard.

1. API-Schlüssel in UniFi Network erstellen

1. Öffnen Sie in UniFi Network in der Seitenleiste Integrations.

2. Klicken Sie auf Create New API Key.

3. Vergeben Sie einen eindeutigen Namen, zum Beispiel captive-portal, und wählen Sie bei Expiry die Option Never Expires.

4. Klicken Sie auf Create und kopieren Sie den Schlüssel: Sie brauchen ihn gleich im Captive-Portal-Dashboard.

UniFi Network → Integrations → Create New API Key

2. Portweiterleitung zur Konsole einrichten

Unser Server erreicht die Konsole über HTTPS. Richten Sie auf dem Router oder der Firewall des Standorts eine Portweiterleitung ein:

3. Standort in Captive Portal verbinden

1. Öffnen Sie im Dashboard Standorte und wählen Sie den Standort oder legen Sie einen neuen an.

2. Stellen Sie im Bereich UniFi-Controller den Modus auf Echtes UniFi.

3. Geben Sie bei Host / IP die öffentliche Adresse des Standorts mit dem externen Port ein, zum Beispiel https://203.0.113.10:20443.

4. Fügen Sie bei API-Schlüssel den in UniFi erstellten Schlüssel ein.

5. Wenn die Konsole ihr eigenes selbstsigniertes Zertifikat verwendet (der Normalfall bei einer IP-Adresse), deaktivieren Sie TLS-Zertifikat prüfen.

6. Klicken Sie auf Speichern.

Der Bereich UniFi-Controller des Standorts

Test ausführen und Site wählen

1. Klicken Sie im Feld Verbindungstest auf Test ausführen.

2. Wenn die Verbindung klappt, sehen Sie die Liste der UniFi-Sites der Konsole: Klicken Sie auf die richtige, um das Feld Site auszufüllen.

3. Lassen Sie bei UniFi-Site-Name (URL) den Wert default, außer Ihre UniFi-Site hat einen anderen Kurznamen.

4. Klicken Sie auf Speichern.

Wenn der Test fehlschlägt

Sobald der Test klappt, richten Sie den Hotspot ein: UniFi-Hotspot für Captive Portal einrichten.