Microsoft SharePoint Graph 接続の構成

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

    • Microsoft SharePoint Graph の接続と接続レコードを構成し、Microsoft Graph を使用して ServiceNow インスタンスが Microsoft SharePoint と統合できるようにします。

    始める前に

    • 統合ハブ サブスクリプションの要求
    • Microsoft SharePoint Online スポーク のアクティブ化
    • Microsoft Azure ポータルへのアクセス
    • Microsoft Azure ポータルでの OAuth アプリケーションの作成
    • 必要なロール：admin

    手順

    1. 権限を追加して、SharePoint Graph 接続を構成します。
      1. https://portal.azure.com/ にログインします。
      2. [アプリの登録] を選択します。
        [アプリの登録] ボタン。
      3. [すべてのアプリケーション ] または [所有アプリケーション (Owned applications)] を選択します。
        OAuth アプリケーション選択オプション
      4. 検索フィールドに、作成した OAuth アプリケーションの名前を入力します。
        OAuth アプリケーションの構成方法については、「Microsoft Azure での OAuth アプリケーションの設定」を参照してください。
      5. 検索結果で、構成済みの OAuth アプリケーションの名前を選択します。
      6. 左側のパネルの [管理] 見出しで、[API 権限] を選択します。
        API 権限のリンク
      7. [構成済みの権限 (Configured permissions)] 見出しの下にある [+ アクセス許可の追加 (+ Add a permission)] をクリックします。
      8. [API 権限の要求] ウィンドウで、[Microsoft Graph] を選択します。
        [Microsoft Graph] ボタン
      9. [委任されたアクセス許可] を選択します。
      10. [権限を選択 (Select permissions)] 見出しの下にある検索フィールドに、「site」と入力します。
      11. サイトリストを展開します。
        サイトリスト
      12. [Sites.Read.All] と [Sites.ReadWrite.All] を選択します。
        Microsoft SharePoint Online スポーク Graph Site 権限
      13. [権限を選択 (Select permissions)] 見出しの下にある検索フィールドに、「User.read」と入力します。
        Microsoft SharePoint Online スポーク Graph Site ユーザー権限
      14. [権限を追加] を選択します。
        権限が追加されます。

        権限が追加されました。

      15. オプション: アドミンの同意を付与するには、[構成済みの権限 (Configured permissions)] 見出しの下にある [アドミンの同意を付与する] を選択します。
      16. オプション: [はい] を選択します。
        [Sites.Read.All] 権限の [アドミンの同意が必要 (Admin consent required)] 列の値が [はい] の場合、アドミンの同意は必須です。
    2. Microsoft SharePoint Graph 接続レコードを構成します。
      1. ServiceNow インスタンスにログインします。
        注:
        インスタンスの URL と、リダイレクト URL として指定したインスタンスの URL は同じでなければなりません。
      2. 移動先 すべて > プロセスの自動化 > Flow Designer.
    3. 移動先 すべて > プロセスの自動化 > Flow Designer.
    4. [接続] タブをクリックします。
    5. [すべての接続を検索] フィールドに「Microsoft SharePoint」と入力します。
    6. MicrosoftSharePointGraph カードで、[詳細を表示] をクリックします。
    7. [構成] をクリックします。
      [構成] ボタン
    8. フォームで、詳細を入力します。
      フィールド 説明
      接続名 接続レコードの名前。最初の接続レコードのデフォルトの読み取り専用名は、MicrosoftSharePointGraph です。カスタム名を指定するには、[接続を追加] をクリックして、接続レコードを作成する必要があります。
      接続 URL Microsoft Graph API に接続するための URL。URL は https://graph.microsoft.com/v1.0です。
      OAuth エンティティ名 作成した OAuth アプリケーションの名前です。OAuth アプリの作成方法については、「Microsoft Azure での OAuth アプリケーションの設定」を参照してください。
      OAuth クライアント ID OAuth アプリを作成したときに生成されたクライアント ID。クライアント ID の場所については、「Microsoft Azure での OAuth アプリケーションの設定」を参照してください。
      OAuth クライアントシークレット OAuth アプリを作成したときに生成されたクライアントシークレット。クライアント ID の場所については、「Microsoft Azure での OAuth アプリケーションの設定」を参照してください。
      OAuth 認証 URL URL は、https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize?response_mode=query の形式にする必要があります。
      ヒント:
      テナント ID を見つけるには、次の手順を実行します。
      1. https://portal.azure.com/ にログインします。
      2. [Azure Active Directory の管理 (Manage Azure Active Directory)] の見出しの下で、[表示] を選択します。

        テナント ID は、[基本情報] の見出しの下に表示されます。

        テナント ID。
      OAuth トークン URL URL は、https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token の形式にする必要があります。
      ヒント:
      テナント ID を見つけるには、次の手順を実行します。
      1. https://portal.azure.com/ にログインします。
      2. [Azure Active Directory の管理 (Manage Azure Active Directory)] の見出しの下で、[表示] を選択します。

        テナント ID は、[基本情報] の見出しの下に表示されます。

        テナント ID。
      トークン失効 URL URL は、https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token の形式にする必要があります。
      ヒント:
      テナント ID を見つけるには、次の手順を実行します。
      1. https://portal.azure.com/ にログインします。
      2. [Azure Active Directory の管理 (Manage Azure Active Directory)] の見出しの下で、[表示] を選択します。

        テナント ID は、[基本情報] の見出しの下に表示されます。

        テナント ID。
      OAuth リダイレクト URL URL は、https://<instance-name>.service-now.com/oauth_redirect.do の形式にする必要があります。
    9. [OAuth トークンを設定して取得 (Configure and get OAuth Token)] をクリックします。
      接続レコードが作成されます。

      接続が作成されました。

    10. Microsoft Graph アクションを使用するには、ServiceNow インスタンスのテナントテーブル (sn_sp_spoke_tenant) にレコードを作成します。
      注:
      OAuth トークンを構成して取得すると、指定した詳細を使用してアプリケーションレジストリレコードが作成されます。このアプリケーションレコードでは、[OAuth API スクリプト] を選択しないでください。