すべてのプロダクト
Search
ドキュメントセンター

Identity as a Service:WeCom との統合

最終更新日:Jul 18, 2026

WeCom を IDaaS EIAM と連携させ、連絡先を同期し、ユーザーが WeCom でログインできるようにします。

概要

統合には以下の 4 つのステップが含まれます。

  1. アプリケーションの作成:WeCom 管理コンソールおよび Alibaba Cloud IDaaS コンソールの両方にアプリケーションを作成し、基本情報を構成します。また、WeCom のセキュリティ要件を満たすために、信頼済みドメイン名および信頼済み IP アドレスを設定します。

  2. 権限の付与:WeCom アプリケーションの表示範囲を調整し、IDaaS EIAM がアクセス可能な連絡先(部門およびメンバーのみ)を決定します。この範囲はデータ同期のソースノードとして機能します。

  3. シナリオの選択:連絡先の同期、QR コードログイン、Web 認可ログインなどの要件に基づいて機能を選択します。同期ルール(定期的な完全同期やフィールドマッピングロジックなど)およびログイン方法を構成します。

  4. フィールドマッピングの構成:WeCom のメンバーまたは部門のフィールドを、IDaaS EIAM のアカウントまたは組織のフィールドにマッピングし、データの関連性と一貫性を確保します。

前提条件

WeCom は、連絡先および本人確認 API 呼び出しに対して、信頼済みドメイン名および信頼済み IP アドレスを検証します。信頼済み IP アドレスは WeCom 内で 1 つのエンタープライズにのみ使用できます。複数のエンタープライズで同じ IP アドレスを使用すると、WeCom はそれをサービスプロバイダーと見なし、連絡先および本人確認 API を無効化します。以下の内容を事前に準備してください。

要件

準備内容

信頼済みドメイン名

所有者が WeCom 内の認証済みエンティティと一致する専用ドメイン名。事前にご利用の IDaaS EIAM インスタンスのカスタムドメイン名として構成することを推奨します。詳細については、「カスタムドメイン名」をご参照ください。

信頼済み IP アドレス

ご利用の IDaaS EIAM インスタンスには、少なくとも 1 つの専用エンドポイントが必要です。IDaaS EIAM は、ご利用の専用パブリック送信元 IP アドレスを使用して WeCom にアクセスします。詳細については、「ネットワークエンドポイント」および「専用パブリック送信元 IP アドレスの構成」をご参照ください。

利用シーン

統合後、以下の機能が利用可能になります。

カテゴリ

機能

アカウント

  • WeCom から IDaaS EIAM へ機密でない連絡先データを同期します。

  • WeCom から IDaaS EIAM へ機密連絡先データ(電話番号やメールアドレスなど)を同期します。

ログイン

  • ユーザーが WeCom QR コードをスキャンして、IDaaS EIAM またはそのアプリケーションにログインできるようにします。

  • Web 認可ログイン(WeCom Web ページからのシングルサインオン (SSO))を IDaaS EIAM またはそのアプリケーションに対して有効化します。

操作手順

ステップ 1:アプリケーションの作成

  1. WeCom にアプリケーションを作成します。

    1. WeCom にセルフビルドアプリケーションを作成します

      WeCom 管理コンソールログインします。アプリケーション管理 > アプリケーションセクションで、セルフビルドアプリケーションを作成します。

    2. アプリケーション情報を構成します

      アプリケーションロゴをアップロードし、アプリケーション名およびアプリケーションの説明(任意)を入力し、要件に応じて表示対象の範囲を選択します。表示範囲は、IDaaS EIAM がデータ同期およびログインのためにアクセス可能な連絡先を決定します。その後、アプリケーション管理ページに戻ります。

    3. 作成したアプリケーションを確認します

      アプリケーション管理ページに戻ります。作成したアプリケーションが「セルフビルド」セクションに表示されます。

  2. IDaaS EIAM に ID プロバイダーを作成します。

    1. IDaaS EIAM コンソールで WeCom 統合プロセスを開始します

      Alibaba Cloud IDaaS コンソールにログインし、ご利用の IDaaS EIAM インスタンスを選択します。ナビゲーションウィンドウで ID プロバイダー を選択し、その他の ID プロバイダー > WeCom をクリックして統合を開始します。

      重要

      現在のインスタンスに専用エンドポイントが存在しない場合は、事前に追加する必要があります。詳細については、「専用エンドポイントの追加」をご参照ください。

    2. 基本情報を入力します

      指示に従って、表示名および企業IDを入力します。

      • 表示名:この名前は、ユーザーが IDaaS EIAM にログインまたは使用する際に表示される可能性があります。

      • 企業ID: ログインして、WeCom 管理コンソールにアクセスします。 自社 > 企業情報 ページから 企業ID を取得します。

    3. アプリケーション情報を入力します

      AgentIdおよびSecretを入力します。

      1. WeCom 管理コンソールで、アプリケーション管理 > アプリケーションページに移動し、セルフビルドアプリケーションの詳細ページを開いて情報を取得します。

      2. アプリケーション詳細ページで、シークレットセクションの詳細をクリックします。

      3. ダイアログボックスでリクエストを確認します。その後、指示に従ってWeCom チームメッセージからシークレットを取得できます。

    4. 開発情報を入力します

      説明

      以下の手順では、セルフプロバイドドメイン名を例として使用します。カスタムドメイン名を使用する場合は、ご利用の IDaaS EIAM インスタンスでカスタマイズ > カスタムドメイン > カスタムドメインの追加に移動して構成を完了してください。

      1. 信頼できるドメイン

        ドメインタイプは、使用可能な WeCom 機能および開発情報の生成方法に影響します。違いは以下のとおりです。

        カテゴリ

        セルフプロバイドドメイン名

        カスタムドメイン名

        機能の違い

        機密でないデータの同期および QR コードログインのみをサポートします。

        セルフプロバイドドメイン名の機能に加え、機密データの同期および Web 認可ログイン(WeCom Web ページからの SSO)をサポートします。

        構成の違い

        WeCom の認証済みエンティティと所有者が一致する専用ドメイン名を信頼済みドメイン名として準備する必要があります。このドメインは IDaaS EIAM 内でビジネスロジックを持ちません。開発情報内の他のアドレスはデフォルトで生成されます。

        WeCom の認証済みエンティティと所有者が一致するカスタムドメイン名を選択します。このドメインは WeCom 機能で使用され、安定している必要があります。開発情報内の他のアドレスは、選択したカスタムドメイン名に基づいて生成されます。

        1. WeCom 管理コンソールのアプリケーション詳細ページで、信頼済みドメインの設定をクリックします。

        2. アプリケーションの OAuth2 Web 認可機能用の信頼済みドメイン名を入力します。

          説明

          WeCom では、構成された信頼済みドメイン名が企業エンティティに対応しており、プロトコルや URL パスとは独立している必要があります。

        3. 検証後、WeCom の指示に従ってドメイン所有者の認証を完了します。

      2. 企業の信頼IP。ドロップダウンリストをクリックして、専用ネットワークエンドポイントを選択します。

        1. ご利用の IDaaS EIAM インスタンスがご利用の IP アドレスから WeCom にアクセスできるように、ネットワークエンドポイントの専用パブリック送信元を使用する必要があります。詳細については、「専用パブリック送信元 IP アドレスの構成」をご参照ください。

        2. IDaaS EIAM 構成ページで、ネットワークエンドポイントを選択し、専用パブリック出口 IPを確認します。

        3. インスタンスで利用可能なパブリック IP アドレスが表示されます。すべての IP の一括コピーをクリックします。

        4. WeCom 管理コンソールのアプリケーション設定で、コピーした IP アドレスを企業の信頼IPとして構成します。

        重要

        IDaaS EIAM で使用されるすべての WeCom API は、信頼済み IP アドレス経由で呼び出されます。信頼済み IP アドレスが誤って構成されているか、利用できない場合、データ同期や QR コードログインを含むすべての機能に影響が出ます。WeCom の信頼済み IP アドレスに対する検証ロジックは公開されていないため、ユーザー名/パスワードや SMS コードなどの他のログイン方法を IDaaS EIAM で維持しておくことを推奨します。

      3. 認可コールバックドメイン

        1. WeCom との連携 - インバウンド構成ページで、認可コールバックドメインをコピーします。

        2. WeCom 管理コンソールのアプリケーション設定で、設定をクリックします(WeCom 認可ログイン用)。

        3. Web ページセクションで、認可コールバックドメインの設定をクリックします。IDaaS EIAM 構成ページからコピーした認可コールバックドメインを貼り付けます。

          説明

          ドメインタイプが「カスタムドメイン名」の場合、アプリケーション詳細ページでアプリケーションのホームページ URL(Web ページ)も設定する必要があります。これは、WeCom Web ページからの SSO 後にユーザーがリダイレクトされるアドレスです。

      これらの構成を完了したら、Nextをクリックして、権限の割り当てステップに進みます。

ステップ 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 コードなどの他のログイン方法を必ず維持してください。代替方法を構成しなかったためにログインできなくなった場合の損失については、お客様ご自身の責任となります。

他のログイン方法の構成方法については、「一般的なログイン設定」をご参照ください。