Identity as a Service:WeCom への接続

手順 1：アプリケーションの作成

1. WeCom 側での作成

   1. WeCom で自作アプリケーションを作成

      WeCom 管理コンソールにログインし、[アプリ管理] > [アプリ]で [自作アプリケーション] を作成します。

   2. アプリケーション情報の設定

      App Logo をアップロードし、App Name と App Description (Optional) を入力し、要件に応じて Visible To 範囲を選択します。可視範囲は、IDaaS EIAM がデータ同期とログインのためにアクセス可能な連絡先です。アプリケーション管理ページに戻ります。

   3. 作成したアプリケーションの表示

      アプリケーション管理ページに戻ります。作成したアプリケーションが Self-built セクションに表示されます。

2. IDaaS 側での作成

   1. IDaaS コンソールで WeCom 連携プロセスを開始

      Alibaba Cloud IDaaS コンソールにログインし、IDaaS インスタンスを選択します。ID プロバイダー メニューで、その他の ID プロバイダー > WeCom をクリックして、連携プロセスを開始します。

      重要

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

   2. 基本情報の入力

      [表示名] と [企業ID] を入力します。

      • [表示名]：ユーザーが IDaaS EIAM にログインまたは使用するときに、この名前が表示される場合があります。

      • [企業ID]：WeCom 管理コンソールにログインします。自社 > 企業情報 に移動して、[企業ID] を取得します。

   3. アプリケーション情報の入力

      アプリケーション情報 (AgentId と シークレット) を入力します。

      1. WeCom 管理コンソールで、アプリケーション管理 > アプリケーション の下のアプリケーション詳細ページから、自作アプリケーションのアプリケーション情報を取得します。

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

      3. ダイアログボックスで送信を確認すると、WeCom Team message の指示に従ってシークレットを表示できます。

   4. 開発情報の入力

      説明

      次の手順では、自己提供ドメイン名を例として使用します。カスタムドメイン名を選択する場合は、IDaaS EIAM インスタンスの カスタマイズ > カスタムドメイン > カスタムドメインの追加 に移動して、カスタムドメイン名の設定を完了してください。

      1. [信頼できるドメイン]

         [ドメインタイプ]は、使用できる WeCom 機能と、以下の開発情報の生成方法に影響します。ドメイン名タイプの違いは次のとおりです。

         カテゴリ	自己提供ドメイン名	カスタムドメイン名
         機能の違い	非機密データの同期と QR コードログインのみをサポートします。	非機密データの同期と QR コードログインに加えて、機密データの同期と Web 認証ログイン、つまり WeCom ワークベンチからのシングルサインオン (SSO) もサポートします。
         設定の違い	信頼できるドメイン名として専用ドメイン名を準備します。このドメイン名の所有者は、WeCom の認証主体と同じである必要があります。このドメイン名には、IDaaS EIAM のビジネスロジックはありません。開発情報内の他のアドレスはデフォルトで生成されます。	利用可能なカスタムドメイン名を選択します。その所有者は、WeCom の認証主体と同じである必要があります。このドメイン名は、すべての WeCom 機能で使用され、安定して利用可能な状態を維持する必要があります。開発情報内の他のアドレスは、選択したカスタムドメイン名に基づいて生成されます。

         1. WeCom 管理コンソールのアプリケーション詳細ページで、[Set trusted domain] をクリックします。

         2. アプリケーションの OAuth 2 Web 認可機能の信頼できるドメイン名を入力します。

            説明

            WeCom では、設定された信頼できるドメイン名が企業エンティティに対応している必要があります。ドメイン名は、プロトコルヘッダーおよび URL パスとは独立しています。

         3. 検証に合格したら、WeCom の指示に従ってドメイン所有権の検証を完了します。

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

         1. ネットワークエンドポイントの専用パブリックネットワークアクセスを使用する必要があります (「専用出口パブリック IP アドレスの設定」を参照)。これにより、IDaaS EIAM インスタンスがお客様の IP アドレスを使用して WeCom にアクセスできるようになります。

         2. IDaaS EIAM 設定ページで、ネットワークエンドポイントを選択し、[専用パブリック出口 IP]を表示します。

         3. その後、インスタンスが使用できるパブリック IP アドレスが表示されます。[すべての IP の一括コピー]をクリックします。

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

         重要

         IDaaS EIAM が使用するすべての WeCom API は、信頼できる IP アドレスを介して呼び出されます。信頼できる IP アドレスが正しく設定されていないか、使用できない場合、WeCom データ同期や QR コードログインなどのすべての機能が影響を受けます。WeCom の信頼できる IP アドレスの検証ロジックは公開されていないため、アカウントパスワードや SMS 検証コードなど、IDaaS にログインする他の方法も保持する必要があります。

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

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

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

         3. Web ページ セクションで、[Set authorization callback domain] をクリックします。IDaaS 設定ページからコピーした認可コールバックドメインを入力します。

            説明

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

      上記の設定が完了したら、Next をクリックして、権限の割り当て 手順に進みます。

WeCom ID プロバイダーの管理

連携が完了すると、ID プロバイダー メニューに自動的にリダイレクトされます。このメニューでは、ID プロバイダーに関連付けられているさまざまな機能を管理できます。

重要な注意事項