Application Delivery Management

NetScaler® ADM als API-Proxyserver

December 12, 2025

Beitrag von:

Zusätzlich zur Fähigkeit, NITRO-REST-API-Anfragen für die eigene Verwaltungs- und Analysefunktionalität zu empfangen, kann NetScaler Application Delivery Management (NetScaler ADM) als REST-API-Proxyserver für seine verwalteten Instanzen fungieren. Anstatt API-Anfragen direkt an die verwalteten Instanzen zu senden, können REST-API-Clients die API-Anfragen an NetScaler ADM senden. NetScaler ADM kann zwischen den API-Anfragen unterscheiden, auf die es antworten muss, und den API-Anfragen, die es unverändert an eine verwaltete Instanz weiterleiten muss.

Als API-Proxyserver bietet Ihnen NetScaler ADM die folgenden Vorteile:

Validierung von API-Anfragen. NetScaler ADM validiert alle API-Anfragen anhand konfigurierter Sicherheits- und rollenbasierter Zugriffssteuerungsrichtlinien (RBAC). NetScaler ADM ist zudem mandantenfähig und stellt sicher, dass API-Aktivitäten Mandantengrenzen nicht überschreiten.
Zentrale Überwachung. NetScaler ADM führt ein Audit-Protokoll aller API-Aktivitäten, die sich auf seine verwalteten Instanzen beziehen.
Sitzungsverwaltung. NetScaler ADM entlastet API-Clients von der Aufgabe, Sitzungen mit verwalteten Instanzen aufrechterhalten zu müssen.

Wie NetScaler ADM als API-Proxyserver funktioniert

Wenn Sie möchten, dass NetScaler ADM eine Anfrage an eine verwaltete Instanz weiterleitet, konfigurieren Sie den API-Client so, dass er einen der folgenden HTTP-Header in die API-Anfrage aufnimmt:

Header-Werte	Beschreibung
_MPS_API_PROXY_MANAGED_INSTANCE_NAME	Name der verwalteten Instanz.
_MPS_API_PROXY_MANAGED_INSTANCE_IP	IP-Adresse der verwalteten Instanz.
_MPS_API_PROXY_MANAGED_INSTANCE_ID	ID der verwalteten Instanz.
_MPS_API_PROXY_TIMEOUT	Timeout-Wert für eine NITRO-API-Anfrage. Legen Sie den Timeout-Wert in Sekunden fest. Wenn Sie ein Proxy-Timeout festlegen, wartet ADM die angegebene Dauer, bevor die Anfrage abläuft.
_MPS_API_PROXY_MANAGED_INSTANCE_USERNAME	Benutzername für den Zugriff auf die verwaltete ADC-Instanz.
_MPS_API_PROXY_MANAGED_INSTANCE_PASSWORD	Passwort für den Zugriff auf die verwaltete ADC-Instanz.
_MPS_API_PROXY_MANAGED_INSTANCE_SESSID	Sitzungs-ID für den Zugriff auf die verwaltete Instanz.

Hinweis

Unter Einstellungen > Administration > Systemkonfigurationen > Grundeinstellungen müssen Sie, wenn Sie Anmeldeinformationen für die Instanzanmeldung anfordern auswählen, den Benutzernamen und das Passwort einer verwalteten Instanz konfigurieren. Alternativ können Sie auch die Sitzungs-ID der Instanz angeben.

Das Vorhandensein eines dieser HTTP-Header hilft NetScaler ADM, eine API-Anfrage als eine zu identifizieren, die an eine verwaltete Instanz weitergeleitet werden muss. Der Wert des Headers hilft NetScaler ADM, die verwaltete Instanz zu identifizieren, an die die Anfrage weitergeleitet werden muss.

Dieser Ablauf ist in der folgenden Abbildung dargestellt:

Geräte-API

Wie in der obigen Abbildung gezeigt, verarbeitet NetScaler ADM die Anfrage wie folgt, wenn einer dieser HTTP-Header in einer Anfrage erscheint:

Ohne die Anfrage zu modifizieren, leitet NetScaler ADM die Anfrage an die Instanz-API-Proxy-Engine weiter.
Die Instanz-API-Proxy-Engine leitet die API-Anfrage an einen Validator weiter und protokolliert die Details der API-Anfrage im Audit-Protokoll.
Der Validator stellt sicher, dass die Anfrage keine konfigurierten Sicherheitsrichtlinien, RBAC-Richtlinien, Mandantengrenzen usw. verletzt. Er führt zusätzliche Prüfungen durch, wie z. B. eine Prüfung, ob die verwaltete Instanz verfügbar ist.

Wenn die API-Anfrage gültig ist und an die verwaltete Instanz weitergeleitet werden kann, identifiziert NetScaler ADM eine vom Instanz-Sitzungsmanager verwaltete Sitzung und sendet die Anfrage dann an die verwaltete Instanz.

Hinweis

Stellen Sie sicher, dass die Option Anmeldeinformationen für die Instanzanmeldung anfordern deaktiviert ist. Gehen Sie dazu wie folgt vor:

Navigieren Sie zu Einstellungen > Administration.

Wählen Sie unter Systemkonfigurationen die Optionen System, Zeitzone, Zugelassene URLs und Nachricht des Tages aus.

So verwenden Sie NetScaler ADM als API-Proxyserver

Die folgenden Beispiele zeigen REST-API-Anfragen, die ein API-Client an einen NetScaler ADM-Server mit der IP-Adresse 192.0.2.5 sendet. NetScaler ADM muss die Anfragen unverändert an eine verwaltete Instanz mit der IP-Adresse 192.0.2.10 weiterleiten. Alle Beispiele verwenden den Header _MPS_API_PROXY_MANAGED_INSTANCE_IP.

Bevor der API-Client die API-Anfragen an NetScaler ADM sendet, muss er:

Sich bei NetScaler ADM anmelden
Eine Sitzungs-ID erhalten
Die Sitzungs-ID in nachfolgende API-Anfragen aufnehmen.

Die Anmelde-API-Anfrage hat die folgende Form:

    POST /nitro/v1/config/login
    Content-Type: application/json

    {
        "login": {
            "username":"nsroot",
            "password":"nsroot"
         }
    }
<!--NeedCopy-->

NetScaler ADM antwortet auf die Anmeldeanfrage mit einer Antwort, die die Sitzungs-ID enthält. Der folgende Beispiel-Antworttext zeigt eine Sitzungs-ID:

{

  "errorcode": 0,

  "message": "Done",

  "operation": "add",

  "resourceType": "login",

  "username": "***********",

  "tenant_name": "Owner",

  "resourceName": "nsroot",

  "login": [

    {

      "tenant_name": "Owner",

      "permission": "superuser",

      "session_timeout": "36000",

      "challenge_token": "",

      "username": "",

      "login_type": "",

      "challenge": "",

      "client_ip": "",

      "client_port": "-1",

      "cert_verified": "false",

      "sessionid": "##D2BF9C5F40E5B2E884A9C45C89F0ADE24DA8A8169BE6358D39F5D471B73D",

      "token": "b2f3f935e93db6a"
    }

  ]

}
<!--NeedCopy-->