Public Spot Captive Portal API

Ab LCOS 10.90 unterstützt der Public Spot den neuen Standard der Captive Portal API nach RFC 8908. Der Standard erlaubt es WLAN-Clients, in einem Hotspot ein Captive Portal bzw. eine Login-Seite automatisch zu finden.

Der Client erhält per DHCP die URL der Portal-Seite und kann dann per API-Anfrage an den Hotspot prüfen, ob ein Login erforderlich ist oder der Zugriff für den Client schon erlaubt ist. Das beschleunigt die Benutzererfahrung in einem Hotspot deutlich und stellt durch die Definition eines Standards nun eine bessere Herstellerinteroperabilität zwischen Hotspot und Clients her.

Folgende Schritt sind dazu erforderlich:

Die Verwendung von TLS-Zertifikaten im Public Spot ist zwingend erforderlich. Ohne HTTPS-Login stellt der Client an das Portal keine Anfrage.
Der DHCP-Server muss die Captive Portal DHCP-Option an den Client ausliefern.

Die Konfiguration finden sie in LANconfig unter Public-Spot > Server > Captive Portal API (RFC 8908).

Captive Portal API aktiviert: Aktiviert bzw. deaktiviert die Funktion der Captive Portal API im Public Spot.
Benutzerportal-URL: (Optional) Die Captive Portal API unterstützt laut Standard nur die Betriebsart über TLS. Deshalb muss das Gerät über ein vertrauenswürdiges Zertifikat sowie einen DNS-Namen verfügen. Im Default kann der Parameter leer gelassen werden und wird automatisch vom System eingefügt. Dazu muss der Gerätename in den Public Spot Betriebseinstellungen konfiguriert werden und mit dem TLS-Zertifikat übereinstimmen. Wird ein externer Hotspot-Server verwendet, kann auch eine URL des externen Servers eingetragen werden. Als weitere Voraussetzung gilt, dass die Clients im Hotspot das Captive Portal per DHCP-Option finden müssen. Dazu muss die entsprechende DHCP-Option nach RFC 8910 für das Hotspot-Netzwerk konfiguriert werden.
Venue-URL: (Optional) URL (TLS), über die der Betreiber dem Benutzer zusätzliche Informationen über die Lokation des Hotspots bereitstellen kann, z. B. die Webseite des Hotels des Hotspots.

DHCPv4-Option konfigurieren(laut RFC 8910)

Legen Sie in LANconfig einen neuen Tabelleneintrag unter IPv4 > DHCPv4 > DHCP-Optionen an.

Options-Nummer: Nummer der Option, die an die DHCP-Clients übermittelt werden soll. Hier 114.
Netzwerkname: Name des Public Spot-Netzwerks (siehe IPv4-Netzwerke)
Typ: Typ des Eintrags. Hier Zeichenkette.
Wert: HTTPS-URL des LANCOM Routers im Hotspot, z. B. "https://hotspot.org/captive-portal-api". Der DNS-Name, z. B. "hotspot.org", ist der Gerätename des Routers im TLS-Zertifikat ergänzt um den internen Pfad der Public Spot Login-Seite "captive-portal-api". Der DNS-Name muss durch den Hotspot-Clients auflösbar sein. Ebenso muss der Gerätename in den Public Spot-Betriebseinstellungen konfiguriert werden und mit dem TLS-Zertifikat übereinstimmen.

DHCPv6-Option konfigurieren (laut RFC8910)

Legen Sie in LANconfig einen neuen Tabelleneintrag unter IPv6 > DHCPv6 > DHCPv6-Server > Weitere Optionen an.

Interface-Name / Relay-IP: Name des Public Spot Netzwerks (siehe IPv6-Netzwerke)
Optionscode: 103
Optionstyp: String
Optionswert: HTTPS-URL des LANCOM Routers im Hotspot, z. B. "https://hotspot.org/captive-portal-api". Der DNS-Name, z. B. "hotspot.org", ist der Gerätename des Routers im TLS-Zertifikat ergänzt um den internen Pfad der Public Spot Login-Seite "captive-portal-api". Der DNS-Name muss durch den Hotspot-Clients auflösbar sein. Ebenso muss der Gerätename in den Public Spot-Betriebseinstellungen konfiguriert werden und mit dem TLS-Zertifikat übereinstimmen.