> 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/fr/deploiement/architecture-overview.md).

# Vue d’ensemble de l’architecture

Vue d’ensemble de haut niveau de l’architecture RealmJoin : le backend cloud, la façon dont les appareils gérés et les administrateurs se connectent, et les ressources que RealmJoin utilise dans votre propre Tenant Microsoft.

RealmJoin est un SaaS cloud-native, multi-tenant et le **compagnon de Microsoft Intune pour le cycle de vie et la gestion des applications**. Il gère le déploiement des applications, la gestion des utilisateurs, des groupes et des appareils, ainsi que l'automatisation des processus dans l'ensemble de votre tenant Entra ID — **sans serveurs sur site ni infrastructure locale**. Tous les services backend sont exploités par glueckkanja dans **Microsoft Azure, hébergé en Europe**.

RealmJoin couvre trois domaines :

* **Gestion des applications** – le packaging, le déploiement, un catalogue en libre-service et le reporting logiciel.
* **Gestion des utilisateurs, des groupes et des appareils** – une vue unique et unifiée qui combine les données d'Intune, d'Entra ID, de Microsoft Defender, de Windows Autopilot et des journaux de connexion.
* **Automatisation des processus** – des runbooks qui s'exécutent dans *votre propre* compte Azure Automation.

## Vue d'ensemble

```mermaid
%%{init: {"flowchart": {"htmlLabels": false, "nodeSpacing": 55, "rankSpacing": 90}} }%%
flowchart LR
    Admin["Administrateurs"]
    Integr["Vos intégrations"]
    Device["Appareils gérés<br/>(RealmJoin Agent)"]

    subgraph RJ["Backend RealmJoin - Azure (Europe)"]
        direction TB
        Portal["Portail RealmJoin"]
        CustApi["Customer-API"]
        ClientApi["Client-API"]
        FD{{"Azure Front Door"}}
        CDN["CDN et serveur de packages"]
        Core[("services backend<br/>et bases de données")]
    end

    subgraph Tenant["Votre tenant Microsoft"]
        direction TB
        Graph["Entra ID / Intune / Defender<br/>(via Microsoft Graph)"]
        subgraph AzureRes["Vos ressources Azure"]
            direction TB
            KV["Key Vault<br/>(mots de passe LAPS)"]
            Autom["Azure Automation<br/>(Runbooks)"]
            LA["Log Analytics<br/>(journaux)"]
        end
    end

    Admin --> Portal
    Integr --> CustApi
    Device --> ClientApi
    Device --> FD
    FD --> CDN

    Portal --> Core
    ClientApi --> Core
    CustApi --> Core

    Core -->|accès au moindre privilège| Graph
    Core --> KV
    Core --> Autom
    Core --> LA
```

RealmJoin se connecte à votre tenant via **applications Entra ID à privilèges minimaux** auxquelles vous consentez lors de l'intégration. Chaque action effectuée par le backend est filtrée par le **modèle interne de contrôle d'accès basé sur les rôles (RBAC)** modèle, qui évalue l'appartenance aux groupes et aux rôles Entra.

## Composants du backend

Le backend est un ensemble de services déployés indépendamment et exécutés dans Microsoft Azure :

| Composant                      | Rôle                                                                                                                                             | Qui s'y connecte                                                                                     |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| **Portail RealmJoin**          | L'interface web que les administrateurs utilisent pour gérer les applications, les appareils, les utilisateurs, les groupes et l'automatisation. | Les administrateurs, via une connexion Entra ID (OAuth 2.0 / OpenID Connect).                        |
| **Client-API**                 | Le point de terminaison auquel l'agent RealmJoin optionnel sur chaque appareil communique.                                                       | Appareils gérés, authentifiés par l'identité de l'appareil (jeton Entra + certificat de l'appareil). |
| **Customer-API**               | Une API programmatique pour vos propres intégrations et votre automatisation.                                                                    | Vos systèmes et outils, à l'aide d'une clé API par client.                                           |
| **CDN et serveur de packages** | Distribue les packages d'applications et le contenu aux appareils.                                                                               | Appareils gérés.                                                                                     |

Derrière cela, RealmJoin exécute des services de traitement en arrière-plan et stocke les données dans des bases de données et du stockage Azure gérés. Les services accessibles en interne (tels que la facturation et les tâches d'arrière-plan) ne sont pas accessibles depuis Internet.

## L'agent RealmJoin

L'agent RealmJoin est un **facultatif** composant Windows. Une fois installé, il :

* rapporte régulièrement l'état de l'appareil à la Client-API,
* récupère une **signée** configuration de l'appareil (affectations de logiciels et de stratégies),
* exécute une **évaluation de sécurité** (chiffrement, niveau de correctifs, pare-feu, antivirus) avant d'appliquer les applications obligatoires,
* distribue efficacement les applications à l'aide d'un moteur Chocolatey amélioré ainsi que **BranchCache** de la distribution pair à pair,
* prend en charge **LAPS** (mot de passe administrateur local) — les mots de passe sont générés sur l'appareil et stockés dans **votre propre Azure Key Vault**.

```mermaid
sequenceDiagram
    participant Device as RealmJoin Agent
    participant API as Client-API
    participant CDN as RealmJoin CDN

    Device->>API: Signaler l'état et demander la configuration
    API-->>Device: Configuration signée (applications et stratégies)
    Device->>Device: Évaluation de sécurité
    Device->>CDN: Télécharger les packages assignés
    Note over Device: Partage de packages de pair à pair via BranchCache
```

Pour plus de détails sur la distribution des packages et BranchCache, voir [Considérations d'infrastructure](https://docs.realmjoin.com/fr/deploiement/infrastructure.md).

## Automatisation des processus (runbooks)

Les runbooks s'exécutent dans **votre propre compte Azure Automation** — et non dans le backend de RealmJoin. RealmJoin synchronise votre bibliothèque de runbooks avec un dépôt GitHub ouvert et sélectionné, et gère et supervise l'exécution des tâches depuis le Portail. Les runbooks agissent via l' **identité gérée**, de sorte que les autorisations qu'ils utilisent restent entièrement sous votre contrôle.

Voir [Connexion à Azure Automation](https://docs.realmjoin.com/fr/automatisation/connecting-azure-automation.md) et [Runbooks](https://docs.realmjoin.com/fr/automatisation/runbooks.md) pour en savoir plus.

## Distribution des applications

Les packages sont produits par le pipeline de packaging de RealmJoin et livrés aux appareils via le **CDN** et **serveur de packages**, avec un stockage géorépliqué et BranchCache pour une distribution efficace au sein du réseau. Les applications peuvent être distribuées soit via **déploiement RealmJoin** (via l'Agent) ou en tant que **déploiement Intune** (un package intunewin envoyé à votre tenant).

## Ressources dans votre propre environnement

Plusieurs fonctionnalités utilisent des ressources dans **votre propre tenant Microsoft et votre abonnement Azure**, de sorte que les données sensibles restent sous votre contrôle :

* **Azure Key Vault** – stocke les mots de passe administrateur locaux LAPS générés sur vos appareils.
* **Azure Automation** – exécute vos runbooks sous une identité gérée que vous contrôlez.
* **Log Analytics** – stocke les journaux d'audit et les journaux archivés des runbooks.

RealmJoin y accède — ainsi qu'à Entra ID, Intune et Defender via Microsoft Graph — en utilisant uniquement les autorisations au moindre privilège que vous accordez lors de l'intégration. Voir [Permissions requises du portail](https://docs.realmjoin.com/fr/deploiement/required-permissions.md) pour la liste complète.

## Sécurité, hébergement et résidence des données

* **Hébergement :** Tous les services backend s'exécutent dans **Microsoft Azure**, principalement dans la **région West Europe** avec sauvegarde dans **North Europe**. **Les données client ne quittent pas l'Europe.**
* **Livraison :** Le Portail et les API sont accessibles directement via HTTPS. Les packages d'applications et le contenu sont distribués via le RealmJoin **CDN**, placé en frontal par **Azure Front Door** pour une distribution répartie mondialement par équilibrage de charge.
* **Chiffrement en transit :** Toutes les connexions utilisent HTTPS/TLS.
* **Identité :** L'accès administrateur utilise Entra ID (OAuth 2.0 / OpenID Connect) ; les appareils s'authentifient avec leur identité d'appareil Entra et un certificat d'appareil ; les API programmatiques utilisent des clés par client.
* **Isolation du tenant :** Les données de chaque client sont séparées, et tous les parcours de code du backend s'exécutent dans un contexte par tenant.
* **Moindre privilège :** Les applications Entra de RealmJoin ne demandent que les autorisations nécessaires aux fonctionnalités que vous activez, et toutes les actions sont régies par le modèle RBAC interne de RealmJoin.
* **Résilience :** Infrastructure redondante avec basculement automatisé et restauration ponctuelle de la base de données ; l'infrastructure est entièrement définie en tant que code (Terraform).

{% hint style="info" %}
Les points de terminaison accessibles de l'extérieur sont le **Portail, Client-API, Customer-API, CDN et serveur de packages**. Pour la liste complète des hôtes à autoriser dans votre pare-feu, voir [Considérations d'infrastructure](https://docs.realmjoin.com/fr/deploiement/infrastructure.md). Pour plus de détails sur le traitement des données et la séparation des tenants, voir [Sécurité et confidentialité](https://docs.realmjoin.com/fr/securite-et-confidentialite/security-and-privacy.md).
{% endhint %}


---

# 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/fr/deploiement/architecture-overview.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.
