> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Entra ID

> 組み込みの Microsoft Entra ID 接続テンプレートを使用して、ユーザーが Microsoft の職場または学校アカウントで Iru Identity にサインインできるようにします。

**Microsoft Entra ID** を接続すると、ユーザーはすでに持っている Microsoft の職場または学校アカウントを使用して Iru にサインイン (および割り当てられたアプリにアクセス) できます。Iru には標準構成を事前入力する **Microsoft Entra ID テンプレート**が用意されているため、最も迅速に接続できるプロバイダーの 1 つです。

<Info>
  Iru Identity を ID プロバイダーとして使用しているほとんどの組織では、ユーザーはパスキーまたは Iru Access アプリで直接サインインします。Iru Identity をプライマリ ID プロバイダーではなく Iru プラットフォームへの認証レイヤーとして使用する場合、または Iru Identity への移行を容易にする場合に Microsoft Entra ID を接続します。[フェデレーション認証](/ja/identity/connections/connections-overview)を参照してください。
</Info>

<Note>
  この接続を完了するには、Iru テナントの管理者アクセス権と Microsoft Entra 管理センターへのアクセス権が必要です。
</Note>

## 始める前に

<Steps>
  <Step title="Microsoft Entra ID にアプリケーションを登録する">
    Microsoft Entra 管理センターで、Iru 用の**アプリケーションを登録**します。Iru がこの接続に表示する**リダイレクト URI** を Web リダイレクト URI として追加し、**クライアントシークレット**を作成して、標準のサインインアクセス許可 (`openid`、`profile`、`email`、`User.Read`) を付与します。テナントで必要な場合は管理者の同意を付与します。Iru に入力するため、アプリケーションの**クライアント ID** と**クライアントシークレット**、および Entra ID の**ドメイン** (例: `contoso.onmicrosoft.com`) を控えておきます。Microsoft のポータルは変更される可能性があるため、手順が異なる場合は Microsoft の最新のドキュメントに従ってください。
  </Step>

  <Step title="サインインドメインを確認する">
    ユーザーがサインインに使用するメール**ドメイン**を控えておきます。接続をこれらのドメインに制限して、それらのドメインのユーザーのみが使用できるようにすることができます。
  </Step>

  <Step title="ユーザーが Iru に存在することを確認する">
    接続を通じたサインインは、既存の Iru ユーザーに解決されます。最初にユーザーを追加またはインポートしてください。[ユーザーのインポート](/ja/identity/directory/importing-users)または [Directory Sync](/ja/identity/directory/directory-sync) を参照してください。
  </Step>
</Steps>

## Microsoft Entra ID を接続する

<Steps>
  <Step title="接続を追加する">
    **Access → Authentication** で **authentication method** を追加し、**Microsoft Entra ID** テンプレートを選択します。テンプレートを使用すると、標準設定が自動的に入力されます。
  </Step>

  <Step title="Entra ID の詳細を入力する">
    Microsoft Entra ID の**ドメイン**、登録したアプリケーションの**クライアント ID** と**クライアントシークレット**を入力します。Iru はこれらを使用して Entra ID テナントとの信頼を確立します。
  </Step>

  <Step title="接続の用途を選択する">
    接続の**ユースケース**として、**エンドユーザーのサインイン**、**デバイス登録**、またはその両方を選択します。ほとんどの構成ではエンドユーザーのサインインを有効にします。
  </Step>

  <Step title="ドメインを制限する">
    特定のメールドメインのユーザーのみにこの接続を使用させたい場合は、**ドメイン制限**を有効にしてそれらのドメインを追加します。
  </Step>

  <Step title="ユーザーマッチングを設定する">
    Iru が Microsoft のサインインを Iru ユーザーと照合する方法 (UPN、ユーザー名、外部 ID、またはカスタム属性) を選択します。すべてのユーザーで一意かつ安定した値を選択してください。
  </Step>

  <Step title="接続を保存する">
    保存してから、許可されたドメインのメールアドレスを持つテストユーザーとしてサインインし、Microsoft への引き渡しがエンドツーエンドで機能することを確認します。
  </Step>
</Steps>

<Warning>
  この接続を**デバイス登録**に使用する場合は、最初に**ドメイン制限**を有効にする必要がある場合があります。デバイス登録のユースケースを有効にする前にドメインを構成してください。
</Warning>

<Tip>
  接続を広く展開する前に、1 人のユーザーでテストしてください。サインインが正しいユーザーに解決されない場合は、**ユーザーマッチング**の選択を見直してください。照合される値は、接続を使用するすべてのユーザーに存在し、一意である必要があります。
</Tip>

## 接続後のサインインの仕組み

ユーザーがサインインすると、Iru はサインインを Microsoft Entra ID に引き渡し、Entra ID がユーザーを確認します。Iru はセッションを続行し、アクセスを許可する前にアプリの[認証ポリシー](/ja/identity/authentication/authentication-policies)を評価します。全体像については、[システムアーキテクチャ](/ja/identity/getting-started/system-architecture)を参照してください。

## 関連情報

<CardGroup cols={2}>
  <Card title="フェデレーション認証" icon="plug" href="/ja/identity/connections/connections-overview">
    ユースケース、ドメイン制限、ユーザーマッチングを 1 か所で説明します。
  </Card>

  <Card title="Google Workspace" icon="google" href="/ja/identity/connections/google-workspace">
    専用のテンプレートを使用して、サインイン用に Google Workspace を接続します。
  </Card>

  <Card title="サインインエクスペリエンス" icon="arrow-right-to-bracket" href="/ja/identity/authentication/sign-in-experience">
    サインイン時にユーザーに表示される内容を設定します。
  </Card>

  <Card title="カスタム OIDC" icon="key" href="/ja/identity/connections/custom-oidc">
    テンプレートでカバーされていない OpenID Connect プロバイダーを接続します。
  </Card>
</CardGroup>