WeCom を IDaaS EIAM と連携させ、連絡先を同期し、ユーザーが WeCom でログインできるようにします。
概要
統合には以下の 4 つのステップが含まれます。
-
アプリケーションの作成:WeCom 管理コンソールおよび Alibaba Cloud IDaaS コンソールの両方にアプリケーションを作成し、基本情報を構成します。また、WeCom のセキュリティ要件を満たすために、信頼済みドメイン名および信頼済み IP アドレスを設定します。
-
権限の付与:WeCom アプリケーションの表示範囲を調整し、IDaaS EIAM がアクセス可能な連絡先(部門およびメンバーのみ)を決定します。この範囲はデータ同期のソースノードとして機能します。
-
シナリオの選択:連絡先の同期、QR コードログイン、Web 認可ログインなどの要件に基づいて機能を選択します。同期ルール(定期的な完全同期やフィールドマッピングロジックなど)およびログイン方法を構成します。
-
フィールドマッピングの構成:WeCom のメンバーまたは部門のフィールドを、IDaaS EIAM のアカウントまたは組織のフィールドにマッピングし、データの関連性と一貫性を確保します。
前提条件
WeCom は、連絡先および本人確認 API 呼び出しに対して、信頼済みドメイン名および信頼済み IP アドレスを検証します。信頼済み IP アドレスは WeCom 内で 1 つのエンタープライズにのみ使用できます。複数のエンタープライズで同じ IP アドレスを使用すると、WeCom はそれをサービスプロバイダーと見なし、連絡先および本人確認 API を無効化します。以下の内容を事前に準備してください。
|
要件 |
準備内容 |
|
信頼済みドメイン名 |
所有者が WeCom 内の認証済みエンティティと一致する専用ドメイン名。事前にご利用の IDaaS EIAM インスタンスのカスタムドメイン名として構成することを推奨します。詳細については、「カスタムドメイン名」をご参照ください。 |
|
信頼済み IP アドレス |
ご利用の IDaaS EIAM インスタンスには、少なくとも 1 つの専用エンドポイントが必要です。IDaaS EIAM は、ご利用の専用パブリック送信元 IP アドレスを使用して WeCom にアクセスします。詳細については、「ネットワークエンドポイント」および「専用パブリック送信元 IP アドレスの構成」をご参照ください。 |
利用シーン
統合後、以下の機能が利用可能になります。
|
カテゴリ |
機能 |
|
アカウント |
|
|
ログイン |
|
操作手順
ステップ 1:アプリケーションの作成
-
WeCom にアプリケーションを作成します。
-
-
IDaaS EIAM に ID プロバイダーを作成します。
-
ステップ 2:権限の付与
表示対象の範囲を調整します。この範囲は、IDaaS EIAM がデータ同期およびログインのためにアクセス可能な連絡先(タグではなく、部門およびメンバーのみ)を定義します。データ同期が有効になっている場合、この範囲は同期のソースノードとして機能します。
ステップ 3:シナリオの選択
使用するシナリオ機能を選択します。
機能の説明
-
同期対象:WeCom の連絡先データが IDaaS EIAM のこのノードにインポートされます。
-
スケジュール同期:WeCom は増分データのクエリをサポートしていないため、IDaaS EIAM は毎日深夜に WeCom ソースノードからすべてのデータの定期的な完全同期を自動的に実行します。
-
フィールドマッピング設定でマッピング識別子を構成できます。これにより、IDaaS EIAM アカウントのフィールド(アカウント名など)と WeCom ユーザープロファイルのフィールド(
useridなど)を照合できます。一致が見つかった場合、アカウントがリンクされ、IDaaS EIAM アカウントが更新されます。一致しない場合は、新しい IDaaS EIAM アカウントが作成されます。 -
すぐにデータを同期するには、手動で完全同期をトリガーします。
-
IDaaS EIAM には、組み込みの同期保護機能があります。スケジュールされた削除対象がアカウント 30 件以上または組織 10 件以上の場合、誤ったデータ損失を防ぐために同期タスクが自動的にキャンセルされます。エンタープライズの規模に応じて、同期保護設定を調整することを推奨します。
-
-
QR コードログイン:有効にすると、ログインメニューに WeCom QR コードログインオプションが作成され、有効化されます。これにより、ユーザーは QR コードをスキャンするだけで即座にログインできます。
-
Web 認可ログイン:ドメインタイプが「カスタムドメイン名」に設定されている場合、デフォルトで有効になります。これにより、WeCom Web ページから IDaaS EIAM またはそのアプリケーションへの SSO が可能になり、ユーザーの権限付与後に機密データの同期がサポートされます。
機密データを取得するには、ユーザーが WeCom 環境内で権限付与を行う必要があります(SSO を開始する際に権限付与ページが表示されます)。権限付与後、ユーザーの WeCom 電話番号および社内メールアドレス(社内メールアドレスが利用できない場合は個人メールアドレス)が、IDaaS EIAM アカウントの電話番号およびメールアドレスとして使用されます。
ステップ 4:フィールドマッピング
IDaaS EIAM に既存のデータがあり、WeCom のメンバーまたは部門を IDaaS EIAM のアカウントまたは組織にリンクする必要がある場合は、フィールドマッピングを構成します。また、WeCom メンバープロファイルの特定のフィールドを IDaaS EIAM アカウントフィールドにマッピングすることもできます(例:WeCom メンバーのエイリアスを表示名として使用)。
WeCom アカウント ID (userid) がシステムで生成されたものである場合、変更は 1 回のみ可能です。このフィールドは IDaaS EIAM が依存する一意のプライマリキーであるため、変更すると対応する IDaaS EIAM アカウントが削除され、再作成されます。このフィールドの変更は慎重に行ってください。
企業および従業員のデータセキュリティとプライバシーを保護するため、WeCom は API ポリシーを調整しました。
2022 年 6 月 20 日 20:00 以降、連絡先同期以外の目的で WeCom API を呼び出しても、以下の機密フィールド(アバター、性別、電話番号、メールアドレス、社内メールアドレス、個人用 QR コード、住所)は返されなくなりました。アプリケーションでこの情報が必要な場合は、WeCom OAuth2.0 認可メカニズムを使用して、管理者および従業員に必要な権限を求める必要があります。
WeCom ID プロバイダーの管理
統合が完了すると、ID プロバイダーページにリダイレクトされ、ID プロバイダーの機能を管理できます。
重要な注意事項
QR コードログイン
WeCom QR コードログインは、認可コールバックドメインの構成に依存します。ブラウザ内の IDaaS EIAM ログインページのドメイン名、IDaaS EIAM 内の WeCom ID プロバイダーに構成された認可コールバックドメイン、および WeCom に構成された認可コールバックドメインは、すべて同一である必要があります。そうでない場合、QR コードログインは失敗します。
ユーザーがカスタムドメイン名経由で IDaaS EIAM にアクセスできるようにするには、そのドメイン名をデフォルトドメインとして設定し、自動リダイレクトを有効化し、IDaaS EIAM および WeCom の両方で認可コールバックドメインをカスタムドメイン名に設定します。詳細については、「カスタムドメイン名」をご参照ください。
機密データの同期
機密データを取得するには、ユーザーが WeCom 環境内で権限付与を行う必要があります(SSO を開始する際に権限付与ページが表示されます)。権限付与後、ユーザーの WeCom 電話番号および社内メールアドレス(社内メールアドレスが利用できない場合は個人メールアドレス)が、IDaaS EIAM アカウントの電話番号およびメールアドレスとして使用されます。
ユーザーが権限付与を行った後、30 日間は権限付与ページが再度表示されません。この期間中に権限付与を変更するには、ユーザーは WeCom アプリケーション(ID プロバイダー統合時に作成されたもの)を開き、個人の機密情報権限付与ページに移動して設定を更新できます。
管理者は、WeCom ので、必要な機密データ(電話番号やメールアドレスなど)の表示が有効になっていることを確認する必要があります。IDaaS EIAM は、ユーザーによる権限付与および管理者による表示設定が行われている場合にのみ、機密ユーザーデータを取得できます。
代替ログイン方法の維持
Alibaba Cloud IDaaS は、ご利用の WeCom 連絡先データの同期および本人確認の可用性を最大限確保するよう努めています。ただし、信頼済みドメイン名や信頼済み IP アドレスなどの機能に対する WeCom の検証方法およびリスク管理ルールは公開されていないため、Alibaba Cloud は WeCom アカウントを使用した IDaaS EIAM への継続的かつ安定したログインを保証できません。
WeCom が利用できなくなった場合に IDaaS EIAM へのログインがロックアウトされないように、ユーザー名/パスワードや SMS コードなどの他のログイン方法を必ず維持してください。代替方法を構成しなかったためにログインできなくなった場合の損失については、お客様ご自身の責任となります。
他のログイン方法の構成方法については、「一般的なログイン設定」をご参照ください。