TsgcWebSocketServer_HTTPAPI › Ereignisse › OnBeforeForwardHTTP

OnBeforeForwardHTTP Ereignis

Wird ausgelöst, bevor eine HTTP-Anfrage versendet wird, damit sie an einen anderen HTTP-Server weitergeleitet (reverse-proxied) werden kann.

Syntax

property OnBeforeForwardHTTP: TsgcWSHTTPAPIBeforeForwardHTTP;
// TsgcWSHTTPAPIBeforeForwardHTTP = procedure(Connection : TsgcWSConnection_HTTPAPI; aRequestInfo: THttpServerRequest; aForward: TsgcWSServerForwardHTTP) of object

Standardwert

—

Hinweise

OnBeforeForwardHTTP wird für jede über HTTP.SYS empfangene HTTP-Anfrage ausgelöst und ermöglicht es dem Server, für ausgewählte Endpunkte als Reverse-Proxy zu agieren. Inspizieren Sie aRequestInfo.Document, um zu entscheiden, ob die Anfrage weitergeleitet werden muss; wenn ja, setzen Sie aForward.Enabled auf True und weisen Sie aForward.URL den Zielserver zu. Zusätzliche Eigenschaften am aForward-Objekt verfeinern die weitergeleitete Anfrage: Document (Zielpfad überschreiben), QueryParams, Host, Origin, CustomHeaders, LogFilename, NoCache und TLSOptions für HTTPS-Ziele. Wenn aForward.Enabled False bleibt, wird die Anfrage wie üblich lokal über OnHTTPRequest bedient.

Beispiel

procedure OnBeforeForwardHTTP(Connection: TsgcWSConnection_HTTPAPI;
  aRequestInfo: THttpServerRequest; aForward: TsgcWSServerForwardHTTP);
begin
  if aRequestInfo.Document = '/internal' then
  begin
    aForward.Enabled := True;
    aForward.URL := 'http://localhost:8080';
  end;
end;

Zurück zu Ereignissen