メインコンテンツへスキップ
SCIMプロビジョニングは Enterprise プランでご利用いただけます。ディレクトリ連携（Microsoft Graph）は Teams および Enterprise プランでご利用いただけます。どちらも組織レベルの機能で、管理者が設定します。
Microsoft Entra ID（旧Azure Active Directory）をWave Connectに接続する方法は2つあります。どちらもディレクトリからWave Connectユーザーを作成・更新します。異なるのは、同期されるユーザーの範囲、オフボーディングの仕組み、そして接続を維持するものです。

どちらを使うべきですか？

SCIMプロビジョニングは、アプリをEntra IDと同期させるためにMicrosoftが推奨する方法です。Graph連携は、Teamsプランの場合や1回限りのインポートの場合にのみ選択してください。

SCIMプロビジョニングをセットアップする

1

Wave ConnectでSCIMトークンを作成する

設定 → セキュリティ に移動し、ディレクトリ同期 カードを見つけます。構成 をクリックして SCIMの構成 モーダルを開きます。SCIM エンドポイント（https://app.wavecnct.com/api/scim）をコピーし、トークンを作成 をクリックします。トークンに名前を付けて 作成 をクリックします。トークンはこの時点でコピーしてください。表示されるのは一度のみです。
2

エンタープライズ アプリケーションを作成する

Microsoft Entra管理センターで、エンタープライズ アプリケーション → 新しいアプリケーション → 独自のアプリケーションの作成 に移動します。「Wave Connect」などの名前を入力し、ギャラリーに見つからないその他のアプリケーションを統合します (ギャラリー以外) を選択して、作成 をクリックします。
3

SCIM資格情報を入力する

新しいアプリケーションを開き、プロビジョニング → 開始する に移動します。プロビジョニング モード を 自動 に設定します。管理者資格情報 で、テナント URL にSCIMエンドポイントを、シークレット トークン にトークンを貼り付けます。接続テスト をクリックし、次に 保存 をクリックします。
4

属性マッピングを確認する

マッピング で Provision Microsoft Entra ID Users を開き、以下の表と比較します。Entraの既定値でほとんどの行はカバーされています。編集が必要なのはプライマリ メール、locale、externalId の行のみです。EntraグループをWave Connectのチームにしたい場合は、Provision Microsoft Entra ID Groups を有効のままにします。
5

ユーザーとグループを割り当てる

ユーザーとグループ に移動し、Wave Connectアカウントを持つべきユーザーとグループを割り当てます。割り当てられたユーザーのみがプロビジョニングされます。
6

プロビジョニングを開始する

プロビジョニング に戻り、プロビジョニングの状態 を オン に設定して 保存 をクリックするか、プロビジョニングの開始 をクリックします。Entraは初回サイクルを実行し、その後は約40分ごとに増分サイクルを実行します。待たずに1人のユーザーを確認するには、オンデマンドでプロビジョニングする を使用します。

属性マッピング

Wave Connectは以下のSCIM属性を読み取ります。Wave Connectフィールド 列は、各値の保存先を示します。
Entraの既定のマッピングは、userName、name.givenName、name.familyName、title、電話番号、addresses[type eq "work"].locality、active をすでにカバーしています。編集が必要なのは3行のみです。仕事用メールのマッピングで primary が True に設定されていることを確認し、preferredLanguage のターゲットを preferredLanguage から locale に変更し、externalId のソースを mailNickname から objectId に変更します。
マッピングに関するその他の注意点：
  • 電話番号は検証され、国際形式で保存されます。プレースホルダーや内線番号のみの値は、同期を失敗させる代わりに破棄されます。
  • roles[].value を USER、ADMIN、OWNER（大文字）に設定すると、組織の役割が設定されます。Entraは既定では役割を送信しないため、新しいユーザーは一般ユーザーとして作成されます。
  • エンタープライズ拡張の department はプロフィールに保存されません。部署ベースのチーム割り当てはWave Connectサポートが有効化できます。
  • locale の値はWave Connectがサポートする言語のいずれかである必要があります。そうでない場合、ユーザーの言語は英語になります。

グループがチームになる

グループのプロビジョニングが有効な場合、アプリケーションに割り当てられた各EntraグループはWave Connectのチームになります。グループの displayName がチーム名になり、グループの objectId がチームの外部IDとして保存されます。同じ名前のチームがWave Connectにすでに存在する場合、グループはそのチームに統合されます。 Wave Connectユーザーは1つのチームに所属します。ユーザーが複数の割り当て済みグループに含まれている場合、Entraが最後にプロビジョニングしたグループが優先されます。1つの組織は最大75チームまで持つことができます。Entraでグループを削除すると、Wave Connectのチームも削除されます。そのユーザーは保持され、連絡先は組織に移動されます。 各チームには異なるテンプレートを割り当てることができるため、異なるグループのユーザーは適切なカードレイアウト、ブランディング、ロックされたフィールドを自動的に取得します。テンプレートをご覧ください。

オフボーディング

Entraでユーザーがアプリケーションから割り当て解除、無効化、または論理削除されると、プロビジョニング サービスは active = false を送信します。Wave Connectはユーザーを無効化します：
  • ログインできなくなり、セッションが取り消されます。
  • ユーザー に SUSPENDED バッジ付きで表示されます。
  • NFCカード、プロフィール、連絡先は保持されます。
  • 引き続きシートとしてカウントされます。
Entraは論理削除されたユーザーを30日間保持し、その後削除リクエストを送信します。Wave Connectはその時点でユーザーを完全に削除し、プロフィールと連絡先を削除し、NFCカードのリンクを解除して別の人に割り当てられるようにします。 30日間の猶予期間が不要な場合は、設定 → セキュリティ → ディレクトリ同期 → 構成 を開き、停止せずにユーザーを直ちに削除 を有効にします。これにより、無効化の時点でユーザーが直ちに完全に削除されます。 無効化されたユーザーを復帰させるには、Entraでユーザーをアプリケーションに再度割り当てます。次のプロビジョニング サイクルで active = true が送信され、アカウントが再有効化されます。
同じエンタープライズ アプリケーションでシングルサインオンを有効にすることもできます。シングルサインオン（SAML）をご覧ください。

ディレクトリ連携（Microsoft Graph）

ディレクトリ連携は、管理者のアカウントを使用してMicrosoft Graph API経由でWave Connectをテナントに接続します。SCIMよりセットアップは簡単ですが、テナント全体を同期し、接続した管理者アカウントに依存します。

接続方法

入り口は2つあります。どちらも同じ連携を作成しますが、ディレクトリの変更を自動的に適用するスイッチである ユーザー同期 の既定値が異なります。
  1. 統合 → Microsoft Entra ID に移動し、アプリをインストール をクリックします。
  2. Microsoft Entra IDから新しいユーザーを自動的にインポート をオンのままにするか、手動インポートのみを行いたい場合はオフにします。続行 をクリックします。
  3. テナントで管理者の同意を付与できるMicrosoftアカウントでサインインし、同意のプロンプトを承認します。
このスイッチがオンの場合、変更通知が届くたびにテナント内のすべてのユーザーがWave Connectに作成され、以降の変更は自動的に適用されます。これは連携の 設定 に ユーザー同期 として表示されます。
ユーザー同期 がオンの場合、この連携はゲストを含むテナント内のすべてのユーザーに対してWave Connectユーザーとシートを追加します。グループに限定する方法はありません。

権限

Wave Connectは、接続する管理者のアカウントに対して委任されたスコープ openid、offline_access、profile、User.Read.All、Directory.Read.All を要求します。Wave Connectはディレクトリの読み取りのみを行います。Entraへの書き込みは一切行いません。 連携はその管理者の更新トークンで動作します。トークンが取り消された場合（たとえば、管理者が退職した、セッションの取り消しを伴うパスワードリセットが行われた、条件付きアクセス ポリシーが更新をブロックしたなど）、Wave Connectは連携を削除し、管理者が再接続する必要があります。

同期されるデータ

同期方向：Entra ID → Wave Connect（インバウンドのみ）。 プロフィール写真は手動インポートまたはプレビュー時にのみ取得され、Wave Connectにコピーとして保存されます。ユーザー同期 によって作成されたユーザーには写真が設定されません。

ユーザー同期と無効化

接続後、Wave ConnectはユーザーのMicrosoft Graph変更通知（作成、更新、削除）をサブスクライブします。サブスクリプションの有効期間は3日間で、Graphのライフサイクル通知から自動的に更新されます。ユーザー同期 がオフの間、通知は無視されます。 Entraでユーザーが削除されるか、アカウントが無効化（accountEnabled = false）されると、Wave Connectはそのユーザーを無効化します。ログインがブロックされ、ユーザー に SUSPENDED バッジ付きで表示され、カード、プロフィール、連絡先は保持されます。引き続きシートとしてカウントされます。Entraでアカウントを再度有効にしても、Wave Connectでは再有効化されません。ユーザーを再有効化するには support@wavecnct.com にお問い合わせいただくか、ユーザー からユーザーを削除してください。

制限事項

  • テナント全体が同期されます。ゲストも含まれます。割り当てによる範囲指定はありません。
  • Entraのグループと部署は同期されません。チームはWave Connectで管理する必要があります。
  • ユーザー同期 によって作成されたユーザーには写真が設定されません。
  • 接続は1つの管理者アカウントに依存し、そのアカウントのトークンが取り消されると削除されます。
  • 連携によってユーザーが削除されることはなく、無効化のみが行われます。

切断する

統合 → Microsoft Entra ID → 設定 に移動し、接続解除 をクリックします。これによりWave Connectに保存された接続が削除されます。Microsoft側では何も取り消されず、Graphサブスクリプションは3日以内に自然に期限切れになります。既存のWave Connectユーザーは保持されますが、以降は更新されません。Microsoft側でWave Connectのアクセスを削除するには、Entra管理センターでエンタープライズ アプリケーションの同意を取り消します。

両方を使用する

SCIMとGraph連携は同時に有効にできます。その場合、SCIMでプロビジョニングされたユーザーは、メールアドレスで照合されたGraph接続からプロフィール写真を取得します。 SCIMを使用する場合は、Graph連携の ユーザー同期 をオフにしてください。オンにすると、Graph連携がテナント内のすべてのユーザーを作成し、エンタープライズ アプリケーションで設定した割り当ての範囲指定が回避されてしまいます。

トラブルシューティング

テナント URL が末尾のスラッシュなしで正確に https://app.wavecnct.com/api/scim であること、および シークレット トークン が SCIMの構成 モーダルで取得した完全なトークンであることを確認してください。トークンは作成時にしかコピーできないため、紛失した場合は新しいトークンを作成してください。組織がEnterpriseプランを離れるとトークンは削除されます。
Entraは約40分のサイクルでプロビジョニングを行います。そのユーザーに対して オンデマンドでプロビジョニングする を使用して直ちにプッシュし、プロビジョニング ログ で結果を確認してください。リクエストの失敗は通常、必須属性（name.givenName、name.familyName、または更新時のプライマリ メール）が欠けていることを意味します。
SCIMの場合、ユーザーはアプリケーションに割り当てられている必要があります。割り当てが解除されていた場合は再度割り当てると、Entraが active = true を送信します。Graph連携の場合、再度有効にしてもユーザーは再有効化されません。再有効化するには support@wavecnct.com にお問い合わせください。
SCIMが作成するユーザーのメールアドレスが、すでに個人（組織外）のWave Connectアカウントに属しており、そのメールドメインが確認済みドメインのいずれかである場合、新しいアカウントを作成する代わりに、そのアカウントが組織に移動されて更新されます。既存のカードと連絡先は保持されます。これらのアカウントが重複ではなく移行されるように、プロビジョニングの前にドメインを確認してください。
SCIMの場合、ログイン用メールアドレスはプライマリ メールであり、推奨マッピングでは mail から取得されます。Graph連携の場合は userPrincipalName（ゲストの場合は mail）です。ユーザーの mail とUPNが異なる場合は、両方の方法で一致するように、Entraで userPrincipalName をプライマリ メールにマッピングしてください。