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

# Microsoft Entra ID

> WaveチームディレクトリをEntra ID（Azure AD）と同期させる

<Info>
  **Teams** および **Enterprise** プランでご利用いただけます。これは管理者が設定する組織レベルの連携です。
</Info>

Microsoft Entra ID連携は、WaveチームディレクトリをMicrosoft Entra ID（旧Azure Active Directory）テナントと同期させます。新規入社、役割更新、退職を含む従業員の変更が、Microsoft Graphの変更通知を通じてリアルタイムでWaveに反映されます。

## 接続方法

<Steps>
  <Step title="連携を開く">
    **Integrations → Microsoft Entra ID**（管理者のみ）に移動します。
  </Step>

  <Step title="管理者アカウントで接続する">
    **Connect** をクリックし、Azureテナントへの管理者アクセスを持つMicrosoftアカウントでサインインします。
  </Step>

  <Step title="Waveを承認する">
    Waveがディレクトリを読み取ることを承認します。
  </Step>

  <Step title="自動同期を有効にする">
    **Auto-sync** をオンにすると、今後のすべてのディレクトリ変更がWaveに自動的に適用されます。手動で同期を管理することもできます。
  </Step>
</Steps>

Waveは認証・トークン更新の権限と、ユーザープロフィールおよびディレクトリメンバーの読み取りアクセスを要求します。

## 同期されるデータ

| Entra IDフィールド                        | Waveユーザーフィールド     |
| ------------------------------------ | ----------------- |
| 名前（名）、名前（姓）、表示名                      | 名前                |
| 仕事用メール（`mail` / `userPrincipalName`） | メール               |
| 携帯電話                                 | 携帯電話              |
| 仕事用電話                                | 仕事用電話             |
| 役職                                   | 役職                |
| 市区町村・オフィスの所在地                        | 市区町村              |
| 言語設定                                 | 言語                |
| プロフィール写真                             | アバター（Wave経由でプロキシ） |

**同期方向**：Entra ID → Wave（インバウンドのみ）

**タイミング**：Microsoft Graphサブスクリプション（Webhook）によるリアルタイム、およびオンデマンドの手動更新

## 機能

* **リアルタイム同期**：Microsoft Graphの変更通知を通じて、従業員の変更が数分以内にWaveに反映されます。
* **自動無効化**：Entra IDから従業員が削除されると、そのWaveアカウントが無効化されます。
* **プロフィール写真**：Entraから写真を取得してWave経由でプロキシするため、Microsoftへのログインなしに読み込まれます。
* **サブスクリプションの自動更新**：Microsoft GraphのWebhookサブスクリプションは定期的に期限切れになります。Waveは自動的に更新するため、接続が維持されます。
* **インポートプレビュー**：自動同期を有効にする前に、すべてのEntra IDユーザーを確認できます。

## 制限事項と要件

* UPNに `#EXT#` を含むゲストユーザーは、`mail` フィールドからメールアドレスが取得されます。
* これは組織レベルの連携です。個々のチームメンバーが個別に接続する必要はありません。
* 管理者の同意を持つAzure Active Directoryテナントが必要です。

## 切断する

**Integrations → Microsoft Entra ID** に移動して **Disconnect** をクリックします。これにより連携が削除され、WaveのアクセスとGraphサブスクリプションの登録が取り消されます。既存のWaveユーザーは削除されません。