> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/de/bereitstellung/infrastructure.md).

# Überlegungen zur Infrastruktur

Anforderungen an die RealmJoin-Infrastruktur und das Netzwerk: Verbindungsendpunkte, Azure Front Door, Proxy-Empfehlungen und BranchCache-basierte Peer-to-Peer-Inhaltsbereitstellung.

## Netzwerk

RealmJoin ist ein Cloud-nativer Dienst und ist ausgelegt für **direkten, uneingeschränkten ausgehenden Internetzugang**. Dies ist die unterstützte Konfiguration. Wenn Ihre Sicherheitsrichtlinie ausgehende Filterung erfordert, befolgen Sie die untenstehenden Regeln — sie enthalten alles, was nötig ist, um eine Firewall für RealmJoin zu konfigurieren:

* **Richtung**: Nur ausgehend. Alle Verbindungen werden vom Client initiiert; eingehende Regeln sind nicht erforderlich.
* **Protokoll**: Ausschließlich HTTPS (TCP 443).
* **Filterung**: Nach **Hostname (FQDN)** nur — siehe die Endpunktliste unten. **IP-basierte Filterung wird nicht unterstützt.**

### RealmJoin-Verbindungsendpunkte

Der RealmJoin-Client benötigt ausgehendes HTTPS (TCP 443) und muss alle folgenden Endpunkte erreichen können:

<table data-search="false"><thead><tr><th width="357">Host</th><th>Zweck</th></tr></thead><tbody><tr><td><code>portal.realmjoin.com</code></td><td>RealmJoin-Portal</td></tr><tr><td><code>client-api.realmjoin.com</code></td><td>RealmJoin-Client-Backend-API</td></tr><tr><td><code>client-api-staging.realmjoin.com</code></td><td>RealmJoin-Client-Backend-API (Staging)</td></tr><tr><td><code>cdn.realmjoin.com</code></td><td>Bereitstellung von Softwarepaket-Inhalten</td></tr><tr><td><code>nuget.realmjoin.com</code></td><td>RealmJoin-Paket-Feed (NuGet)</td></tr><tr><td><code>gkrealmjoin.s3.amazonaws.com</code></td><td>RealmJoin-Client-Download (Self-Updater)</td></tr><tr><td><code>realmjoinstaticcdn.azureedge.net</code></td><td>RealmJoin Notifier</td></tr><tr><td><code>login.microsoftonline.com</code></td><td>Microsoft Entra ID-Authentifizierung</td></tr><tr><td><code>realmjoinuploader.blob.core.windows.net</code></td><td>Speicher für das Hochladen von Packaging-Anforderungen</td></tr><tr><td><code>graph.microsoft.com</code></td><td>Microsoft Graph API</td></tr><tr><td><code>enterpriseregistration.windows.net</code></td><td>Microsoft Entra-Geräteregistrierung</td></tr><tr><td><code>x1.c.lencr.org</code></td><td>Zertifikatsvalidierung (Let's Encrypt)</td></tr></tbody></table>

{% hint style="warning" %}
Verweisen Sie auf diese Endpunkte **nach Hostname (FQDN), niemals nach IP-Adresse**. **Wir können keine IP-Adressen oder IP-Bereiche für RealmJoin bereitstellen, und IP-basierte Filterung wird nicht unterstützt.** Das Paket-CDN (`cdn.realmjoin.com`) wird über Azure Front Door bereitgestellt, das keine festen IP-Bereiche hat — siehe [Azure Front Door](#azure-front-door) unten.
{% endhint %}

### Azure Front Door

`cdn.realmjoin.com` — der Endpunkt, der den gesamten Softwarepaket-Inhalt bereitstellt — wird über [Azure Front Door](https://learn.microsoft.com/en-us/azure/frontdoor/front-door-overview), Microsofts globale Edge- und CDN-Plattform. Das hat direkte Konsequenzen für die Netzwerkfilterung:

* **Es gibt keine festen IP-Bereiche.** Azure Front Door verwendet einen von Microsoft verwalteten globalen Anycast-IP-Pool. Microsoft kann diese IP-Adressen jederzeit und ohne Vorankündigung hinzufügen, entfernen oder neu zuweisen. Aus diesem Grund existiert keine IP-Liste und kann auch nicht bereitgestellt werden — jede solche Liste wäre sofort veraltet.
* **IP-basierte Allowlistings werden ohne Vorwarnung fehlschlagen** und werden nicht unterstützt. Dasselbe gilt für DNS-Level-Interception oder das Umschreiben dieser Hostnamen.
* Wenn Ihre Richtlinie dennoch eine Einschränkung des ausgehenden Datenverkehrs erfordert, **hostname-(FQDN)-basierte Regeln** sind der einzige Ansatz, der mit RealmJoin funktioniert.

### Proxys vermeiden

* Die Ersteinrichtung erfordert **direkten Internetzugang**.
* **Kein Proxy** ist ideal; ein **transparenter Proxy** funktioniert gut (wenn er wirklich transparent ist).
* Wenn ein Proxy unvermeidbar ist, müssen die [RealmJoin-Verbindungsendpunkte](#realmjoin-connection-endpoints) mindestens direkt erreichbar sein.

Darüber hinaus müssen die Microsoft-Dienste, von denen RealmJoin abhängt, erreichbar sein. Microsoft veröffentlicht die entsprechenden Adressbereiche:

* [Azure-IP-Bereiche und Dienst-Tags – Public Cloud](https://www.microsoft.com/en-us/download/details.aspx?id=56519) — Compute-IP-Adressbereiche (einschließlich SQL-Bereiche), die von den Microsoft Azure-Datenzentren verwendet werden. Jeden Mittwoch (Pacific Time) wird eine neue Datei mit den geplanten IP-Adressbereichen hochgeladen, wirksam ab dem darauffolgenden Montag (Pacific Time). Laden Sie die neue Datei herunter und wenden Sie die erforderlichen Änderungen in Ihrer Umgebung vor Montag an.
* [Office 365-URLs und IP-Adressbereiche](https://support.office.com/en-us/article/Office-365-URLs-and-IP-address-ranges-8548a211-3fe7-47cb-abb1-355ea5aa88a2) — Adressbereiche, die in Ihre ausgehenden Allow-Listen aufgenommen werden sollten, damit Clients Office 365 erfolgreich nutzen können.

{% hint style="info" %}
Die Filterung nach IP-Adressen allein ist aufgrund von Abhängigkeiten von internetbasierten Diensten wie Domain Name Services (DNS), Content Delivery Networks (CDNs), Certificate Revocation Lists und anderen Drittanbieter- oder dynamischen Diensten keine vollständige Lösung. Zu diesen Abhängigkeiten gehören auch Abhängigkeiten von anderen Microsoft-Diensten wie dem Azure Content Delivery Network, und sie führen dazu, dass Netzwerk- oder Firewallprotokolle Verbindungen zu IP-Adressen anzeigen, die Drittanbietern oder Microsoft gehören, aber auf dieser Seite nicht aufgeführt sind. Diese nicht aufgeführten IP-Adressen, unabhängig davon, ob sie von Drittanbietern oder von Microsoft betriebenen CDN- und DNS-Diensten stammen, werden dynamisch zugewiesen und können sich jederzeit ändern.
{% endhint %}

### BranchCache und Geräteisolierung

BranchCache ist eine integrierte Windows-Peer-to-Peer-Technologie, die **WAN-Datenverkehr reduziert** und **die Bereitstellung von Inhalten beschleunigt** indem Clients heruntergeladene Inhalte miteinander teilen, anstatt dass jedes Gerät dieselben Inhalte aus der Cloud bezieht.

{% hint style="info" %}
Für RealmJoin ist BranchCache **standardmäßig aktiviert** auf CDN- und Client-Seite.
{% endhint %}

**Warum BranchCache statt Delivery Optimization?** Delivery Optimization unterstützt keine Paketquellen von Drittanbietern — es funktioniert nur mit von Microsoft gesteuerten Endpunkten (Windows Update, Store, M365 Apps, Intune). BranchCache funktioniert für Inhalte von Drittanbietern wie RealmJoin-Pakete.

**Konfiguration:**

* **CDN-Seite**: Standardmäßig aktiviert. Auf Anfrage können wir BranchCache auf der CDN-Seite vollständig deaktivieren (pro Tenant), wodurch die Client-seitige Konfiguration irrelevant wird.
* **Client-Seite**: Standardmäßig aktiviert. Setzen Sie `BranchCache.Mode = "Undefined"` (siehe [Benutzer- und Gruppeneinstellungen](https://docs.realmjoin.com/de/ugd-management/user-and-group-settings.md)) um diesen Standard zu ändern. Hinweis: Bei vorhandenen Clients wird die Funktion nicht aktiv deaktiviert, sobald sie zuvor einmal aktiviert wurde — führen Sie `Disable-BC` auf den gewünschten Geräten aus, um sie zu deaktivieren.

**Netzwerkanforderungen:**

* Clients müssen in der Lage sein, **direkt miteinander zu kommunizieren** — trennen Sie sie nicht in verschiedene VLANs oder Subnetze und blockieren Sie Peer-Verkehr nicht über Geräteisolierung.
* RealmJoin verwendet **Distributed Cache Mode** nur: Jeder Client führt einen lokalen Cache und ruft zwischengespeicherte Daten von Peers ab.
* **Hosted Cache Mode** (dedizierter Windows Server, konfiguriert über die Richtlinie "Configure Hosted Cache Servers") ist **von RealmJoin nicht unterstützt** .

**So funktioniert es:**

1. Wenn ein Client zum ersten Mal ein Softwarepaket herunterlädt, werden die Dateien in deutlich kleinere Blöcke als der ursprüngliche Inhalt aufgeteilt und auf dem Gerät zwischengespeichert.
2. Wenn ein anderer Client im selben Netzwerk dasselbe Paket anfordert, lädt er nur **Inhaltsinformationen** anstatt des vollständigen Inhalts vom Server herunter.
3. Der Client verwendet die Inhaltsinformationen für **Peer-Erkennung**: Er sendet eine Multicast-Anfrage ("Hat jemand Inhalt ID XYZ?"), und jeder Peer, der das angeforderte Segment besitzt, antwortet direkt per Unicast.
4. Der Inhalt wird als Blöcke von Peers übertragen. Wenn die angeforderte Software auf mehreren Geräten verfügbar ist, wird die Last zwischen ihnen ausgeglichen.

Informationen darüber, was der BranchCache-Stack von RealmJoin auf dem Gerät tut (Prefetching, Hash-Verifizierung, Übertragungsstatistiken), finden Sie unter [BranchCache](https://docs.realmjoin.com/de/realmjoin-agent/realmjoin-client/branchcache.md). Weitere Details finden Sie bei Microsoft Learn: [BranchCache](https://learn.microsoft.com/en-us/windows-server/networking/branchcache/branchcache)


---

# 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.realmjoin.com/de/bereitstellung/infrastructure.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.
