> 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/es/despliegue/architecture-overview.md).

# Resumen de la arquitectura

Una vista general de alto nivel de la arquitectura de RealmJoin: el backend en la nube, cómo se conectan los dispositivos administrados y los administradores, y qué recursos usa RealmJoin en tu propio Tenant de Microsoft.

RealmJoin es un SaaS nativo de la nube, multi-tenant, y el **compañero de ciclo de vida y gestión de aplicaciones para Microsoft Intune**. Gestiona la implementación de aplicaciones, la administración de usuarios/grupos/dispositivos y la automatización de procesos en todo tu Tenant de Entra ID — **sin servidores locales ni infraestructura local**. Todos los servicios de backend son operados por glueckkanja en **Microsoft Azure, alojado en Europa**.

RealmJoin cubre tres áreas:

* **Administración de aplicaciones** – empaquetado, implementación, un catálogo de autoservicio e informes de software.
* **Administración de usuarios, grupos y dispositivos** – una vista única y unificada que combina datos de Intune, Entra ID, Microsoft Defender, Windows Autopilot y registros de inicio de sesión.
* **Automatización de procesos** – runbooks que se ejecutan en *tu propia* cuenta de Azure Automation.

## La visión general

```mermaid
%%{init: {"flowchart": {"htmlLabels": false, "nodeSpacing": 55, "rankSpacing": 90}} }%%
flowchart LR
    Admin["Administradores"]
    Integr["Tus integraciones"]
    Device["Dispositivos administrados<br/>(RealmJoin Agent)"]

    subgraph RJ["Backend de RealmJoin - Azure (Europa)"]
        direction TB
        Portal["Portal de RealmJoin"]
        CustApi["Customer-API"]
        ClientApi["Client-API"]
        FD{{"Azure Front Door"}}
        CDN["CDN y servidor de paquetes"]
        Core[("Servicios de backend<br/>y bases de datos"]
    end

    subgraph Tenant["Tu Tenant de Microsoft"]
        direction TB
        Graph["Entra ID / Intune / Defender<br/>(a través de Microsoft Graph)"]
        subgraph AzureRes["Tus recursos de Azure"]
            direction TB
            KV["Key Vault<br/>(contraseñas de LAPS)"]
            Autom["Azure Automation<br/>(runbooks)"]
            LA["Log Analytics<br/>(registros)"]
        end
    end

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

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

    Core -->|acceso con mínimos privilegios| Graph
    Core --> KV
    Core --> Autom
    Core --> LA
```

RealmJoin se conecta a tu Tenant a través de **aplicaciones de Entra ID con mínimos privilegios** que autorizas durante la incorporación. Cada acción que realiza el backend se filtra a través del RealmJoin **modelo interno de control de acceso basado en roles (RBAC)** que evalúa la pertenencia a grupos y roles de Entra.

## Componentes del backend

El backend es un conjunto de servicios desplegados de forma independiente que se ejecutan en Microsoft Azure:

| Componente                     | Propósito                                                                                                                  | Quién se conecta a él                                                                                                          |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Portal de RealmJoin**        | La interfaz web que usan los administradores para gestionar aplicaciones, dispositivos, usuarios, grupos y automatización. | Administradores, mediante el inicio de sesión de Entra ID (OAuth 2.0 / OpenID Connect).                                        |
| **Client-API**                 | El punto de conexión con el que se comunica el RealmJoin Agent opcional en cada dispositivo.                               | Dispositivos administrados, autenticados mediante la identidad del dispositivo (token de Entra + certificado del dispositivo). |
| **Customer-API**               | Una API programática para tus propias integraciones y automatización.                                                      | Tus sistemas y herramientas, usando una clave de API por cliente.                                                              |
| **CDN y servidor de paquetes** | Entrega paquetes de aplicaciones y contenido a los dispositivos.                                                           | Dispositivos administrados.                                                                                                    |

Detrás de esto, RealmJoin ejecuta servicios de procesamiento en segundo plano y almacena datos en bases de datos y almacenamiento administrados de Azure. Los servicios internos (como la facturación y los trabajos en segundo plano) no son accesibles desde Internet.

## El RealmJoin Agent

El RealmJoin Agent es un **opcional** componente de Windows. Cuando se instala:

* informa del estado del dispositivo al Client-API de forma periódica,
* recupera una **firmada** configuración del dispositivo (asignaciones de software y directivas),
* ejecuta una **evaluación de seguridad** (cifrado, nivel de parches, firewall, antivirus) antes de aplicar las aplicaciones obligatorias,
* entrega aplicaciones de forma eficiente usando un motor mejorado de Chocolatey más **BranchCache** distribución entre pares,
* admite **LAPS** (contraseña de administrador local) — las contraseñas se generan en el dispositivo y se almacenan en **tu propio Key Vault de Azure**.

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

    Device->>API: Informar del estado y solicitar configuración
    API-->>Device: Configuración firmada (aplicaciones y directivas)
    Device->>Device: Evaluación de seguridad
    Device->>CDN: Descargar paquetes asignados
    Note over Device: Compartición de paquetes entre pares mediante BranchCache
```

Para más detalles sobre la entrega de paquetes y BranchCache, consulta [Consideraciones de infraestructura](https://docs.realmjoin.com/es/despliegue/infrastructure.md).

## Automatización de procesos (runbooks)

Los runbooks se ejecutan en **tu propia cuenta de Azure Automation** — no en el backend de RealmJoin. RealmJoin mantiene sincronizada tu biblioteca de runbooks con un repositorio abierto y curado de GitHub, y gestiona y supervisa la ejecución de trabajos desde el Portal. Los runbooks actúan a través de la **identidad administrada**, por lo que los permisos que usan permanecen totalmente bajo tu control.

Consulta [Conexión de Azure Automation](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation.md) y [Runbooks](https://docs.realmjoin.com/es/automatizacion/runbooks.md) para más información.

## Entrega de aplicaciones

Los paquetes son generados por el flujo de empaquetado de RealmJoin y se entregan a los dispositivos a través del RealmJoin **CDN** y **Servidor de paquetes**, con almacenamiento geo-replicado y BranchCache para una distribución eficiente dentro de la red. Las aplicaciones pueden entregarse ya sea mediante **Implementación de RealmJoin** (a través del Agent) o como **Implementación de Intune** (un paquete intunewin enviado a tu Tenant).

## Recursos en tu propio entorno

Varias capacidades usan recursos en **tu propio Tenant de Microsoft y suscripción de Azure**, por lo que los datos sensibles permanecen bajo tu control:

* **Azure Key Vault** – almacena las contraseñas de administrador local de LAPS generadas en tus dispositivos.
* **Azure Automation** – ejecuta tus runbooks bajo una identidad administrada que tú controlas.
* **Log Analytics** – almacena los registros de auditoría y los registros archivados de runbooks.

RealmJoin accede a estos — y a Entra ID, Intune y Defender a través de Microsoft Graph — usando solo los permisos de mínimos privilegios que otorgas durante la incorporación. Consulta [Permisos requeridos del portal](https://docs.realmjoin.com/es/despliegue/required-permissions.md) para la lista completa.

## Seguridad, alojamiento y residencia de los datos

* **Alojamiento:** Todos los servicios de backend se ejecutan en **Microsoft Azure**, principalmente en la región de **West Europe** con respaldo en **North Europe**. **Los datos de los clientes no salen de Europa.**
* **Entrega:** Se accede directamente al Portal y a las APIs por HTTPS. Los paquetes y el contenido de las aplicaciones se entregan a través del RealmJoin **CDN**, situado delante de **Azure Front Door** para una distribución global con balanceo de carga.
* **Cifrado en tránsito:** Todas las conexiones usan HTTPS/TLS.
* **Identidad:** El acceso de administrador usa Entra ID (OAuth 2.0 / OpenID Connect); los dispositivos se autentican con su identidad de dispositivo de Entra y un certificado de dispositivo; las APIs programáticas usan claves por cliente.
* **Aislamiento del Tenant:** Los datos de cada cliente están separados, y todas las rutas de código del backend operan dentro de un contexto por Tenant.
* **Mínimos privilegios:** Las aplicaciones de Entra de RealmJoin solicitan solo los permisos necesarios para las funciones que habilitas, y todas las acciones se rigen por el modelo interno RBAC de RealmJoin.
* **Resiliencia:** Infraestructura redundante con conmutación por error automatizada y recuperación puntual de bases de datos; la infraestructura está totalmente definida como código (Terraform).

{% hint style="info" %}
Los puntos de conexión accesibles externamente son el **Portal, Client-API, Customer-API, CDN y Package Server**. Para la lista completa de hosts que debes permitir en tu firewall, consulta [Consideraciones de infraestructura](https://docs.realmjoin.com/es/despliegue/infrastructure.md). Para obtener más detalles sobre el tratamiento de datos y la separación de tenants, consulta [Seguridad y privacidad](https://docs.realmjoin.com/es/seguridad-y-privacidad/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/es/despliegue/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.
