Development

HTTP-Tests gegen das ISE-Modul unter /api/ise/… und optional Cortex XDR XQL unter /api/cortex/…. ISE: GET /api/ise/endpoints/search — MAC (mac=… / q=…, entspricht ERS filter=mac.EQ.… wie in Retool) oder Hostname-Teilstring (hostname=…). Antwort mit strategy, results[].summary / detail: Tabelle + JSON darunter. Klassische Listen: /api/ise/endpoints?… mit SearchResult. Mit ?autorun=1 oder ?ise=xlab startet die Hostname-Suche „xlab“ automatisch.

Hinweis: Wenn auf dem Server ISE_MODULE_API_KEY gesetzt ist, Header X-ISE-Module-Key unten eintragen (wird nur im Browser gespeichert, wenn gewünscht). Keine Produktionsgeheimnisse weitergeben.

Wichtig: Basis-URL unten leer lassen oder nur https://nw.hs-anhalt.de — der Browser spricht unser spl-ise-api unter /api/ise/ an. Nicht die Cisco-ISE-Adresse (kt-ise-admin…) eintragen; sonst schlägt der Aufruf fehl (Failed to fetch / CORS).

Schnelltests · ISE-API

Voraussetzung: Proxy /api/ise/ → spl-ise-api (siehe spl-proxy) und laufender Container auf spl-portal. Erster Button: gleiche MAC-Logik wie direkter ERS-Aufruf …/endpoint?filter=mac.EQ.… (Referenz Retool).

Cortex XDR · Endpoints-Snapshot

Ruft GET /api/cortex/endpoints mit limit=10000, persist=true und fields=endpoint_id, endpoint_name, endpoint_status, operational_status, mac_address, network_interface auf (XQL dataset = endpoints | fields …) und schreibt bei gesetztem DATABASE_URL in public.cortex_endpoints_latest. Nutzt dieselbe Basis-URL wie der ISE-Block unten (leer = aktuelle Seite / nw.hs-anhalt.de).

Hinweis: Auf dem Server muss spl-cortex-xql-api laufen (Docker :8012, Proxy /api/cortex/). Wenn CORTEX_XQL_MODULE_API_KEY gesetzt ist, hier X-Cortex-XQL-Module-Key eintragen.

X-Cortex-XQL-Module-Key (optional)

Modul-Key im Browser speichern (localStorage)

Anfrage

Basis-URL (optional)

Empfohlen: leer. Nur https://nw.hs-anhalt.de, wenn Sie die Seite nicht unter dieser Domain öffnen. Niemals kt-ise-admin… — ISE wird nur serverseitig vom Modul angesprochen.

Methode

Pfad inkl. Query

Body (nur POST)

Content-Type (POST)

X-ISE-Module-Key (optional)

Modul-Key im Browser speichern (localStorage)

ISE-Trace: vollständigen Request/Response (spl-ise-api → Cisco ISE) anzeigen — setzt trace=1 (benötigt ISE_ENABLE_TRACE=true auf dem Server)

ISE · Endpoint-Group Bulk-Assignment

Pro MAC wird per GET /api/ise/endpoints/search?mac=… der Endpoint gesucht und danach groupId gesetzt. Static Group Assignment wird dabei immer aktiviert.

Endpoint Group (aus ISE)

Nutzt dieselbe Basis-URL und denselben X-ISE-Module-Key wie oben.

MAC-Adressen (eine pro Zeile)

Trennzeichen egal (Doppelpunkte, Bindestriche, Punkte). Ungültige Zeilen werden übersprungen.

Ausgabe

Rohdaten (JSON/XML) anzeigen

Response-Header