Microsoft OneDrive & Sharepoint の認証

前提条件

選択した認証の種類に応じて、次のうちいずれかが必要です。

• Microsoft アカウントのメール アドレスとパスワード
• アプリケーションのクライアント ID とクライアント シークレット、スコープとテナント ID。

また、サードパーティのアプリに情報にアクセスする権限を付与する必要があります。何らかのエラーが発生した場合は、Microsoft OneDrive & SharePoint の管理者にお問い合わせください。

注:

Integration Service は、コネクションを作成するユーザーを偽装します。 ユーザーの資格情報を使用して、指定のアプリケーション内のリソースと同じリソースすべてへのアクセスを可能にします。コネクションを共有すると、そのコネクションを有する Microsoft SharePoint または OneDrive に加えられた変更はすべて、そのユーザーに代わって行われます。

環境

初めて [認証] 画面にアクセスするときに、ロボット グループを選択できます。 利用可能なオプションは次のとおりです。

• Office 365 (既定)
• 米国政府 L4 - パブリック セクター ドメイン
• 米国政府 L5 - パブリック セクター ドメイン
• 中国

サード パーティ アプリに権限を付与する

コネクションを確立する前に、Microsoft の公式ドキュメント「 ユーザーの同意設定を構成する」で説明されているように、統合アプリにアクセス許可が付与されていることを確認してください。

スコープ

コネクタは、次のスコープを要求します: offline_access, Files.Read, Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, profile, openid, email, User.Read.All.

これは、必要なスコープの完全なリストを表します。

注: IT チームと協働して、ユーザーとアプリケーションにこれらの権限を許可してください。

Microsoft OneDrive & SharePoint コネクションを追加する

お使いの Microsoft OneDrive & SharePoint インスタンスへのコネクションを作成するには、次の手順を実行する必要があります。

1. [Automation^CloudTM (公共部門向け)] で [Integration Service] を選択します。

2. [コネクタ] のリストから [Microsoft OneDrive & SharePoint] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [Microsoft OneDrive & SharePointに接続] ボタンを選択します。
4. これで、コネクションのページにリダイレクトされます。[OAuth 2.0 認可コード] または [独自の OAuth 2.0 アプリ (BYOA) を使用する] の 2 つの認証の種類から選択できます。
   • [OAuth 2.0 認可コード] を選択した場合は、[接続] をクリックして、Microsoft のメール アドレスとパスワードを使用して認証します。
   • [Bring your own OAuth 2.0 app] を選択した場合は、[クライアント ID] と [クライアント シークレット]、[テナント ID]、[スコープ] を指定する必要があります。この共通シナリオは、各種アクティビティの操作に必要です。 必要なスコープについては、アクティビティのドキュメントをご覧ください。
     手記： マルチテナント アプリケーションを使用している場合は、[ テナント ID] は既定値 (common) のままにします。 シングル テナント アプリケーションを使用している場合は、Azure からテナント ID を取得します。 「 Microsoft Entra テナント ID を確認する方法」をご覧ください。
5. コネクションが追加されました。

独自の OAuth 2.0 アプリ (BYOA) を使用する

Integration Service では、Microsoft Graph ベースのコネクタのいずれかへのコネクションを作成する際に、次の 2 つの認証オプションのいずれかを選択できます。

• OAuth 2.0 認可コード – UiPath のパブリック アプリケーションに接続します。
• 独自の OAuth 2.0 アプリ (BYOA) を使用する – 作成したプライベート アプリケーションに接続します。

アプリケーションの作成方法については、Microsoft の公式ドキュメントにアクセスし、「Microsoft ID プラットフォームにアプリケーションを登録する」に記載された手順に従ってください。

注: これは高度な機能であり、対象のアプリケーションの管理者権限が必要です。 IT 管理者と協力して、アプリケーションを正常にセットアップしてください。

要件

Integration Service で使用する独自のアプリケーションを作成する場合は、次の要件を考慮する必要があります。

1. アプリケーションを マルチテナント アプリケーションまたは シングルテナント アプリケーションとして構成する必要があります。
2. Web リダイレクト URI を構成する必要があります。OAuth 2.0 アプリケーションのリダイレクト URI (またはコールバック URL) は、コネクションの作成時に認証画面に表示されます。 https://govcloud.uipath.us/provisioning_/callback。
3. 委任されたアクセス許可を設定する必要があります。 詳細については、Microsoft の公式ドキュメントの 「権限 」をご覧ください。
   注: プライベート OAuth アプリケーションを使用するメリットは、実際のニーズに応じてアクセス許可をカスタマイズできることです。 Microsoft 365 のアクティビティ パッケージ内の各アクティビティに必要なスコープについて詳しくは、アクティビティのドキュメントをご覧ください。

   このコネクタは Microsoft Graph API を使用します。 すべての権限について詳しくは、 Microsoft Graph の権限に関するリファレンス ページをご覧ください。

アプリケーションを作成したら、そのクライアント ID とクライアント シークレットを使用して、Microsoft コネクタへのコネクションを作成します。

OAuth アプリケーションの更新トークン

OAuth アプリケーションの更新トークンは、Microsoft によっていつでも無効にされたり、取り消されたりされます。これは、タイムアウトや失効など、さまざまな理由で発生する可能性があります。 詳細については、トークンの有効期限に関する Microsoft の公式ドキュメントをご覧ください。

警告: トークンを無効にするとコネクションが失敗し、コネクションを修正しないとオートメーションを実行できません。

OAuth アプリケーションを作成する際は、Microsoft のベスト プラクティスに従ってください。 OAuth 2.0 アプリケーションの作成方法の詳細については、Microsoft のドキュメントをご覧ください。

注: この問題は、すべての Microsoft Graph ベースのコネクタに影響します。