HTTPAPI | Rezerwacja URL

Rezerwacja adresów URL HTTP.SYS to funkcja systemu operacyjnego Windows umożliwiająca użytkownikowi zarezerwowanie określonego adresu URL (Uniform Resource Locator) dla swojej aplikacji lub usługi. Gdy adres URL jest zarezerwowany za pomocą HTTP.SYS, system operacyjny przechwytuje wszystkie przychodzące żądania HTTP dla tego adresu URL i kieruje je do wskazanej aplikacji lub usługi.

Aby zarezerwować adres URL przy użyciu HTTP.SYS, aplikacja lub usługa musi najpierw zarejestrować adres URL w sterowniku HTTP.SYS poprzez wywołanie HTTP API. Aplikacja lub usługa podaje adres URL, metodę HTTP (np. GET, POST) oraz wszelkie dodatkowe ustawienia, takie jak wymagania dotyczące uwierzytelniania.

Po zarejestrowaniu adresu URL, HTTP.SYS przechwytuje wszystkie przychodzące żądania HTTP dla tego adresu URL i wyszukuje zarejestrowaną aplikację lub usługę na podstawie adresu URL i metody. Jeśli zostanie znaleziona pasująca aplikacja lub usługa, sterownik HTTP.SYS przekazuje żądanie do tej aplikacji lub usługi w celu przetworzenia.

Polecenia NETSH

Zarejestruj adres URL

W tym przykładzie adres URL http://example.com:80/ jest rejestrowany dla użytkownika DOMAIN\user. Można zastąpić go żądanym adresem URL i użytkownikiem.

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

Usuń adres URL

W tym przykładzie usuwany jest URL http://example.com:80/. Można zastąpić go dowolnym adresem URL, który ma zostać usunięty.

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

Pokaż wszystkie URL-e

To polecenie wyświetla listę wszystkich zarejestrowanych rezerwacji URL w systemie.

netsh http show urlacl

TsgcWebSocketServer_HTTPAPI

Serwer HTTP.SYS automatycznie rejestruje adresy URL podczas uruchamiania. Odbywa się to przy użyciu następujących parametrów i metod.

• Host i Port: jeśli Host nie jest pusty, a Port różni się od zera, serwer spróbuje zarejestrować adres URL. Przykład: adres URL https://127.0.0.1:5000 zostanie zarejestrowany przy użyciu następujących właściwości
  • Host = '127.0.0.1';
  • Port = 5000
  • SSL = True
• NewBinding: użyj tej metody do rejestracji jednego lub wielu adresów URL.
  • Rejestracja adresu URL https://127.0.0.1:5000 --> NewBinding('127.0.0.1', 5000, '/', True)
  • Rejestracja adresu URL http://+:5000/ws/ --> NewBinding('+', 5000, '/ws/')

Rejestracja URL wymaga uprawnień administratora w następujących przypadkach:

• Numer portu jest poniżej 1024
• Host jest znakiem wieloznacznym "+", a nie adresem IP.

Jeśli chcesz zarejestrować port 443 dla wszystkich adresów IP serwera i nasłuchiwać tylko na punkcie końcowym "/ws/", bez uruchamiania serwera z uprawnieniami administratora, wykonaj następujące kroki:

• Rejestracja URL za pomocą netsh
  • netsh http add urlacl url=https://+:443/ws/ user=DOMAIN\user
• Skonfiguruj serwer z następującym powiązaniem
  • NewBinding('+', 443, '/ws/', True);
• Wyłącz właściwość ConfigureSSLCertificate
  • TsgcWebSocketServer_HTTPAPI.BindingOptions.ConfigureSSLCertificate = false;
• Skonfiguruj certyfikat SSL
  • HTTPAPI Server SSL