> 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/ja/zhan-kai/architecture-overview.md).

# アーキテクチャの概要

RealmJoin のアーキテクチャの概要。クラウド バックエンド、管理対象デバイスと管理者がどのように接続するか、そして自分の Microsoft Tenant で RealmJoin が使用するリソースについて説明します。

RealmJoin はクラウドネイティブなマルチテナント SaaS であり、 **Microsoft Intune のアプリケーション ライフサイクルと管理のコンパニオン**。これは、Entra ID テナント全体でアプリケーションの展開、ユーザー/グループ/デバイス管理、およびプロセスの自動化を管理します — **オンプレミスのサーバーやローカルインフラは不要です**。すべてのバックエンド サービスは glueckkanja により **Microsoft Azure 上で運用され、ヨーロッパにホスティングされています**.

RealmJoin は 3 つの領域をカバーします:

* **アプリケーション管理** – パッケージ化、展開、セルフサービス カタログ、ソフトウェア レポート。
* **ユーザー、グループ、デバイスの管理** – Intune、Entra ID、Microsoft Defender、Windows Autopilot、サインイン ログのデータを統合した、単一の統合ビュー。
* **プロセスの自動化** – で実行される Runbook *お使いの* Azure Automation アカウント。

## 全体像

```mermaid
%%{init: {"flowchart": {"htmlLabels": false, "nodeSpacing": 55, "rankSpacing": 90}} }%%
flowchart LR
    Admin["管理者"]
    Integr["お使いの連携"]
    Device["管理対象デバイス<br/>(RealmJoin Agent)"]

    subgraph RJ["RealmJoin バックエンド - Azure (ヨーロッパ)"]
        direction TB
        Portal["RealmJoin ポータル"]
        CustApi["Customer-API"]
        ClientApi["Client-API"]
        FD{{"Azure Front Door"}}
        CDN["CDN および Package Server"]
        Core[("バックエンド サービス<br/>およびデータベース")]
    end

    subgraph Tenant["お使いの Microsoft テナント"]
        direction TB
        Graph["Entra ID / Intune / Defender<br/>(Microsoft Graph 経由)"]
        subgraph AzureRes["お使いの Azure リソース"]
            direction TB
            KV["Key Vault<br/>(LAPS パスワード)"]
            Autom["Azure Automation<br/>(Runbook)"]
            LA["Log Analytics<br/>(ログ)"]
        end
    end

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

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

    Core -->|最小特権アクセス| Graph
    Core --> KV
    Core --> Autom
    Core --> LA
```

RealmJoin は次を通じてお使いのテナントに接続します **最小特権の Entra ID アプリケーション** これらはオンボーディング中にお客様が同意します。バックエンドが実行するすべてのアクションは、RealmJoin の **内部のロールベースのアクセス制御 (RBAC)** モデルによって評価され、Entra のグループおよびロールのメンバーシップを判定します。

## バックエンド コンポーネント

バックエンドは、Microsoft Azure 上で稼働する個別にデプロイされたサービスの集合です:

| コンポーネント                    | 目的                                                         | 接続する対象                                              |
| -------------------------- | ---------------------------------------------------------- | --------------------------------------------------- |
| **RealmJoin Portal**       | 管理者がアプリケーション、デバイス、ユーザー、グループ、および自動化を管理するために使う Web インターフェース。 | 管理者。Entra ID サインイン (OAuth 2.0 / OpenID Connect) 経由。 |
| **Client-API**             | 各デバイス上の任意の RealmJoin Agent が通信するエンドポイント。                   | 管理対象デバイス。デバイス ID (Entra トークン + デバイス証明書) によって認証されます。 |
| **Customer-API**           | お使いの連携や自動化のためのプログラム API。                                   | お使いのシステムとツール。顧客ごとの API キーを使用します。                    |
| **CDN および Package Server** | アプリケーション パッケージとコンテンツをデバイスに配信します。                           | 管理対象デバイス。                                           |

これらの背後で、RealmJoin はバックグラウンド処理サービスを実行し、管理された Azure データベースとストレージにデータを保存します。内部向けサービス (請求処理やバックグラウンド ジョブなど) はインターネットから到達できません。

## RealmJoin Agent

RealmJoin Agent は **省略可能** Windows コンポーネントです。インストールされると、次のことを行います:

* 定期的にデバイスの状態を Client-API に報告し、
* 次を取得し **署名済みの** デバイス構成 (ソフトウェアおよびポリシーの割り当て)、
* ローカルで **セキュリティ評価** (暗号化、パッチレベル、ファイアウォール、アンチウイルス) を確認してから、必須アプリを適用し、
* 強化された Chocolatey エンジンと **BranchCache** ピアツーピア配信を使用してアプリケーションを効率的に配信し、
* サポートし、 **LAPS** (ローカル管理者パスワード) — パスワードはデバイス上で生成され、次に保存されます **お使いの Azure Key Vault**.

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

    Device->>API: 状態を報告し、構成を要求
    API-->>Device: 署名済み構成 (アプリとポリシー)
    Device->>Device: セキュリティ評価
    Device->>CDN: 割り当てられたパッケージをダウンロード
    Note over Device: BranchCache を介したピアツーピアのパッケージ共有
```

パッケージ配信と BranchCache の詳細については、 [インフラストラクチャに関する考慮事項](https://docs.realmjoin.com/ja/zhan-kai/infrastructure.md).

## プロセス自動化 (Runbook)

Runbook は次で実行されます **お使いの Azure Automation アカウント** — RealmJoin のバックエンド内ではありません。RealmJoin は、厳選された公開 GitHub リポジトリと Runbook ライブラリを同期し、Portal からジョブの実行を管理・監視します。Runbook は Automation アカウントの **マネージド ID**ため、使用される権限は完全にお客様の管理下に留まります。

参照 [Azure Automation の接続](https://docs.realmjoin.com/ja/zi-dong-hua/connecting-azure-automation.md) と [Runbooks](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks.md) 詳細は

## アプリケーション配信

パッケージは RealmJoin のパッケージ化パイプラインで作成され、RealmJoin の **CDN** と **Package Server**地理的にレプリケートされたストレージと BranchCache により、ネットワーク内で効率的に配信されます。アプリケーションは次のいずれかで配信できます: **RealmJoin Deployment** (Agent 経由) または **Intune Deployment** (intunewin パッケージとしてお使いのテナントにプッシュされます)。

## お使いの環境内のリソース

いくつかの機能は、次の環境のリソースを使用します: **お使いの Microsoft テナントと Azure サブスクリプション**ため、機密データはお客様の管理下に置かれます:

* **Azure Key Vault** – デバイス上で生成された LAPS のローカル管理者パスワードを保存します。
* **Azure Automation** – お客様が管理するマネージド ID の下で Runbook を実行します。
* **Log Analytics** – 監査ログとアーカイブされた Runbook ログを保存します。

RealmJoin は、オンボーディング時にお客様が付与する最小権限のアクセス許可のみを使用して、これら、および Microsoft Graph 経由の Entra ID、Intune、Defender にアクセスします。参照してください [Portal の必須アクセス許可](https://docs.realmjoin.com/ja/zhan-kai/required-permissions.md) で全一覧を確認してください。

## セキュリティ、ホスティング、およびデータ所在地

* **ホスティング:** すべてのバックエンド サービスは次で稼働します **Microsoft Azure**、主に次の **West Europe** リージョンで稼働し、バックアップは次の **North Europe**. **顧客データはヨーロッパ外に出ません。**
* **配信:** Portal と API には HTTPS で直接アクセスします。アプリケーション パッケージとコンテンツは RealmJoin の **CDN**によってフロントエンド化され、 **Azure Front Door** 世界規模の負荷分散配信を実現します。
* **転送中の暗号化:** すべての接続は HTTPS/TLS を使用します。
* **ID:** 管理者アクセスは Entra ID (OAuth 2.0 / OpenID Connect) を使用します。デバイスは Entra デバイス ID とデバイス証明書で認証され、プログラム API は顧客ごとのキーを使用します。
* **テナント分離:** 各顧客のデータは分離され、すべてのバックエンドのコードパスはテナントごとのコンテキストで動作します。
* **最小特権:** RealmJoin の Entra アプリケーションは、お客様が有効にした機能に必要な権限のみを要求し、すべての操作は RealmJoin の内部 RBAC モデルによって管理されます。
* **耐障害性:** 自動フェイルオーバーとポイントインタイムのデータベース復旧を備えた冗長インフラストラクチャ。インフラストラクチャは完全にコード化されています (Terraform)。

{% hint style="info" %}
外部から到達可能なエンドポイントは **Portal、Client-API、Customer-API、CDN、および Package Server**。ファイアウォールで許可するホストの全一覧については、参照してください [インフラストラクチャに関する考慮事項](https://docs.realmjoin.com/ja/zhan-kai/infrastructure.md)。データの取り扱いとテナント分離の詳細については、参照してください [セキュリティとプライバシー](https://docs.realmjoin.com/ja/sekyurititopuraibash/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/ja/zhan-kai/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.
