• 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ü

Content Switching Policy Label: was sich gegenüber der direkten Bindung ändert

19. November 2026/0 Kommentare/von Lars

Ein CS-vServer (Content Switching) nimmt die Anfrage des Clients an und entscheidet über Policies, welcher LB-vServer sie bekommt. Das Ziel kann direkt an der Bindung stehen, in einer CS-Action oder eine Ebene tiefer in einem Content Switching Policy Label. Die ersten beiden Wege arbeiten in einer Ebene, das Label baut eine zweite. An meiner Testinstanz mit NetScaler 14.1 habe ich beide Bauweisen mit denselben Zielen nebeneinander aufgebaut und mit echten Anfragen verglichen. Das Ergebnis ist bis auf einen Fall gleich, und dieser Fall bestimmt, wie man ein Label baut.

Die Bausteine

BegriffAufgabe
CS-vServerdie Adresse, die der Client anspricht; wertet die Anfrage aus und wählt ein Ziel
LB-vSerververteilt die Anfragen auf die Server; hinter einem CS-vServer meist ohne eigene IP (0.0.0.0, Port 0), damit er nur über den CS-vServer erreichbar ist
CS-Policyeine Bedingung, zum Beispiel Hostname oder Pfad
CS-Actionoptional: das Ziel als eigenes Objekt
Policy Labeleine benannte Liste von CS-Policies mit eigener Reihenfolge, die von einer Policy am CS-vServer aufgerufen wird
PrioritätReihenfolge der Prüfung, die kleinere Zahl zuerst; die erste passende Policy bestimmt das Ziel
Standardzielder LB-vServer für alle Anfragen, auf die keine Policy passt

Das Beispiel

Ein Hostname app.example.test mit zwei Bereichen: Alles unter /a geht an lb_app_a, alles unter /b an lb_app_b, der Rest dieses Hosts an lb_app_rest. Jeder andere Hostname landet beim Standardziel lb_default. Die vier LB-vServer sind in beiden Bauweisen dieselben und haben keine eigene IP:

add lb vserver lb_app_a HTTP 0.0.0.0 0
add lb vserver lb_app_b HTTP 0.0.0.0 0
add lb vserver lb_app_rest HTTP 0.0.0.0 0
add lb vserver lb_default HTTP 0.0.0.0 0

Ohne Label: alle Regeln in einer Ebene

Jede Policy trägt alle Bedingungen selbst, also auch den Hostnamen:

add cs vserver cs_flach HTTP 198.51.100.10 80
add cs policy pol_app_a -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\") && HTTP.REQ.URL.PATH.STARTSWITH(\"/a\")"
add cs policy pol_app_b -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\") && HTTP.REQ.URL.PATH.STARTSWITH(\"/b\")"
add cs policy pol_app_rest -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\")"
bind cs vserver cs_flach -policyName pol_app_a -targetLBVserver lb_app_a -priority 100
bind cs vserver cs_flach -policyName pol_app_b -targetLBVserver lb_app_b -priority 200
bind cs vserver cs_flach -policyName pol_app_rest -targetLBVserver lb_app_rest -priority 300
bind cs vserver cs_flach -lbvserver lb_default
cs_flach
 ├─ 100  Host app.example.test und Pfad /a   ->  lb_app_a
 ├─ 200  Host app.example.test und Pfad /b   ->  lb_app_b
 ├─ 300  Host app.example.test               ->  lb_app_rest
 └─ Standardziel                             ->  lb_default

Mit Label: der Host am CS-vServer, die Pfade im Label

Die Policy am CS-vServer prüft nur noch den Hostnamen und hat kein Ziel. Sie ruft mit -invoke das Label auf, und erst dort stehen die Pfadregeln mit ihren Zielen. Die Rest-Regel ist so übernommen, wie man sie aus der flachen Fassung übertragen würde, als zweite Policy am CS-vServer:

add cs policylabel lbl_app HTTP
add cs policy pol_pfad_a -rule "HTTP.REQ.URL.PATH.STARTSWITH(\"/a\")"
add cs policy pol_pfad_b -rule "HTTP.REQ.URL.PATH.STARTSWITH(\"/b\")"
bind cs policylabel lbl_app pol_pfad_a 100 -targetVserver lb_app_a
bind cs policylabel lbl_app pol_pfad_b 200 -targetVserver lb_app_b

add cs vserver cs_label HTTP 198.51.100.11 80
add cs policy pol_host_app -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\")"
add cs policy pol_host_rest -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\")"
bind cs vserver cs_label -policyName pol_host_app -priority 100 -invoke policylabel lbl_app
bind cs vserver cs_label -policyName pol_host_rest -targetLBVserver lb_app_rest -priority 200
bind cs vserver cs_label -lbvserver lb_default
cs_label
 ├─ 100  Host app.example.test  ->  Label lbl_app
 │                                   ├─ 100  Pfad /a  ->  lb_app_a
 │                                   └─ 200  Pfad /b  ->  lb_app_b
 ├─ 200  Host app.example.test  ->  lb_app_rest
 └─ Standardziel                ->  lb_default

Zwei Kleinigkeiten fallen beim Abtippen auf: Im Label heißt der Zielparameter -targetVserver, am CS-vServer -targetLBVserver. Und pol_host_app und pol_host_rest haben dieselbe Regel, sind aber zwei Objekte. Eine CS-Policy ohne Action lässt sich nur einmal binden; ein zweiter Versuch endet mit Multiple Bind not supported for Content Switching Advanced policies without action.

Gemessen: wohin die Anfragen gehen

Für die Messung hat jeder LB-vServer mit seinem eigenen Namen geantwortet, so zeigt die Antwort direkt, welches Ziel der CS-vServer gewählt hat. Die Anfragen kamen per curl mit gesetztem Host-Header:

Anfrageohne Labelmit Label
app.example.test/a/startlb_app_alb_app_a
app.example.test/b/startlb_app_blb_app_b
app.example.test/xlb_app_restlb_default
andere.example.test/alb_defaultlb_default

Drei Zeilen sind gleich. Die dritte nicht: Eine Anfrage an den richtigen Host, für die im Label keine Pfadregel passt, landet beim Standardziel und nicht bei lb_app_rest.

Warum /x beim Standardziel landet

pol_host_app auf Priorität 100 passt, der NetScaler ruft das Label auf und prüft dort /a und /b. Keine der beiden passt. Damit ist die Auswertung beendet. Die Policy auf Priorität 200 prüft der NetScaler gar nicht mehr; ihr Trefferzähler in show cs vserver cs_label blieb bei 0.

Das folgt aus der Bindung selbst. Sie hat keine -gotoPriorityExpression, und laut Herstellerdokumentation zu Policy Labels ist eine fehlende Angabe gleichbedeutend mit END: Nach dem Aufruf des Labels wird nicht weiter ausgewertet. Was das Label nicht entscheidet, entscheidet das Standardziel.

Die Lösung: die Auffangregel gehört ins Label

Die Rest-Regel wandert als letzte Policy in das Label. Ihre Bedingung ist true, sie passt also immer, und weil sie die höchste Prioritätszahl hat, kommt sie nur zum Zug, wenn /a und /b nicht gepasst haben. Die Policy auf Priorität 200 am CS-vServer entfällt:

unbind cs vserver cs_label -policyName pol_host_rest
rm cs policy pol_host_rest
add cs policy pol_label_rest -rule true
bind cs policylabel lbl_app pol_label_rest 900 -targetVserver lb_app_rest

Danach ergab die Messung lb_app_a, lb_app_b, lb_app_rest für /x und lb_default für den fremden Host, also dasselbe wie in der flachen Fassung.

Und -gotoPriorityExpression NEXT?

Naheliegend wäre, die Auswertung nach dem Label einfach weiterlaufen zu lassen:

unbind cs vserver cs_label -policyName pol_host_app
bind cs vserver cs_label -policyName pol_host_app -priority 100 -gotoPriorityExpression NEXT -invoke policylabel lbl_app

Damit landete in meiner Messung jede Anfrage an app.example.test bei lb_app_rest, auch /a und /b. Das Label setzt sein Ziel, die Auswertung läuft am CS-vServer weiter, und die später passende Policy auf Priorität 200 ersetzt das Ziel. Als Gegenprobe habe ich die Policy auf 200 entfernt und NEXT stehen lassen: Dann blieben /a und /b bei ihren Zielen aus dem Label. Für die Rest-Regel bleibt deshalb die Auffangregel im Label der Weg.

Ein Label an mehreren CS-vServern

Ein Label lässt sich von mehreren CS-vServern aus aufrufen. An meiner Testinstanz hat ein zweiter CS-vServer dasselbe lbl_app genutzt und dieselben Ziele geliefert. Er braucht dafür aber eine eigene Einstiegs-Policy, aus demselben Grund wie oben: pol_host_app hat keine Action und ist schon an cs_label gebunden.

add cs policy pol_host_app_2 -rule "HTTP.REQ.HOSTNAME.SERVER.EQ(\"app.example.test\")"
bind cs vserver cs_flach -policyName pol_host_app_2 -priority 50 -invoke policylabel lbl_app

Das ist der Fall, für den sich ein Label lohnt: Die Regelliste steht einmal im Label, und jeder weitere CS-vServer bekommt nur eine Zeile dazu, etwa eine interne und eine externe VIP für dieselbe Anwendung.

Welche Ziele der NetScaler annimmt

Ein CS-vServer vom Typ HTTP oder SSL nahm an meiner Testinstanz LB-vServer vom Typ HTTP und SSL als Ziel an. Einen LB-vServer vom Typ TCP wies er an jeder Stelle ab, an der das Ziel fest eingetragen wird: als Standardziel, an der Bindung, in einer CS-Action und im Label. Die Action selbst nahm er an; den Fehler meldete er beim Anlegen der Policy, die sie verwendet. Die erste Meldung kam am Standardziel und an der Bindung, die zweite bei der Policy mit Action, die dritte im Label:

ERROR: The target vserver is not compatible with the CS verver.
ERROR: The target vserver is not compatible with the CS policy expression. [HTTP.REQ & HTTP request header]
ERROR: The target vserver is not compatible with the CS policylabel.

Ein Label vom Typ HTTP ließ sich auch von einem CS-vServer vom Typ SSL aufrufen; der Typ des Labels beschreibt das Protokoll, das darin ausgewertet wird. Andere Kombinationen als HTTP, SSL und TCP habe ich nicht geprüft.

Eine Ausnahme gibt es: Ein Ziel, das eine CS-Action erst zur Laufzeit aus einem Ausdruck bildet (-targetVserverExpr), prüft der NetScaler beim Anlegen nicht. Eine Action mit dem Ausdruck "lb_tcp" nahm er ohne Meldung an. show cs action zeigt solche Actions mit ihrem Ausdruck; die dort genannten Ziele sind von Hand gegen den Typ des CS-vServers zu prüfen:

    Name: act_expr
    Target Vserver Expression: "lb_tcp"

Labels in einer bestehenden Konfiguration finden

show ns runningConfig | grep -i "cs policylabel"
show ns runningConfig | grep -i "^bind cs vserver.*-invoke"

Die erste Zeile zeigt die Labels und ihre Policies, die zweite die CS-vServer, die ein Label aufrufen. Ein Filter nur auf invoke policylabel trifft auch eingebaute Cache-Bindungen (bind cache global NOPOLICY … -invoke policylabel _reqBuiltinDefaults), deshalb der Anfang ^bind cs vserver.

Für die Fehlersuche sind die Trefferzähler der wichtigste Griff, und beim Label stehen sie an einer anderen Stelle. show cs vserver cs_label zeigt am Ende die Einstiegs-Policy mit ihrem Zähler (Ausgabe gekürzt):

1)  Content-Switching Policy: pol_host_app  Invoke: policylabel lbl_app  Rule: HTTP.REQ.HOSTNAME.SERVER.EQ("app.example.test")  Priority: 100  Hits: 3
1)  Default Target LB: lb_default  Hits: 4

show cs policylabel lbl_app zeigt die Policies im Label mit ihren Zielen und wie oft das Label aufgerufen wurde, aber keinen Zähler je Policy:

    Label Name: lbl_app
    Label Type: HTTP
    Number of bound policies: 3
    Number of times invoked: 9
1)  Policy Name: pol_pfad_a
    Priority: 100
    Target Virtual Server: lb_app_a
2)  Policy Name: pol_pfad_b
    Priority: 200
    Target Virtual Server: lb_app_b
3)  Policy Name: pol_label_rest
    Priority: 900
    Target Virtual Server: lb_app_rest

Den Zähler einer Policy im Label liefert show cs policy pol_pfad_a:

    Policy: pol_pfad_a  Rule: HTTP.REQ.URL.PATH.STARTSWITH("/a")
    Hits: 3
1)  CS Policylabel: lbl_app
    Priority: 100
    With Target LB: lb_app_a
    Hits: 3

Die Zähler laufen der Anfrage ein paar Sekunden hinterher. Direkt nach einem Test standen sie an meiner Testinstanz noch auf dem alten Wert, zehn bis zwanzig Sekunden später stimmten sie.

Direkte Bindung oder Content Switching Policy Label: der Vergleich

ohne Labelmit Label
Aufbaueine Liste am CS-vServerEinstiegs-Policy am CS-vServer, Liste im Label
Bedingungenjede Policy trägt alle Bedingungengemeinsame Bedingung einmal am CS-vServer, Rest im Label
Zielparameter-targetLBVserverim Label -targetVserver
nichts passt im Teilbereichdie nächste Policy am CS-vServer wird geprüftdie Auswertung endet, das Standardziel greift; Auffangregel ins Label
mehrere CS-vServerjede Policy je CS-vServer binden, Policies ohne Action dafür doppelt anlegenLabel einmal, je CS-vServer eine Einstiegs-Policy
Trefferzählershow cs vserverEinstieg in show cs vserver, Label-Policies in show cs policy
in der Konfigurationalles unter bind cs vserverzusätzlich bind cs policylabel

Bei wenigen Regeln ist die flache Liste leichter zu lesen, weil alles an einer Stelle steht. Das Label spielt seine Stärke aus, wenn eine gemeinsame Bedingung viele Regeln anführt oder dieselbe Regelliste an mehreren CS-vServern gebraucht wird.

Was du dir merkst

Ein Policy Label ist eine zweite Regelliste, die eine Policy am CS-vServer aufruft. Passt darin keine Regel, endet die Auswertung und das Standardziel greift. Die Auffangregel gehört deshalb als letzte Policy ins Label.

Labels findest du mit grep -i "^bind cs vserver.*-invoke" in der Running-Config, die Treffer je Label-Policy mit show cs policy. Die Ziele im Label müssen zum Typ des CS-vServers passen wie überall sonst.

Quellen

  • Create policy labels, NetScaler-Dokumentation 14.1: add cs policylabel, Labeltypen, Goto-Ausdrücke (END bei fehlender Angabe, NEXT)
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-19 07:30:002026-11-18 22:43:17Content Switching Policy Label: was sich gegenüber der direkten Bindung ändert
Das könnte Dich auch interessieren
Verbindung abgelehnt heißt falscher Port, nicht Zertifikat
Citrix NetScaler Gateway SSL A+ Ranking
NetScaler CVE-2026-88771: Angriffsspuren in den Logs erkennen
Instanz nicht verfügbar beim ADM-Proxy
Cross-Zertifikate in der Zertifikatskette: Ersetzen sie ein Intermediate?
NetScaler CVE-2026-88771 bis 88778: Betroffenheit 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: NITRO-Anmeldung an NetScaler und Console: die zwei Unterschiede Link zu: NITRO-Anmeldung an NetScaler und Console: die zwei Unterschiede NITRO-Anmeldung an NetScaler und Console: die zwei Unterschiede
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}