> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/de/config/hosting/reverse-proxy.md).

# Reverse Proxy

Konfigurieren Sie PowerShell Universal für den Betrieb hinter einem Reverse Proxy – einschließlich WebSocket-Unterstützung, weitergeleiteter Header und Einrichtung des Azure Application Proxy.

Reverse-Proxys ermöglichen die Konfiguration von Funktionen wie TLS, Header-Umschreibung, Caching und Lastverteilung. Zu den beliebten Reverse-Proxys gehören IIS, Apache und NGINX.

Jedes dieser Systeme erfasst HTTP-Traffic und leitet ihn an einen Backend-Webserver wie PowerShell Universal weiter. Bei der Konfiguration eines Reverse-Proxys vor PowerShell Universal sind einige Punkte zu beachten.

## WebSocket-Unterstützung

PowerShell Universal benötigt WebSocket-Unterstützung, um alle in der Plattform verfügbaren Funktionen bereitzustellen. Ohne WebSocket-Unterstützung funktionieren Apps nicht und Benachrichtigungen werden nicht in Echtzeit angezeigt.

Je nach Proxy müssen Sie möglicherweise die WebSocket-Unterstützung konfigurieren.

* [IIS WebSocket Protocol Support](https://learn.microsoft.com/en-us/iis/get-started/whats-new-in-iis-8/iis-80-websocket-protocol-support)
* [NGINX WebSocket proxying](https://nginx.org/en/docs/http/websocket.html)

## Weitergeleitete Header

Wenn sich ein Webserver hinter einem Reverse-Proxy befindet, unterscheiden sich der externe Hostname, das Protokoll und der Port wahrscheinlich vom Proxy selbst. Beispielsweise lauscht PowerShell Universal auf Port 5000, über HTTP und basierend auf einer bestimmten IP-Adresse (oder Loopback) statt auf einem DNS-Namen.

```
https://www.proxyaddress.com -> http://localhost:5000
```

Dies kann zu Problemen mit URL-Weiterleitungen führen, wie sie in Authentifizierungsflüssen von [OpenID Connect](/powershell-universal/de/sicherheit/enterprise-security/openid-connect.md) verwendet werden. PowerShell Universal muss in der Lage sein, die Weiterleitungs-URL für den Authentifizierungsfluss korrekt zu bilden. Ohne Kenntnis des tatsächlichen Hostnamens, Ports oder Protokolls, das vom Endbenutzer verwendet wird, können ungültige URLs erzeugt werden, wodurch der Fluss fehlschlägt.

Standardmäßig verarbeitet PowerShell Universal [weitergeleitete Header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Forwarded) automatisch. Die folgenden Header werden automatisch verarbeitet.

* X-Forwarded-For
* X-Forwarded-Host
* X-Forwarded-Proto

Dies ermöglicht PowerShell Universal, die richtigen Umleitungs-URLs für Authentifizierungsabläufe zu erstellen.

Reverse-Proxys erfordern möglicherweise eine Konfiguration, um diese Header korrekt zu senden.

* IIS konfiguriert weitergeleitete Header automatisch.
* [NGINX Forwarded Headers](https://www.nginx.com/resources/wiki/start/topics/examples/forwarded/)
* [Apache mod\_proxy](https://httpd.apache.org/docs/2.4/mod/mod_proxy.html#x-headers)
* [CloudFlare HTTP request headers](https://developers.cloudflare.com/fundamentals/get-started/reference/http-request-headers/#x-forwarded-for)

## Azure Application Proxy

Der Azure Application Proxy, auch als Entra ID Private Network Connector bezeichnet, ermöglicht den Zugriff auf lokale Ressourcen über das Internet unter Nutzung der von Microsoft bereitgestellten Sicherheit. Sie benötigen einen in Ihrem Netzwerk installierten Connector, um die Verbindung zu PowerShell Universal zu proxen.

Konfigurieren Sie die Application Proxy-Einstellungen für Ihre Enterprise Application so, dass sie auf Ihren lokalen Server verweisen. In diesem Beispiel ist meinem Connector die Gruppe Default - North America zugeordnet. Auf diesem Connector-Computer ist PowerShell Universal installiert.

Verwenden Sie für die erweiterten Einstellungen ein persistentes Cookie und vermeiden Sie das Übersetzen von URLs. Sie können bei Bedarf wählen, ob das Backend-SSL-Zertifikat validiert werden soll.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/de/config/hosting/reverse-proxy.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.