Microsoft Office 365 スコープ

UiPath.MicrosoftOffice365.Activities.Office365ApplicationScope

説明

Microsoft ID プラットフォームを使用して、UiPath と Microsoft 365 アプリケーション間の認証されたコネクションを確立します。この認証された接続によって、ロボットは Microsoft Graph API を呼び出し、ユーザーに代わってリソースを読み書きできます。

重要: v2.5.5 より、新しいバージョンの Microsoft 365 アクティビティをスコープ アクティビティ内で使用できるようになりました。[Microsoft 365 スコープ] と Integration Service のアクティビティを使用する方法については、「Integration Service のコネクションなしで Microsoft 365 アクティビティを使用する方法」をご覧ください。

プロジェクトの対応 OS

Windows - レガシ |Windows

構成

ヒント: このページでは、[Microsoft Office 365 スコープ] アクティビティで利用可能な認証パラメーターについて説明します。各認証オプションについて詳しくは、「Microsoft Office 365 アクティビティへの接続方法」 ガイドをご覧ください。

このアクティビティの設定を開始するには、まず接続方法を選択する必要があります。選択した方法に応じて、[プロパティ] パネルに異なるフィールドが表示されます。

• 接続方法 - 使用する接続補法を選択します。ドロップダウン メニューで選択できるオプションは次のとおりです。
  • プロパティ パネル - [プロパティ] パネルでコネクションの詳細を設定します。
  • アセット - Orchestrator の資格情報アセットを使用します。 このオプションを使用することをお勧めします。

アセットの接続方法

注: このオプションを選択すると、認証情報がアセット内に格納されるため、[プロパティ] パネルに通常表示される認証フィールドのほとんどは非表示になります。

• コネクション アセット - Orchestrator のフォルダーを参照してアセットを選択します。 このフィールドでは IResource 変数がサポートされています。 [アセットを管理] ボタンを選択して Orchestrator を開きます。 利用可能なアセットのリストは、Studio とロボットが接続されている Orchestrator によって異なります。
  • Orchestrator でアセットを更新した場合は、プラス ボタンのメニューから [アセットを再読み込み] を選択します。デスクトップ版の Studio の使用中に Orchestrator に新しいアセットを追加した場合、そのアセットはすぐには [スコープ] アクティビティで利用できないことに注意してください。

• アセットの形式については、「Integration Service のコネクションなしで Microsoft 365 アクティビティを使用する方法」をご覧ください。

アセットに設定されている認証の種類に応じて、[プロパティ] パネルで利用可能な以下のフィールドも設定する必要があります。

認証

• 偽装されたユーザーのメール アドレス - 偽装されたユーザーのメール アドレスです。[アプリケーション ID とシークレット] および [アプリケーション ID および証明書] の認証方法に使用されます。

ユーザー名とパスワード (Unattended)

• ユーザー名 - Microsoft 365 アカウントのユーザー名です。ユーザー名とパスワードの認証方法に使用されます。
• パスワード ｰ Microsoft 365 アカウントのパスワードです。

共通

• タイムアウト (ミリ秒) - 対話型認証 (同意を求めるダイアログ ボックス) が完了するまでの待機時間をミリ秒単位で指定します。この時間を過ぎるとエラーが生成されます。このフィールドでは整数および Int32 型の変数のみがサポートされています。 既定値は、30,000 ms (30 秒)

実行時

• ランタイム接続アセット - 参照してアセットを選択します。このフィールドでは、ランタイム用の別のアセットを選択できます。プラス ボタンのメニューを使用して [相対パス] を選択し、コネクションの詳細を含む Orchestrator アセットのフル パスを入力します。

[プロパティ] パネルの接続方法

注: このオプションを選択する場合は、[プロパティ] パネルで利用可能な認証フィールドを設定する必要があります。

まず、次のフィールドを設定します。

• コネクション - リストからアカウントを選択します。 コネクションの追加、削除、および使用するコネクションの選択ができます。
• 認証スコープ - 以下の「認証スコープ ウィザードを使用する」のセクションをご覧ください。

認証スコープ ウィザードを使用する

注: このウィザードは、このパッケージの以前のバージョンで利用可能だった [サービス] パラメーターを置き換えます。認証スコープ ウィザードは、対話型トークンの認証を使用する場合に利用可能です。

[スコープ] アクティビティには汎用的な権限セレクターが組み込まれており、アクティビティが正しく機能するために必要な、使用されているすべての認証スコープを明確に把握できます。

[Microsoft 365 スコープ] アクティビティに含まれるすべての子アクティビティが、必要なスコープとして自動的に検出されます。

[スコープ] ウィザードでスコープを手動で選択しない場合、実行時には既定で自動検出機能が適用され、ウィザードの設定が不要になります。必要最低限のスコープのすべてが実行時に選択されます。

子アクティビティを [Microsoft 365 スコープ] に追加した後に、スコープを手動で追加することもできます。

次に、[プロパティ] パネルから [認証の種類] を選択し、使用する認証方法に必要なフィールドを設定する必要があります。以下のセクションに、各メニューで利用可能なフィールドを示します。

認証

• 認証の種類 - 登録済みアプリケーションに必要な認証の種類です。次の 5 つのオプションから 1 つを選択します: [対話型トークン]、[統合 Windows 認証 (IWA)]、[ユーザー名とパスワード]、[アプリケーション ID とシークレット]、[アプリケーション ID および証明書]。既定値は [対話型トークン] です。
• 環境 - 環境です。Azure Global、または Azure Global とは別の独自のナショナル クラウドです。次の 5 つのオプションから 1 つを選択します: [既定]、[グローバル]、[中国]、[ドイツ]、[米国政府]。既定値は [グローバル] です。
• アプリケーション ID - セットアップ時にアプリケーションを登録するときに Azure Active Directory によって割り当てられた一意のアプリケーション (クライアント) ID です。アプリケーション (クライアント) ID は、Microsoft 365 アプリケーションのインスタンスを表します。
• テナント - セットアップ時にアプリケーションを登録したときに Azure Active Directory によって割り当てられた一意のディレクトリ (テナント) ID です。マルチテナント アプリケーションおよび [統合 Windows 認証] の場合は必須です。ディレクトリ (テナント) ID は登録済みアプリケーションの概要ページ (アプリケーション (クライアント) ID の下) で確認できます。
• 偽装されたユーザーのメール アドレス - 偽装されたユーザーのメール アドレスです。有人シナリオ ([アプリケーション ID とシークレット] および [アプリケーション ID および証明書] の認証方法) に使用されます。

対話型トークン

注: これは、Integration Service でサポートされている認証方法と同じです。パブリックの UiPath アプリまたはプライベートのカスタム アプリケーション ([独自のアプリを使用する] メソッド) を使用します。

詳しくは、「対話型トークン」をご覧ください。

• OAuth アプリケーション - 使用するアプリケーション (クライアント) を指定します。このフィールドでは OAuthApplication 型の変数のみがサポートされています。次の 2 つのオプションのいずれかを選択します。
  • UiPath - 既定値です。UiPath が作成したアプリケーションを使用する場合です (UiPath パブリック アプリの登録)。選択した場合、[認証] セクションにある [アプリケーション ID] フィールドと [テナント] フィールドは無視されます。
  • カスタム - 特定の権限を持つ独自のアプリケーションを作成する場合。この場合、[アプリケーション ID] フィールドに値を設定する必要があります。「Microsoft 365 スコープのコネクション用にアプリケーションを作成する方法」をご覧ください。

アプリケーション ID および証明書 (無人)

詳しくは、「アプリケーション ID および証明書」をご覧ください。

• Base64 形式の証明書 - Base64 にエンコードされた証明書です。

• 証明書のパスワード - 証明書を使用する際に必要となる可能性がある、Secure String 型の任意のパスワードです。

アプリケーション ID とシークレット (Unattended)

詳しくは、「アプリケーション ID とシークレット」をご覧ください。

• アプリケーション シークレット - アプリケーションがその ID を提供するために使用するシークレット文字列です。
• セキュリティで保護されたアプリケーション シークレット - SecureString によるアプリケーション (クライアント) シークレットです。

ユーザー名とパスワード (Unattended)

詳しくは、「ユーザー名とパスワード」をご覧ください。

重要: Microsoft は Exchange Online の基本認証 を廃止しました。これは、[Microsoft Office 365 スコープ] などの一部のアクティビティに影響します。このため、OAuth プロトコルをサポートするアクティビティでは OAuth プロトコルを使用することをお勧めします。

• パスワード ｰ Microsoft 365 アカウントのパスワードです。
• セキュリティで保護されたパスワード ｰ Microsoft 365 アカウントの SecureString によるパスワードです。
• ユーザー名 - Microsoft 365 アカウントのユーザー名です。

共通

• タイムアウト (ミリ秒) - 対話型認証 (同意を求めるダイアログ ボックス) が完了するまでの待機時間をミリ秒単位で指定します。この時間を過ぎるとエラーが生成されます。このフィールドは、整数と Int32 変数のみをサポートします。既定値は、30,000 ms (30 秒) です (表示されません)。
• エラー発生時に実行を継続 - 設定した場合、現在のアクティビティが失敗しても残りのアクティビティの実行を継続します。

トラブルシューティング

認証に問題が発生した場合は、「トラブルシューティング」セクションの「認証」をご覧ください。