> 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/pt/implementacao/infrastructure.md).

# Considerações de infraestrutura

Requisitos de infraestrutura e rede do RealmJoin: pontos finais de ligação, Azure Front Door, orientações de proxy e entrega de conteúdo ponto a ponto com base em BranchCache.

## Rede

RealmJoin é um serviço nativo da cloud e foi concebido para **acesso direto e irrestrito à Internet de saída**. Esta é a configuração suportada. Se a sua política de segurança exigir filtragem de saída, siga as regras abaixo — elas contêm tudo o que é necessário para configurar uma firewall para RealmJoin:

* **Direção**: Apenas de saída. Todas as ligações são iniciadas pelo cliente; não são necessárias regras de entrada.
* **Protocolo**: Exclusivamente HTTPS (TCP 443).
* **Filtragem**: Por **nome do anfitrião (FQDN)** apenas — consulte a lista de pontos finais abaixo. **A filtragem baseada em IP não é suportada.**

### Pontos finais de ligação do RealmJoin

O cliente RealmJoin requer HTTPS de saída (TCP 443) e tem de conseguir alcançar todos os seguintes pontos finais:

<table data-search="false"><thead><tr><th width="357">Anfitrião</th><th>Finalidade</th></tr></thead><tbody><tr><td><code>portal.realmjoin.com</code></td><td>Portal RealmJoin</td></tr><tr><td><code>client-api.realmjoin.com</code></td><td>API de backend do cliente RealmJoin</td></tr><tr><td><code>client-api-staging.realmjoin.com</code></td><td>API de backend do cliente RealmJoin (staging)</td></tr><tr><td><code>cdn.realmjoin.com</code></td><td>Distribuição de conteúdo de pacotes de software</td></tr><tr><td><code>nuget.realmjoin.com</code></td><td>feed de pacotes do RealmJoin (NuGet)</td></tr><tr><td><code>gkrealmjoin.s3.amazonaws.com</code></td><td>Descarregamento do cliente RealmJoin (Self-Updater)</td></tr><tr><td><code>realmjoinstaticcdn.azureedge.net</code></td><td>Notificador do RealmJoin</td></tr><tr><td><code>login.microsoftonline.com</code></td><td>autenticação Microsoft Entra ID</td></tr><tr><td><code>realmjoinuploader.blob.core.windows.net</code></td><td>Armazenamento de carregamento de pedidos de empacotamento</td></tr><tr><td><code>graph.microsoft.com</code></td><td>API do Microsoft Graph</td></tr><tr><td><code>enterpriseregistration.windows.net</code></td><td>registo de dispositivos Microsoft Entra</td></tr><tr><td><code>x1.c.lencr.org</code></td><td>Validação de certificados (Let's Encrypt)</td></tr></tbody></table>

{% hint style="warning" %}
Consulte estes pontos finais **pelo nome do anfitrião (FQDN), nunca por endereço IP**. **Não podemos fornecer endereços IP ou intervalos de IP para o RealmJoin, e a filtragem baseada em IP não é suportada.** A CDN do pacote (`cdn.realmjoin.com`) é entregue através do Azure Front Door, que não tem intervalos de IP fixos — veja [Azure Front Door](#azure-front-door) abaixo.
{% endhint %}

### Azure Front Door

`cdn.realmjoin.com` — o ponto final que entrega todo o conteúdo dos pacotes de software — é servido através de [Azure Front Door](https://learn.microsoft.com/en-us/azure/frontdoor/front-door-overview), a plataforma global de edge e CDN da Microsoft. Isto tem consequências diretas para a filtragem de rede:

* **Não existem intervalos de IP fixos.** O Azure Front Door utiliza um conjunto de IP anycast global gerido pela Microsoft. A Microsoft pode adicionar, remover ou reatribuir estes endereços IP a qualquer momento, sem aviso. Por este motivo, não existe nem pode ser fornecida qualquer lista de IP — qualquer lista desse tipo ficaria imediatamente desatualizada.
* **A inclusão em listas de permissão baseada em IP deixará de funcionar sem aviso** e não é suportada. O mesmo se aplica à interceção ou reescrita destes nomes de anfitrião ao nível do DNS.
* Se a sua política exigir, mesmo assim, restringir o tráfego de saída, **regras baseadas em nome do anfitrião (FQDN)** são a única abordagem que funciona com o RealmJoin.

### Evite proxies

* A implementação inicial requer **acesso direto à Internet**.
* **Nenhum proxy** é o ideal; um **proxy transparente** funciona bem (se for verdadeiramente transparente).
* Se um proxy for inevitável, os [pontos finais de ligação do RealmJoin](#realmjoin-connection-endpoints) têm de estar diretamente acessíveis, como requisito mínimo.

Além disso, os serviços Microsoft dos quais o RealmJoin depende têm de estar acessíveis. A Microsoft publica os intervalos de endereços correspondentes:

* [Intervalos de IP do Azure e Service Tags – Nuvem Pública](https://www.microsoft.com/en-us/download/details.aspx?id=56519) — intervalos de endereços IP de computação (incluindo intervalos SQL) usados pelos datacenters do Microsoft Azure. É carregado um novo ficheiro todas as quartas-feiras (Hora do Pacífico) com os intervalos de endereços IP planeados, com efeito na segunda-feira seguinte (Hora do Pacífico). Descarregue o novo ficheiro e aplique as alterações necessárias no seu site antes de segunda-feira.
* [URLs e intervalos de endereços IP do Office 365](https://support.office.com/en-us/article/Office-365-URLs-and-IP-address-ranges-8548a211-3fe7-47cb-abb1-355ea5aa88a2) — intervalos de endereços a incluir nas suas listas de permissão de saída para que os clientes possam utilizar o Office 365 com êxito.

{% hint style="info" %}
A filtragem apenas por endereço IP não é uma solução completa devido às dependências de serviços baseados na Internet, como Serviços de Nome de Domínio (DNS), Redes de Distribuição de Conteúdo (CDNs), Listas de Revogação de Certificados e outros serviços de terceiros ou dinâmicos. Estas dependências incluem dependências de outros serviços Microsoft, como a Azure Content Delivery Network, e resultarão em rastreios de rede ou registos da firewall que indicam ligações a endereços IP propriedade de terceiros ou da Microsoft, mas não listados nesta página. Estes endereços IP não listados, quer sejam de CDN e serviços DNS de terceiros quer da Microsoft, são atribuídos dinamicamente e podem mudar a qualquer momento.
{% endhint %}

### BranchCache e Isolamento de dispositivos

BranchCache é uma tecnologia de peering integrada do Windows que **reduz o tráfego WAN** e **acelera a distribuição de conteúdo** ao permitir que os clientes partilhem conteúdo descarregado entre si, em vez de cada dispositivo obter o mesmo conteúdo da cloud.

{% hint style="info" %}
Para o RealmJoin, o BranchCache está **ativado por predefinição** no lado da CDN e do cliente.
{% endhint %}

**Por que BranchCache em vez de Delivery Optimization?** O Delivery Optimization não suporta origens de pacotes de terceiros — funciona apenas com pontos finais controlados pela Microsoft (Windows Update, Store, M365 Apps, Intune). O BranchCache funciona para conteúdo de terceiros, como pacotes RealmJoin.

**Configuração:**

* **Lado da CDN**: Ativado por predefinição. A pedido, podemos desativar totalmente o BranchCache no lado da CDN (por tenant), o que torna irrelevante a configuração do lado do cliente.
* **Lado do cliente**: Ativado por predefinição. Defina `BranchCache.Mode = "Undefined"` (consulte [Definições de utilizador e grupo](https://docs.realmjoin.com/pt/ugd-management/user-and-group-settings.md)) para alterar esta predefinição. Nota: em clientes existentes, a funcionalidade não é desativada ativamente depois de ter sido ativada anteriormente — execute `Disable-BC` nos dispositivos pretendidos para a desativar.

**Requisitos de rede:**

* Os clientes têm de poder **comunicar diretamente entre si** — não os separe em VLANs ou sub-redes diferentes e não bloqueie o tráfego entre pares através do isolamento de dispositivos.
* O RealmJoin utiliza **Modo de Cache Distribuída** apenas: cada cliente mantém uma cache local e obtém dados em cache dos pares.
* **Modo de Cache Hospedada** (Windows Server dedicado, configurado através da política "Configure Hosted Cache Servers") não é **suportado** pelo RealmJoin.

**Como funciona:**

1. Quando um cliente descarrega um pacote de software pela primeira vez, os ficheiros são divididos em fragmentos significativamente mais pequenos do que o conteúdo original e armazenados em cache no dispositivo.
2. Quando outro cliente na mesma rede solicita o mesmo pacote, descarrega apenas **informações de conteúdo** em vez do conteúdo completo do servidor.
3. O cliente utiliza as informações de conteúdo para **descoberta de pares**: envia uma consulta multicast ("Alguém tem o ID de conteúdo XYZ?"), e qualquer par que detenha o segmento pedido responde diretamente via unicast.
4. O conteúdo é transferido dos pares em fragmentos. Se o software solicitado estiver disponível em vários dispositivos, a carga é equilibrada entre eles.

Para o que a stack BranchCache do RealmJoin faz no dispositivo (prefetching, verificação de hash, estatísticas de transferência), consulte [BranchCache](https://docs.realmjoin.com/pt/agente-realmjoin/realmjoin-client/branchcache.md). Para mais detalhes, consulte o 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/pt/implementacao/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.
