Microsoft Entra ID を使用した自動ユーザー プロビジョニング用に Zoho One を構成する

この記事では、自動ユーザー プロビジョニングを構成するために Zoho One と Microsoft Entra ID の両方で実行する必要がある手順について説明します。 構成すると、Microsoft Entra ID は、Microsoft Entra プロビジョニング サービスを使用して、Zoho One にユーザーとグループを自動的にプロビジョニングし、解除します。 このサービスの機能、しくみ、よく寄せられる質問の重要な詳細については、「Microsoft Entra IDを使用して SaaS アプリケーションへのユーザー プロビジョニングとプロビジョニング解除を自動化する」を参照してください。

サポートされている機能

  • Zoho One でユーザーを作成します。
  • アクセスが不要になった Zoho One のユーザーを削除します。
  • Microsoft Entra ID と Zoho One の間でユーザー属性の同期を維持します。
  • Zoho One でグループとグループ メンバーシップを設定する
  • Zoho One へのシングルサインオン(推奨)。
  • コード認証許可フロー認証がサポートされています。

前提 条件

この記事で説明するシナリオでは、次の前提条件が既にあることを前提としています。

手順 1: プロビジョニングのデプロイを計画する

  1. プロビジョニング サービスの のしくみについて説明します。
  2. プロビジョニングの対象範囲にいるユーザーを決定します。
  3. Microsoft Entra ID と Zoho One の間でマップするデータを決めます。

手順 2: Microsoft Entra ID を使用したプロビジョニングをサポートするように Zoho One を構成する

Microsoft Entra ID でのプロビジョニングをサポートするように Zoho One を構成するには、Zoho One サポートにお問い合わせください。

Microsoft Entra アプリケーション ギャラリーから Zoho One を追加して、Zoho One へのプロビジョニングの管理を開始します。 SSO 用に Zoho One を以前に設定している場合は、同じアプリケーションを使用できます。 ただし、最初に統合をテストするときは、別のアプリを作成することをお勧めします。 ギャラリー からアプリケーションを追加する方法の詳細については、を参照してください。

手順 4: プロビジョニングのスコープに含まれるユーザーを定義する

Microsoft Entra プロビジョニング サービスを使用すると、アプリケーションへの割り当てに基づいて、またはユーザーまたはグループの属性に基づいてプロビジョニングされるユーザーをスコープできます。 割り当てに基づいてアプリにプロビジョニングされるユーザーのスコープを設定する場合は、 手順を使用してユーザーとグループをアプリケーションに割り当てることができます。 ユーザーまたはグループの属性のみに基づいてプロビジョニングする対象を決定する場合、スコープフィルターを使用できます。

  • 小規模から始めます。 すべてのユーザーとグループにロールアウトする前に、少数のユーザーとグループでテストします。 プロビジョニングのスコープが割り当てられたユーザーとグループに設定されている場合は、1 つまたは 2 つのユーザーまたはグループをアプリに割り当てることで、これを制御できます。 スコープがすべてのユーザーとグループに設定されている場合は、属性ベースのスコープ フィルターを指定できます。

  • 追加のロールが必要な場合は、 アプリケーション マニフェストを更新 して新しいロールを追加できます。

手順 5: Zoho One への自動ユーザー プロビジョニングを構成する

このセクションでは、Microsoft Entra ID のユーザーやグループの割り当てに基づいて TestApp でユーザーやグループを作成、更新、無効化するように Microsoft Entra プロビジョニング サービスを構成する手順について説明します。

Microsoft Entra ID で Zoho One の自動ユーザー プロビジョニングを構成するには:

  1. Azure ポータルに、少なくともクラウド アプリケーション管理者としてサインインします。

  2. Microsoft Entra ID>Enterprise アプリケーション に移動します。

    [エンタープライズ アプリケーション] ブレードのスクリーンショット。

  3. アプリケーションの一覧で [Zoho One 選択します。

    アプリケーションの一覧の Zoho One リンクのスクリーンショット。

  4. [プロビジョニング] タブ を選択します。

    [プロビジョニング] タブのスクリーンショット。

  5. [ + 新しい構成] を選択します。

    [プロビジョニング] タブの [自動] のスクリーンショット。

    Important

    Azure ポータルで対話型の同意を必要とする OAuth ベースのプロビジョニング管理者資格情報を構成します。 Microsoft Entra 管理センターは現在、この承認フローをサポートしていません。 Azure ポータルで、Microsoft Entra ID>Enterprise アプリケーションに移動し、アプリケーションを選択し、アクセスを承認する前に [プロビジョニング] を選択します。

  6. [管理者資格情報の] セクションで、Zoho One テナント URL、承認エンドポイント、トークンエンドポイントを入力します。 [ テスト接続] を選択して、Microsoft Entra ID が Zoho One に接続できることを確認します。 接続に失敗した場合は、Zoho One アカウントに管理者アクセス許可があることを確認してから、もう一度やり直してください。

    トークンのスクリーンショット。

    手記

    • Zoho One のテナント URL、承認エンドポイント、トークン エンドポイントはすべてリージョン固有です。 入力する際は注意してください。
    • 値を入力するときは、Authorization Endpoint は常に末尾に?access_type=offline&prompt=consent&response_type=code&state=&client_id=1000.T3YYZHB8J5Y2BQ185U2FWOIKREUWAH&scope=ZohoOne.SCIM.ALL&redirect_uri=https%3A%2f%2fportal.azure.com%2fTokenAuthorizeを付ける必要があります(たとえば、リージョンが米国の場合、入力する Authorization Endpoint はhttps://accounts.zoho.com/oauth/v2/auth?access_type=offline&prompt=consent&response_type=code&state=&client_id=1000.T3YYZHB8J5Y2BQ185U2FWOIKREUWAH&scope=ZohoOne.SCIM.ALL&redirect_uri=https%3A%2f%2fportal.azure.com%2fTokenAuthorizeである必要があります)。
  7. [ 作成] を選択して構成を作成します。

  8. [概要] ページで [プロパティ] を選択します。

  9. [編集] アイコンを選択してプロパティを編集します。 通知メールを有効にし、検疫通知を受信する電子メールを提供します。 誤削除防止を有効にします。 [適用] を選択して変更を保存します。

    プロビジョニングプロパティのスクリーンショット。

  10. 左側のパネルで [属性マッピング ] を選択し、ユーザーを選択 します。

  11. 属性マッピング セクションで、Microsoft Entra ID から Zoho One に同期されるユーザー属性を確認します。 Zoho One のユーザー アカウントを更新操作で照合するために、"一致する属性" として選択された プロパティが使用されます。 一致するターゲット属性を変更する場合は、Zoho One API がその属性に基づくユーザーのフィルター処理をサポートしていることを確認する必要があります。 [ 保存] ボタンを選択して、変更をコミットします。

    属性 タイプ フィルター処理でサポートされます Zoho One で必須
    ユーザー名 糸 ✓ ✓
    アクティブ ブール値
    表示名 糸
    タイトル 糸
    emails[type eq "仕事"].value 糸
    優先言語 糸
    名前.名 糸
    名前.姓 糸
    名前.整形済み 糸
    優先言語 糸
    addresses[type eq "work"].フォーマット済み 糸
    アドレス[タイプ eq "作業"].ストリートアドレス 糸
    アドレス[タイプ eq "職場"].ローカリティ 糸
    アドレス[タイプが"仕事"に等しい].地域 糸
    addresses[タイプ eq "work"].郵便番号 糸
    アドレス[タイプ Eq "仕事"].国 糸
    電話番号[タイプ eq "携帯"].値 糸
    phoneNumbers[type eq "ファックス"].value 糸
    phoneNumbers[タイプが "職場" の場合].値 糸
    エクスターナルID 糸
  12. [グループ] を選びます。

  13. 属性マッピング セクションで、Microsoft Entra ID から Zoho One に同期されるグループ属性を確認します。 照合のために選択された プロパティとしての属性は、更新操作において Zoho One のグループを照合するために使用されます。 [ 保存] ボタンを選択して、変更をコミットします。

    属性 タイプ フィルター処理でサポートされます Zoho One で必須
    表示名 糸 ✓ ✓
    メンバー 参考
    エクスターナルID 糸
  14. スコープ フィルターを構成するには、スコープ フィルターに関する記事に記載されている手順 を参照してください。

  15. オンデマンド プロビジョニングを使用して、少数のユーザーとの同期を検証してから、組織内でより広範にデプロイします。

  16. プロビジョニングの準備ができたら、[概要] ページから [プロビジョニングの開始] を選択します。

手順 6: デプロイを監視する

プロビジョニングを構成したら、次のリソースを使用してデプロイを監視します。

  1. プロビジョニング ログを使用して、どのユーザーが正常にプロビジョニングされたか、または正常にプロビジョニングされなかったかを判断する
  2. 進行状況バーの を確認して、プロビジョニング サイクルの状態と完了までの近さを確認します
  3. プロビジョニング構成が異常な状態にあると思われる場合、アプリケーションは検疫に入ります。 検疫状態についての詳細は、アプリケーションプロビジョニングの隔離状態に関する記事をご覧ください。

その他のリソース