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 365 スコープ] アクティビティで利用可能な認証パラメーターについて説明します。各認証オプションについて詳しくは、「 Microsoft 365 アクティビティへの接続方法 」 ガイドをご覧ください。

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

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

アセットの接続方法

注:

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

• コネクションのアセット - Orchestrator のフォルダーを参照してアセットを選択します。このフィールドでは IResource 型の変数がサポートされています。[アセットを管理] ボタンを選択して Orchestrator を開きます。利用可能なアセットのリストは、Studio とロボットが接続されている Orchestrator によって異なります。アセットは設計時に使用できます。また、アセットでは Text 型のみを使用できます。

  • Orchestrator でアセットを更新した場合は、プラス ボタンのメニューから [アセットを再読み込み] を選択します。デスクトップ版の Studio の使用中に Orchestrator に新しいアセットを追加した場合、そのアセットはすぐには [スコープ] アクティビティで利用できないことに注意してください。

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

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

認証

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

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

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

共通

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

実行時

• Runtime connection assets - Browse to select an asset. This field lets you select a different asset for runtime. Use the Plus button menu to select Relative path and enter the full path of the Orchestrator asset containing connection details. We recommend you to use a credential asset in this field, but you can also use a text asset. The JSON value must be set in the password field for credential assets. This value is optional and, if left blank, the design time values will be used at runtime.

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

注:

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

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

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

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

注:

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

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

[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 の下) で確認できます。

• データ保存場所 - トークンの応答の保存先を指定するドロップダウン リストです。使用可能なプロパティ値は、[Local disk]、[Orchestrator]、[Never store] のいずれかです。

  • ローカル ディスク - コネクション トークンは、マシン上のローカル フォルダーに保存されます。同じコネクションを同一マシン上の複数のプロセスで使用できます。
  • Orchestrator - コネクション トークンは、Orchestrator でアセットとして指定したフォルダーに保存されます。指定した Orchestrator フォルダーへのアクセス権がある限り、複数のマシン上の複数のプロセスで同じコネクションを使用できます。
  • 保存しない - コネクション トークンは保存されません。
  注:

  技術的な制限により、O365 のストレージ ソリューションは GSuite と異なります。O365 ではすべてのアカウントが Orchestrator の 1 つのファイルに保存されますが、GSuite ではアカウントごとに 1 つのファイルが保存されます。

• Orchestrator フォルダー パス - 操作が実行される Orchestrator フォルダーです。モダン フォルダーが有効でない場合は、空のままにします。詳細については、『Orchestrator ガイド』の 「フォルダーについて」をご覧ください。

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

対話型トークン

注:

これは、Integration Service が UiPath パブリック アプリ または [独自のアプリを使用] メソッドのいずれかでサポートする認証方法と同じです。

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

• OAuth アプリケーション - 使用するアプリケーション (クライアント) を指定します。このフィールドでは OAuthApplication 型変数のみがサポートされています。次の 2 つのオプションのいずれかを選択します。
  • UiPath - 既定値です。UiPath が作成したアプリケーションを使用する場合です (UiPath パブリック アプリの登録)。選択した場合、[認証] セクションにある [アプリケーション ID] フィールドと [テナント] フィールドは無視されます。
  • カスタム - 特定の権限を持つ独自のアプリケーションを作成する場合。この場合、[アプリケーション ID] フィールドに値を設定する必要があります。「カスタム OAuth アプリケーションの登録 - 独自のアプリ (BYOA)」をご覧ください。
• ブローカーを使用 - 対話型認証に Windows 認証マネージャー (WAM) ブローカーを使用するには、このオプションを True に設定します。このオプションを使用すると、Windows 上でより統合された認証エクスペリエンスが提供されます。
• OAuth2 ユーザー - 対話型トークンを介してログインするユーザーのメール アドレスです。

アプリケーション 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 秒) です (表示されません)。
• エラー発生時に実行を継続 - 設定した場合、現在のアクティビティが失敗しても残りのアクティビティの実行を継続します。

トラブルシューティング

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