Passen Sie das Webauthentifizierungs-Gateway auf dem Catalyst 9800 WLC an (2023)

Einführung

In diesem Dokument wird beschrieben, wie Sie ein benutzerdefiniertes Webauthentifizierungs-Gateway für den Catalyst 9800 Wireless Controller (9800 WLC) erstellen.

Anforderungen

Der Quellcode ist einfach zu bearbeiten und verfügt über ein responsives WEB-Design, das mit modernen Desktop- und mobilen Webbrowsern kompatibel ist.

Anforderungen

Cisco empfiehlt, dass Sie sich mit den folgenden Bereichen vertraut machen:

• HTML und CSS
• Konfigurationshandbuch für WLC 9800

Verwendete Zutaten

Die Informationen in diesem Dokument basieren auf der folgenden Software- und Hardwareversion:

• Cisco Catalyst 9800 Series Wireless Controller, Cisco IOS® XE Gibraltar 16.12.1s

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell konfigurierten Testumgebung. Alle in diesem Dokument verwendeten Geräte starteten mit einer gelöschten (Standard-)Konfiguration. Sobald Ihr Netzwerk betriebsbereit ist, stellen Sie sicher, dass Sie die potenziellen Auswirkungen jeder Aufgabe verstehen.

Portaldateien anpassen

Die folgenden Dateien bilden das benutzerdefinierte Webauthentifizierungs-Gateway:

• login.html
• bootstrap.min.css
• Jquery.min.js
• style.css
• animar.css
• web_auth_logo.png

Nur diese Dateien müssen verarbeitet werden:

• login.html
• style.css
• web_auth_logo.png

Dies ist der Quellcode des Web-Authentifizierungsportals (log in.html).

Eine Anzeige:Bitte lesen Sie den Code sorgfältig durch, er enthält HTML-Kommentare, die den Aufbau des Web-Authentifizierungsportals erläutern.

< title>IHR GESCHÄFTSTITEL HIER


 
 
 
Greifen Sie über Ihr drahtloses Gerät auf das öffentliche Unternehmensnetzwerk zu
Das Unternehmen bietet in bestimmten Bereichen kostenlose Internet-Hotspots für Gäste mit Laptops oder Geräten an, die drahtlose Signale empfangen können. Sie können von Ihrem drahtlosen Gerät aus auf das Internet zugreifen, wenn Sie sich in Reichweite eines Zugangspunkts befinden. Von Gästen wird erwartet, dass sie den WLAN-Zugang auf legale und verantwortungsvolle Weise nutzen. Durch die Nutzung dieses drahtlosen Zugangsnetzwerks erkennen Sie an, dass Sie allen Gesetzen sowie allen für die Internetnutzung geltenden staatlichen und bundesstaatlichen Regeln und Vorschriften unterliegen und diese einhalten.
 
Nutzungsbedingungen
Gäste benötigen einen Laptop/Notebook oder ein anderes Gerät, das mit einer WLAN-Karte ausgestattet ist, die den WLAN-Standard unterstützt. Das Unternehmen übernimmt keine Verantwortung für die Sicherheit der Geräte.
 
 
 
 < h5 class="card-header info-color white-text text-center py-4">Verbindung  
  
   

 Nutzername  

  
 Passwort  

  registrieren 
  
 
 
< /body>

Seitentitel ändern Diesen Abschnitt bearbeiten:

...

...

Um das Firmenlogo zu ändern, bearbeiten Sie das img-Tag und verwenden Sie ein .png- oder .svg-Bild. Ändern Sie die Breiten- und Höhenparameter, um die Größe des Logos anzupassen.

Eine Anzeige:Für eine optimale Optik werden SVG-Bilder mit transparentem Hintergrund empfohlen.

Um die Hintergrundfarbe des Seitentitels zu ändern, erstellen Sie Ihre eigene Klasse in der Datei style.css und ersetzen Sie bg-dark durch Ihre benutzerdefinierte Klasse:

Ändern Sie die bg-Klasse, um die Hintergrund- und Textfarbe der Seite zu ändern:

Dies sind die verfügbaren Klassen. Beachten Sie, dass sich die Hintergrund- und Textfarbe entsprechend ändern:

Wenn Sie ein Bild als Hintergrund oder eine andere Farbe in der Datei style.css verwenden möchten, bearbeiten Sie die CSS-Klasse bg-img und verwenden Sie sie.

Achtung:Aufgrund seiner Größe wird das Hintergrundbild auf Mobilgeräten möglicherweise nicht gut angezeigt und der Text ist aufgrund der Farben im Bild möglicherweise schwer lesbar.

.bg-img{
Hintergrundbild: url("winter.jpg");
Höhe: 100 %;
Hintergrundposition: Mitte;
Hintergrundwiederholung: keine Wiederholung.
Hintergrundformat: Cover;
}

Wenn Sie ein Bild als Hintergrund verwenden, sieht das in etwa wie im folgenden Bild aus:

Die bg5-Klasse sieht wie im folgenden Bild aus:

Die bg6-Klasse sieht wie im folgenden Bild aus:

In diesem Abschnitt können Sie den Inhalt der Seite mit Ihren eigenen Geschäftsbedingungen ändern:

 
Greifen Sie über Ihr drahtloses Gerät auf das öffentliche Unternehmensnetzwerk zu
 
Das Unternehmen bietet in ausgewählten Bereichen kostenlose Internet-Hotspots für Gäste mit Laptops oder Geräten an, die drahtlose Signale empfangen können. Sie können von Ihrem drahtlosen Gerät aus auf das Internet zugreifen, wenn Sie sich in Reichweite eines Zugangspunkts befinden. Von Gästen wird erwartet, dass sie den WLAN-Zugang auf legale und verantwortungsvolle Weise nutzen. Durch die Nutzung dieses drahtlosen Zugangsnetzwerks erkennen Sie an, dass Sie allen Gesetzen sowie allen für die Internetnutzung geltenden staatlichen und bundesstaatlichen Regeln und Vorschriften unterliegen und diese einhalten.
 
 
Nutzungsbedingungen
 
Gäste benötigen einen Laptop/Notebook oder ein anderes Gerät, das mit einer WLAN-Karte ausgestattet ist, die den WLAN-Standard unterstützt. Das Unternehmen übernimmt keine Verantwortung für die Sicherheit der Geräte.
 

Um das Authentifizierungsportal zu vereinheitlichen, können Sie Animationen ohne Komplexität hinzufügen. Bearbeiten Sie den Animationsnamen nach der Animationsklasse. Für dieses Beispiel wurden zwei Animationen verwendet. Schauen Sie sich die unten verfügbaren Animationen ananimar.css:

...
animiertes Einblenden">
...
Ihr Firmenname hier

...

Dies ist das endgültige Aussehen des benutzerdefinierten Webauthentifizierungsportals mit Animationen. Wählen Sie die Registerkarte ausErgebnisum ein konkretes Beispiel zu sehen.

Anregung:Sie können die Hintergrundfarben und Schriftarten ganz einfach nach Ihren Wünschen bearbeiten. Erstellen Sie eine neue Klasse in der Datei style.css und verwenden Sie diese.

Laden Sie das benutzerdefinierte Webauthentifizierungs-Gateway auf den 9800 WLC hoch und konfigurieren Sie es.

Dieser Abschnitt enthält eine Schritt-für-Schritt-Anleitung zur Installation und Konfiguration eines benutzerdefinierten WebAuth-Pakets auf dem Cat 9800.

1. Laden Sie das Wireless LAN Driver Web Authentication Bundle (WLC_WEBAUTH_BUNDLE_1.0.zip) von Cisco.com herunter:
https://software.cisco.com/download/home/286316412/type/282791507/release/16.10.1

Kommentar:Das Paket ist für alle 9800-Controller identisch. Sie können die Datei herunterladen, z.B. B. Laden Sie 9800-40 herunter und verwenden Sie es für den virtuellen 9800-L oder 9800-CL.

2. Um das Paket anzupassen, entpacken Sie es in einen Ordner. Öffnen Sie jede HTML-Datei, die Sie bearbeiten möchten, wie oben beschrieben, und laden Sie auch das Logo hoch. Die Dateinamen sind nicht wichtig, Sie können sie beliebig benennen.

Löschen Sie nach diesem Schritt die Datei log in.tar, da Sie eine neue Datei erstellen müssen.

Wählen Sie alle Dateien aus, klicken Sie mit der rechten Maustaste und wählen Sie 7-Zip (oder ein ähnliches Programm, das Sie installiert haben) ausZusatzArchivierung...

Geben Sie ihm einen Namen und wählen Sie tar als Dateiformat:

3. Navigieren Sie als Nächstes zum WLC 9800

Steuerung > Steuerung > Sichern und Wiederherstellen) Ändern Sie den Archivtyp in „Web Audit Control Package“ und laden Sie nur die benutzerdefinierte TAR-Datei hoch.

Standardmäßig kann der 9800 einen Ordner im Bootflash erstellen. Benennen Sie ihn für die .tar-Datei, wie Sie möchten, und alle Dateien können sich in diesem Ordner befinden:

Wenn Sie HA konfiguriert haben, müssen Sie aufgrund dieses Erweiterungsfehlers Code 17.3 (oder zukünftige Versionen) ausführen:

Cisco Bug-ID CSCvr05309: Kopieren Sie das Webauth-TAR-Paket in den Standby-Boot-Flasher. Auch mit HA-Setup.

Um sowohl HA (aktiv als auch Standby) zu überprüfen, ob eine Datei namens „custom.tar“ hochgeladen wurde.

Boot-Flash 9800-1#show: | Es wurde geändert
9800-1#Standby-Boot-Flash anzeigen: | Es wurde geändert

Kommentar:TManuell hochgeladene Dateien werden nicht mit HA Standby synchronisiert.

Kommentar: Sie benötigen die Datei success.html nicht, damit die benutzerdefinierte Webauthentifizierung funktioniert. Bei Bedarf können Sie eine erstellen und zur TAR-Datei hinzufügen und diese TAR-Datei auf den WLC 9800 hochladen.

4. Bearbeiten Sie die globale Parameterzuordnung von WebAuth und legen Sie eine virtuelle IP-Adresse fest. Das Weglassen der virtuellen IP-Adresse kann dazu führen, dass Bilder auf der Portalseite nicht korrekt angezeigt werden.

Eine Anzeige:Nach der Konfiguration der virtuellen IP-Adresse zeigen drahtlose Clients die Website-Warnung im Browser an, da die virtuelle Controller-Schnittstelle die URL über HTTPS sendet. Es ist nicht vertrauenswürdig, da kein signiertes Zertifikat angehängt ist. Verwenden Sie in diesem Fall das Verfahreneine CSR-AnwendungEkelhafterstellenund installieren Sie ein gültiges Zertifikat.

Nur wenn HTTPS nicht erforderlich ist, können diese beiden Befehle ausgeführt werden, um die URL nur über HTTP zu senden (diese Befehle gibt es nur in Version 17.3.1 und höher):

# Terminal konfigurieren
(config)#parameter-map Typ globales Webauth
(config-params-parameter-map)#Deaktivieren Sie die Webauth-Sicherheit
(config-params-parameter-map)#habilitar webauth-http
( config - params - Parameter - Map ) # Ende
#schreiben

5. Im nächsten Schritt wird eine neue Parametrisierung erstellt. navigieren Sie zu9800 GUI > Sicherheit > Webauthentifizierung > Hinzufügen.

Klicken Sie nach der Erstellung auf den Namen der zu bearbeitenden Parameterzuordnung:

Wählen Sie „Erfolgsfenster deaktivieren“, um die Standard-Erfolgsseite „9800“ anstelle der Erfolgsseite „success.html“ zu deaktivieren. Wenn Sie beides verwenden, werden dem Besucher zwei Erfolgsseiten angezeigt, eine von der standardmäßigen 9800-Erfolgsseite und die andere von der benutzerdefinierten Datei success.html.

Selbst wenn Sie alle Erfolgsseiten deaktivieren (mit „Erfolgsfenster deaktivieren“ und ohne Success.html), sehen mobile Geräte die zugewiesene Erfolgsseite, während Desktop-Computer sie für eine Sekunde sehen und dann verschwinden.

iPhone-Beispiel:

Wenn Sie auf das blaue Symbol neben einer Seite klicken, versucht der 9800, diese zu laden, und Sie können die Seiten wie gezeigt auswählen.

6. Im nächsten Schritt markieren Sie die Parameterzuordnung zu WLAN (Cat9800-GUI > Tags und Profile > WLAN). In diesem Beispiel authentifiziert das WLAN zunächst die Gäste der 9800 lokalen Gastkonten und dann gegenüber der ISE (RADIUS-Server).

Eine Anzeige:In diesem Schritt können AAA-Konfigurationen und vorab validierte ACLs (optional) hinzugefügt werden.

Konfigurationsbeispiel für ISE oder einen anderen RADIUS-Server:

ISE-RADIUS-Serveradresse IPv4 GROUPaaa-Authentifizierung, Webauth-Standard-Lokalgruppe RADIUS-GROUPend

Eine Anzeige:Wie der letzte CLI-Befehl zeigt, erfolgt zuerst die lokale Benutzerauthentifizierung und dann ISE/RADIUS. Sie können die Authentifizierung auf lokale Authentifizierung, ISE/RADIUS-Authentifizierung oder beides beschränken. Beispielsweise wird der Benutzer zuerst lokal auschecken. Wenn es nicht vorhanden ist, wird es mit RADIUS verglichen.

Navigieren Sie zu, um lokale Gastbesucher hinzuzufügenEinstellungen > Sicherheit > Gastbenutzer.

Inspektion

Öffnen Sie auf Ihrem Computer die Datei log in.html mit einem Webbrowser und stellen Sie sicher, dass die Animationen und Inhalte korrekt sind.

das Problem lösen

Stellen Sie sicher, dass sich alle Dateien beim Hochladen auf den WLC 9800 nicht in Unterordnern befinden und dass sie nicht umbenannt wurden.