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はこの動作に従い、その期間中にアカウントを無効化します。猶予期間をスキップするには、設定 → セキュリティ → ディレクトリ同期 → 構成 を開き、停止せずにユーザーを直ちに削除 を有効にします。これにより、無効化の時点でユーザーが直ちに完全に削除されます。