メインコンテンツへスキップ
Enterprise プランでご利用いただけます。ディレクトリ同期を設定できるのは組織のオーナーのみです。

概要

SCIM(System for Cross-domain Identity Management)2.0はWave ConnectをIDプロバイダーに接続し、ユーザーアカウントを自動的に管理します。IdPでユーザーを追加、更新、削除すると、手動操作なしにWave Connectにも変更が反映されます。 Wave Connectは、SCIMの Users および Groups リソースを GET、POST、PUT、PATCH、DELETE で公開しています。フィルターは単一のトップレベル eq 比較をサポートしており、これはIDプロバイダーが userName または externalId でユーザーを検索する際に使用するものです。

セットアップ

1

ディレクトリ同期を開く

設定 → セキュリティ に移動します。ディレクトリ同期 カードで 構成 をクリックし、SCIMの構成 モーダルを開きます。
2

SCIMエンドポイントをコピーする

SCIM エンドポイント は https://app.wavecnct.com/api/scim です。これをコピーします。IDプロバイダーではテナントURLまたはベースURLと呼ばれます。
3

SCIMトークンを作成する

トークンを作成 をクリックし、トークンに名前を付けて 作成 をクリックします。トークンはすぐにコピーしてください。表示されるのは一度のみです。トークンはIdPからベアラートークンとして送信されます。
4

IDプロバイダーを設定する

IdPで、エンドポイントとトークンを使用してWave Connectの自動プロビジョニングを設定します。ユーザー属性を以下のSCIM属性にマッピングします。
5

プロビジョニングをテストする

IdPでテストユーザーを割り当て、そのWave Connectアカウントが正しい名前、メールアドレス、チームで ユーザー に表示されることを確認します。
SCIMトークンは 設定 → セキュリティ の トークン カードにも SCIMの管理 スコープ付きで表示されます。そこでトークンを削除すると、IdPからのアクセスを遮断できます。組織がEnterpriseプランを離れると、トークンは自動的に削除されます。

IDプロバイダーガイド

Microsoft Entra ID

エンタープライズ アプリケーションのセットアップ、属性マッピング、オフボーディングの手順ガイド。

OktaとGoogle Workspace

このページの一般的な手順に従ってください。エンドポイントをベースURLとして、トークンをベアラートークンとして使用します。

属性マッピング

Wave ConnectはSCIMの User リソースから以下の属性を読み取ります: 電話番号は検証され、国際形式で保存されます。無効な値や内線番号のみのプレースホルダーは、リクエストを失敗させる代わりに破棄されます。Wave Connectがサポートしていない locale は英語にフォールバックします。 エンタープライズ拡張の department はプロフィールに保存されません。部署ベースのチーム割り当てはWave Connectサポートが有効化できます。 ユーザーの作成時に、そのメールアドレスがすでに組織のメンバーに属している場合は、新規作成の代わりに既存のメンバーが更新されます。メールアドレスが確認済みドメインのいずれかにある個人のWave Connectアカウントに属している場合、そのアカウントはカードと連絡先を含めてそのまま組織に移動されます。

チームマッピング

SCIMが有効になると、IDプロバイダーのグループがWave Connectのチームとして同期されます。たとえば、Microsoft Entra IDでWave Connectアプリケーションに割り当てられたグループは、Wave Connectのチームとして自動的に作成されます。グループに割り当てられたメンバーは対応するチームに追加されます。 グループの displayName がチーム名になり、グループの externalId がチームに保存されます。同じ名前のチームがすでに存在する場合、グループはそのチームに統合されます。ユーザーは1つのチームに所属するため、ユーザーが複数のグループに含まれている場合は最後にプロビジョニングされたグループが優先されます。1つの組織は最大75チームまで持つことができます。グループを削除するとチームも削除されます。そのユーザーは保持され、連絡先は組織に移動されます。 これにより、Wave Connectで手動のチーム設定を行うことなく、IdPから直接Wave Connectのチーム構造を管理できます。 各Wave Connectチームには異なるテンプレートを割り当てることができるため、異なるグループのユーザーは部署や役割に応じた適切なカードレイアウト、ブランディング、ロックされたフィールドを自動的に取得します。詳細についてはテンプレートをご覧ください。

デプロビジョニング

IdPでユーザーがWave Connectアプリケーションから割り当て解除されると、IdPは active を false に設定します。Wave Connectはアカウントを 無効化 します:
  • ユーザーはログインできなくなり、セッションが取り消されます。
  • ユーザー に SUSPENDED バッジ付きで表示されます。
  • NFCカードはリンクされたままで、プロフィールと連絡先は保持されます。
  • 削除されるまで引き続きシートとしてカウントされます。
active を true に戻す(たとえばユーザーを再度割り当てる)と、アカウントが再有効化されます。 IdPが DELETE リクエストを送信すると、Wave Connectはユーザーを完全に削除します。プロフィールと連絡先が削除され、NFCカードのリンクが解除されて別の人に割り当てられるようになります。
一部のIDプロバイダー(Microsoft Entra IDなど)は、ユーザーアカウントを完全に削除する前に30日間の猶予期間中にユーザーアカウントを停止します。デフォルトでは、Wave Connectはこの動作に従い、その期間中にアカウントを無効化します。猶予期間をスキップするには、設定 → セキュリティ → ディレクトリ同期 → 構成 を開き、停止せずにユーザーを直ちに削除 を有効にします。これにより、無効化の時点でユーザーが直ちに完全に削除されます。