• Link zu Youtube
  • Link zu Mail
  • ÜBER MICH
  • ARCHIV
www.vguru.de
  • Training
  • Blog
  • Klicken, um das Suchfeld zu öffnen Klicken, um das Suchfeld zu öffnen Suche
  • Menü Menü

NITRO-Anmeldung an NetScaler und Console: die zwei Unterschiede

18. November 2026/0 Kommentare/von Lars

NITRO ist die REST-Schnittstelle der NetScaler und der NetScaler Console. Die Anmeldung sieht an beiden gleich aus: derselbe Pfad /nitro/v1/config/login, dasselbe JSON mit Benutzername und Kennwort. Eine Anmeldefunktion, die an der einen Seite funktioniert, scheitert an der anderen trotzdem sofort. Es sind genau zwei Unterschiede: wie der Body aussieht und wo das Sitzungstoken zurückkommt. Beide habe ich an meiner Testinstanz gemessen, NetScaler 14.1 und NetScaler Console 14.1.

Unterschied 1: der Body der NITRO-Anmeldung

ZielBodyAntwort bei Erfolg
NetScalerreines JSON: {"login":{...}}HTTP 201
NetScaler Console (früher ADM)object= vor dem JSON: object={"login":{...}}HTTP 200

Der Content-Type ist in beiden Fällen application/json. Die jeweils andere Form beantworten beide Seiten mit einer eindeutigen Meldung im Body:

NetScaler mit object=:   HTTP 400  {"errorcode": -1, "message": "Invalid payload format. Default format is json"}
Console ohne object=:    HTTP 400  {"errorcode": 10008, "message": "Invalid POST request, payload should start with object="}

Die Regel gilt für jeden Body, nicht nur für die Anmeldung. Auch die Abmeldung an der Console erwartet object={"logout":{}}.

Unterschied 2: wo das Sitzungstoken zurückkommt

Nach der Anmeldung braucht jede weitere Anfrage das Token. Beide Seiten liefern es, aber an anderer Stelle und unter anderem Namen:

NetScaler 14.1NetScaler Console 14.1
Token im Antwort-Bodysessionidlogin[0].sessionid
Cookie in der Antwortsessionid, Pfad /nitro/v1SESSID, Pfad /, HttpOnly, Secure
Cookie NITRO_AUTH_TOKEN=<token> von Hand gesetztangenommenangenommen

Die NITRO-Dokumentation beschreibt als Antwort Set-Cookie: NITRO_AUTH_TOKEN=<token>; path=/nitro/v1. Meine Testinstanz setzt das Cookie unter dem Namen sessionid, nimmt NITRO_AUTH_TOKEN in Anfragen aber an. Für PowerShell spielt der Name keine Rolle: -SessionVariable übernimmt jedes Cookie, das der Server setzt, und schickt es bei -WebSession wieder mit.

Für ein Skript heißt das: den Body je Ziel wählen und das Cookie von -SessionVariable verwalten lassen. Den Cookienamen muss es dann nicht kennen.

Beide Anmeldungen in PowerShell

Der folgende Ablauf läuft unverändert in Windows PowerShell 5.1 und PowerShell 7. Der Benutzername geht ohne Domänenanteil an NITRO, deshalb Split('\')[-1].

$cred  = Get-Credential
$login = @{ login = @{
    username = $cred.UserName.Split('\')[-1]
    password = $cred.GetNetworkCredential().Password
} } | ConvertTo-Json -Compress

# NetScaler: reines JSON
$adc = Invoke-RestMethod -Method Post -Uri 'https://netscaler.example.local/nitro/v1/config/login' `
    -Body $login -ContentType 'application/json' -SessionVariable adcSitzung

# Console: object= vor dem JSON
$con = Invoke-RestMethod -Method Post -Uri 'https://console.example.local/nitro/v1/config/login' `
    -Body "object=$login" -ContentType 'application/json' -SessionVariable conSitzung

Was dabei zurückkommt, zeigt dieser Vergleich:

'NetScaler: Token unter .sessionid = {0}, Cookie {1}' -f [bool]$adc.sessionid,
    ($adcSitzung.Cookies.GetCookies([uri]'https://netscaler.example.local/nitro/v1/') | ForEach-Object { "$($_.Name) (Pfad $($_.Path))" })
'Console:   Token unter .login[0].sessionid = {0}, Cookie {1}' -f [bool]$con.login[0].sessionid,
    ($conSitzung.Cookies.GetCookies([uri]'https://console.example.local/nitro/v1/') | ForEach-Object { "$($_.Name) (Pfad $($_.Path))" })
NetScaler: Token unter .sessionid = True, Cookie sessionid (Pfad /nitro/v1)
Console:   Token unter .login[0].sessionid = True, Cookie SESSID (Pfad /)

Ab hier sind beide Seiten gleich zu bedienen:

(Invoke-RestMethod -Uri 'https://netscaler.example.local/nitro/v1/config/nsversion' -WebSession $adcSitzung).nsversion.version.Split(':')[0]
(Invoke-RestMethod -Uri 'https://console.example.local/nitro/v1/config/mps' -WebSession $conSitzung).message
NetScaler NS14.1
Done

Für Werkzeuge außerhalb von PowerShell reicht das Token aus dem Body als Cookie NITRO_AUTH_TOKEN:

$token = $adc.sessionid
curl.exe -s -H "Cookie: NITRO_AUTH_TOKEN=$token" https://netscaler.example.local/nitro/v1/config/nsversion

Ohne Sitzung: Anmeldung im Header

Für einzelne Abfragen geht es auch ohne Anmeldung vorab. NITRO nimmt Benutzername und Kennwort in den Headern X-NITRO-USER und X-NITRO-PASS an, das Kennwort geht dann mit jeder Anfrage über die Leitung. An meiner Testinstanz funktionierte das an NetScaler und Console gleichermaßen:

$kopf = @{
    'X-NITRO-USER' = $cred.UserName.Split('\')[-1]
    'X-NITRO-PASS' = $cred.GetNetworkCredential().Password
}
(Invoke-RestMethod -Uri 'https://netscaler.example.local/nitro/v1/config/nsversion' -Headers $kopf).nsversion.version.Split(':')[0]

Eine Grenze gibt es: Über den API-Proxy der Console geht das nicht. Dort kam mit Header-Anmeldung und Proxy-Header HTTP 401 mit Invalid Session ID in APIProxy request. Der Proxy braucht die Sitzung.

Über die Console zur Instanz: der Proxy-Header

Die Console reicht NITRO-Anfragen an verwaltete Instanzen weiter, wenn ein Header die Instanz benennt. Dessen Schreibweise hat sich zwischen den Releases geändert; die Einzelheiten und die Fehlerbilder stehen im Beitrag Instanz nicht verfügbar beim ADM-Proxy. An meiner Testinstanz mit Console 14.1 Build 72.57 und nach dem Update auf 74.34 ergab sich, jeweils in einer frischen Sitzung:

HeaderErgebnis
MPS-API-PROXY-MANAGED-INSTANCE-IPAntwort der Instanz
_MPS_API_PROXY_MANAGED_INSTANCE_IP alleinHTTP 200 mit errorcode 10005, Invalid Resource im Body
beide zusammenAntwort der Instanz

Der Fehler kommt hier mit HTTP 200. Invoke-RestMethod löst dabei keine Ausnahme aus; erkennbar ist er nur am errorcode im Body.

Beim Proxy in PowerShell ist eine Eigenheit zu beachten: Header, die zusammen mit -WebSession übergeben werden, speichert PowerShell im Sitzungsobjekt und schickt sie bei jeder weiteren Anfrage mit. Ohne Gegenmaßnahme landen danach auch Anfragen, die an die Console selbst gehen sollen, bei der Instanz. Deshalb die Proxy-Header nach dem Aufruf wieder entfernen:

$proxy = @{
    'MPS-API-PROXY-MANAGED-INSTANCE-IP'  = '192.0.2.10'   # NSIP der verwalteten Instanz
    '_MPS_API_PROXY_MANAGED_INSTANCE_IP' = '192.0.2.10'
}
(Invoke-RestMethod -Uri 'https://console.example.local/nitro/v1/config/nsversion' `
    -WebSession $conSitzung -Headers $proxy).nsversion.version.Split(':')[0]

# Die Header bleiben im Sitzungsobjekt haengen: vor dem naechsten Konsolenaufruf entfernen
foreach ($name in @($proxy.Keys)) { $null = $conSitzung.Headers.Remove($name) }

Abmelden

Auch die Abmeldung folgt Unterschied 1. Beide Seiten nehmen POST auf /nitro/v1/config/logout an, die Console wieder mit object=:

$null = Invoke-RestMethod -Method Post -Uri 'https://netscaler.example.local/nitro/v1/config/logout' `
    -Body '{"logout":{}}' -ContentType 'application/json' -WebSession $adcSitzung
$null = Invoke-RestMethod -Method Post -Uri 'https://console.example.local/nitro/v1/config/logout' `
    -Body 'object={"logout":{}}' -ContentType 'application/json' -WebSession $conSitzung
'abgemeldet'

An der Console beendet nur das Cookie SESSID die Sitzung, und genau das schickt -WebSession mit. Mit dem Cookie NITRO_AUTH_TOKEN antwortet die Console auf die Abmeldung mit HTTP 400 und Invalid Request, die Sitzung bleibt dann gültig. Abfragen nimmt sie mit NITRO_AUTH_TOKEN dagegen an. Gemessen an Console 14.1 Build 72.57 und 74.34.

Alle Beispiele verbinden sich über HTTPS mit dem vollständigen Namen und regulärer Zertifikatsprüfung. Kommt dabei „Verbindung abgelehnt“ statt einer Antwort, liegt es am Port und nicht an der Anmeldung; wie sich das eingrenzen lässt, zeigt der Beitrag Verbindung abgelehnt heißt falscher Port, nicht Zertifikat.

Was du dir merkst

NetScaler will reines JSON, die Console object= davor. Das Token steht beim NetScaler unter sessionid, bei der Console unter login[0].sessionid.

Mit -SessionVariable und -WebSession ist der Cookiename egal. Header-Anmeldung reicht für Einzelabfragen, der Proxy der Console braucht eine Sitzung, und Proxy-Header gehören nach dem Aufruf wieder aus dem Sitzungsobjekt.

Quellen

  • Performing Basic NetScaler Operations, NITRO-API-Referenz 14.1: Anmeldung, NITRO_AUTH_TOKEN, X-NITRO-USER/X-NITRO-PASS, Abmeldung
  • NetScaler Console als API-Proxy-Server, Citrix-Dokumentation: Proxy-Header
Eintrag teilen
  • Teilen auf Facebook
  • Teilen auf X
  • Teilen auf LinkedIn
  • Per E-Mail teilen
https://www.vguru.de/wp-content/uploads/2014/08/vguru03.png 0 0 Lars https://www.vguru.de/wp-content/uploads/2014/08/vguru03.png Lars2026-11-18 07:30:002026-11-12 22:33:52NITRO-Anmeldung an NetScaler und Console: die zwei Unterschiede
Das könnte Dich auch interessieren
GSLB-Failover: warum Clients länger am alten Standort bleiben
Instanz nicht verfügbar beim ADM-Proxy
NetScaler CVE-2026-120868 und 27 weitere Lücken: Update und Vorbedingungen prüfen
Citrix CloudBridge und Netscaler – LOM Setup
Windows-Update September 2026: RDS hängt, „Citrix bleibt schwarz“
NetScaler CVE-2026-88779: SAML-Konfiguration prüfen
0 Kommentare

Hinterlasse einen Kommentar

An der Diskussion beteiligen?
Hinterlasse uns deinen Kommentar!

Schreibe einen Kommentar Antwort abbrechen

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

Search Search

Neueste Beiträge

  • Content Switching Policy Label: was sich gegenüber der direkten Bindung ändert
  • NITRO-Anmeldung an NetScaler und Console: die zwei Unterschiede
  • NetScaler NSHELP-44985: Absturz bei Backend-TLS 1.3, behoben in 14.1-73.58
  • NetScaler Console CVE-2026-120869: Update auf 14.1-74.34 per CLI
  • NetScaler CVE-2026-120868 und 27 weitere Lücken: Update und Vorbedingungen prüfen

NetScaler-Sicherheitsstand

Aktuelle Citrix-Sicherheitsbulletins für NetScaler mit betroffenen Versionen und Zielbuilds: zur Übersicht

Copyright - www.vguru.de
  • Link zu Youtube
  • Link zu Mail
  • Impressum
  • Datenschutzerklärung
  • Kontakt
  • Cookie-Richtlinie (EU)
Link zu: NetScaler NSHELP-44985: Absturz bei Backend-TLS 1.3, behoben in 14.1-73.58 Link zu: NetScaler NSHELP-44985: Absturz bei Backend-TLS 1.3, behoben in 14.1-73.58 NetScaler NSHELP-44985: Absturz bei Backend-TLS 1.3, behoben in 14.1-73.58 Link zu: Content Switching Policy Label: was sich gegenüber der direkten Bindung ändert Link zu: Content Switching Policy Label: was sich gegenüber der direkten Bindung ändert Content Switching Policy Label: was sich gegenüber der direkten Bindung ä...
Nach oben scrollen Nach oben scrollen Nach oben scrollen
Mitgliederbereich mit DigiMember
Einwilligung verwalten
Um dir ein optimales Erlebnis zu bieten, verwenden wir Technologien wie Cookies, um Geräteinformationen zu speichern und/oder darauf zuzugreifen. Wenn du diesen Technologien zustimmst, können wir Daten wie das Surfverhalten oder eindeutige IDs auf dieser Website verarbeiten. Wenn du deine Einwilligung nicht erteilst oder zurückziehst, können bestimmte Merkmale und Funktionen beeinträchtigt werden.
Funktional Immer aktiv
Die technische Speicherung oder der Zugang ist unbedingt erforderlich für den rechtmäßigen Zweck, die Nutzung eines bestimmten Dienstes zu ermöglichen, der vom Teilnehmer oder Nutzer ausdrücklich gewünscht wird, oder für den alleinigen Zweck, die Übertragung einer Nachricht über ein elektronisches Kommunikationsnetz durchzuführen.
Präferenzen
Die technische Speicherung oder der Zugriff ist für den rechtmäßigen Zweck der Speicherung von Präferenzen erforderlich, die nicht vom Abonnenten oder Benutzer angefordert wurden.
Statistiken
Die technische Speicherung oder der Zugriff, der ausschließlich zu statistischen Zwecken erfolgt. Die technische Speicherung oder der Zugriff, der ausschließlich zu anonymen statistischen Zwecken verwendet wird. Ohne eine Vorladung, die freiwillige Zustimmung deines Internetdienstanbieters oder zusätzliche Aufzeichnungen von Dritten können die zu diesem Zweck gespeicherten oder abgerufenen Informationen allein in der Regel nicht dazu verwendet werden, dich zu identifizieren.
Marketing
Die technische Speicherung oder der Zugriff ist erforderlich, um Nutzerprofile zu erstellen, um Werbung zu versenden oder um den Nutzer auf einer Website oder über mehrere Websites hinweg zu ähnlichen Marketingzwecken zu verfolgen.
  • Optionen verwalten
  • Dienste verwalten
  • Verwalten von {vendor_count}-Lieferanten
  • Lese mehr über diese Zwecke
Einstellungen ansehen
  • {title}
  • {title}
  • {title}