TsgcWebSocketServer_HTTPAPIProperties › BindingOptions

BindingOptions Właściwość

Precyzuje sposób rejestrowania rezerwacji URL i certyfikatów SSL w sterowniku http.sys podczas uruchamiania.

Składnia

property BindingOptions: TsgcWSBindings_Options_HTTPAPI read FBindingOptions write SetBindingOptions;

Wartość domyślna

ConfigureSSLCertificate=True

Uwagi

Gdy ConfigureSSLCertificate ma wartość True (domyślnie), serwer automatycznie rezerwuje adres URL i dołącza certyfikat SSL identyfikowany przez SSLOptions.Hash za każdym razem, gdy właściwość Active zostanie ustawiona na True — wymaga to uruchomienia procesu z uprawnieniami administratora. Należy ustawić wartość False, jeśli adres URL został już zarejestrowany i certyfikat powiązany zewnętrznie (np. za pomocą netsh http add urlacl i netsh http add sslcert); serwer uruchomi się wtedy bez żądania podniesienia uprawnień. Właściwość wpływa wyłącznie na sekwencję aktywacji — zachowanie w czasie działania jest identyczne w obu przypadkach.

Przykład


oServer := TsgcWebSocketServer_HTTPAPI.Create(nil);
oServer.Host := '127.0.0.1';
oServer.Port := 443;
oServer.SSL := true;
oServer.SSLOptions.Hash := 'CERTIFICATE_HASH';
// URL and certificate already registered with netsh: skip the admin-only step
oServer.BindingOptions.ConfigureSSLCertificate := false;
oServer.Active := true;

Wróć do Właściwości