HTTPAPI | URL-Reservierung

Die HTTP.SYS-URL-Reservierung ist eine Funktion des Windows-Betriebssystems, die es einem Benutzer ermöglicht, einen bestimmten Uniform Resource Locator (URL) für seine Anwendung oder seinen Dienst zu reservieren. Wenn eine URL mit HTTP.SYS reserviert wird, fängt das Betriebssystem alle eingehenden HTTP-Anfragen für diese URL ab und leitet sie an die angegebene Anwendung oder den angegebenen Dienst weiter.

 

Um eine URL mit HTTP.SYS zu reservieren, muss eine Anwendung oder ein Dienst die URL zuerst beim HTTP.SYS-Treiber registrieren, indem ein Aufruf an die HTTP-API getätigt wird. Die Anwendung oder der Dienst gibt die URL, die HTTP-Methode (z. B. GET, POST) und alle zusätzlichen Einstellungen wie Authentifizierungsanforderungen an.

 

Sobald die URL registriert ist, fängt HTTP.SYS alle eingehenden HTTP-Anfragen für diese URL ab und sucht die registrierte Anwendung oder den registrierten Dienst anhand von URL und Methode. Wird eine passende Anwendung oder ein passender Dienst gefunden, übergibt der HTTP.SYS-Treiber die Anfrage zur Verarbeitung an diese Anwendung oder diesen Dienst.

 

NETSH-Befehle

Eine URL registrieren

In diesem Beispiel wird die URL http://example.com:80/ für den Benutzer DOMAIN\user registriert. Sie können dies durch Ihre gewünschte URL und Ihren gewünschten Benutzer ersetzen.

 

netsh http add urlacl url=http://example.com:80/ user=DOMAIN\user

 

Eine URL löschen

In diesem Beispiel wird die URL http://example.com:80/ gelöscht. Sie können diese durch die URL ersetzen, die Sie löschen möchten.

 

netsh http delete urlacl url=http://example.com:80/

 

Alle URLs anzeigen

Dieser Befehl zeigt eine Liste aller registrierten URL-Reservierungen auf dem System an.

 

netsh http show urlacl

 

TsgcWebSocketServer_HTTPAPI

Der HTTP.SYS-Server registriert die URLs automatisch beim Start. Dies erfolgt über die folgenden Parameter und Methoden.

 

• Host und Port: wenn Host nicht leer ist und der Port von null verschieden ist, versucht der Server, die URL zu registrieren. Beispiel: die URL https://127.0.0.1:5000 wird mit den folgenden Eigenschaften registriert
  • Host = '127.0.0.1';
  • Port = 5000
  • SSL = True
• NewBinding: verwenden Sie diese Methode, um eine oder mehrere URLs zu registrieren.
  • Registrieren Sie die URL https://127.0.0.1:5000 --> NewBinding('127.0.0.1', 5000, '/', True)
  • Registrieren Sie die URL http://+:5000/ws/ --> NewBinding('+', 5000, '/ws/')

 

Die URL-Registrierung erfordert in den folgenden Fällen Administratorrechte:

• Portnummer ist kleiner als 1024
• Der Host ist ein Wildcard "+", anstelle einer IP-Adresse.

 

 

Wenn Sie den Port 443 für alle IP-Adressen des Servers registrieren und nur auf dem Endpunkt "/ws/" lauschen möchten, aber den Server nicht mit Administratorrechten ausführen wollen, gehen Sie wie folgt vor:

 

• Registrieren Sie die URL mit netsh
  • netsh http add urlacl url=https://+:443/ws/ user=DOMAIN\user
• Konfigurieren Sie den Server mit dem folgenden Binding
  • NewBinding('+', 443, '/ws/', True);
• Deaktivieren Sie die Eigenschaft ConfigureSSLCertificate
  • TsgcWebSocketServer_HTTPAPI.BindingOptions.ConfigureSSLCertificate = false;
• Konfigurieren Sie das SSL-Zertifikat
  • HTTPAPI Server SSL