Microsoft 365 アクティビティ パッケージを利用するための事前準備

## 概要
本稿では、Microsoft 365 アクティビティパッケージのセットアップ手順について、説明します。
セットアップ手順が完了しましたら、Microsoft 365 アクティビティパッケージをインストールし、ご利用ください。

## 事前情報
Microsoft 365 アクティビティパッケージには、3 種類のアクティビティが含まれています。
|Activity type| プロジェクトの対応 OS |Studio Web で利用可能 |認証方法|
|:-:|:-:|:-:|:-:|
|クラシック アクティビティ*¹|Windows - レガシ、Windows|×|Azure Active Directory に登録されている Microsoft 365 アプリケーション。すべての認証の種類について詳しくは、こちらをご覧ください|
|アクティビティ*²|Windows、クロスプラットフォームに対応|〇|OAuth 2.0、Integration Service のコネクタを使用|
|トリガーアクティビティ*²|Windows、クロスプラットフォームに対応|〇|OAuth 2.0、Integration Service のコネクタを使用|

*¹
クラシック アクティビティは、[Microsoft Office 365 スコープ] アクティビティを使用して、Microsoft 365 アプリケーションへの認証されたコネクションを確立します。
*²
Microsoft 365 のアクティビティとトリガー アクティビティは、Integration Service のコネクタ、Microsoft OneDrive & SharePoint コネクタ、Microsoft Outlook 365 コネクタを使用して、Microsoft 365 アプリケーションへの認証されたコネクションを確立します。

## セットアップ手順
注意事項：本手順を行うには、Microsoft Entra ID （旧Azure AD）の管理権限が必要です

### １．クラシック アクティビティを使用する場合

- UiPathアプリケーションを登録する ※どちらかの作業を実施してください

### Studioから追加する

1. Studio 内にプロジェクトを開くか作成し、[Outlook 365 を使用] アクティビティを追加する
2. このアクティビティ内で [アカウントを選択してください。] > [新しいアカウントを追加] の順にクリックする
3. [既定]＞[自分のID/テナント]を選択する
4. [アプリケーション ID] テキスト ボックスに UiPath Office 365 Azure AD アプリの ID として「f2f43f65-16a6-4319-91b6-d2a342a88744」と入力し、[OK] をクリックする
5. Microsoft アカウントへのサインインを促すウィンドウが新たに表示される
6. サインインした後、要求したアクセス許可へのアクセスをアプリに付与するかどうかを確認する同意プロンプトが表示されので、組織の代表として、[承諾] をクリックして同意する。

### Web ブラウザーからの登録する

1. Web ブラウザーより、[https://login.microsoftonline.com/{tenant_GUID}/adminconsent?client_id=f2f43f65-16a6-4319-91b6-d2a342a88744](https://login.microsoftonline.com/{tenant_GUID}/adminconsent?client_id=f2f43f65-16a6-4319-91b6-d2a342a88744) の URL を開きます。tenant_GUID はアクセス許可を要求するテナントの ID です
2. 管理者権限を持っているMicrosoft アカウントでサインインする
3. 要求したアクセス許可へのアクセスをアプリに付与するかどうかを確認する同意プロンプトが表示されます。組織の代表として、[承諾] をクリックして同意する

### Microsoft Entra ID （旧Azure AD）管理画面から登録する

1. Azure ポータルにサインインする
2. アプリ登録より、新規アプリを作成する
3. 作成した新規アプリにAPIアクセス許可を割り当てる ※Microsoft Graphにアクセス許可を設定する


| アクティビティ | 区分| 必要な Graph API 委任権限|
|:-:|:-:|:-:|
| Microsoft Office 365 スコープ        | ファイル                 |Files.ReadWrite<br>- Files.Read<br>- Files.Read.All<br>- files.readWrite.all<br>- Sites.Read.All<br>- Sites.readwrite.all             |
|                                     | メール                   |Mail.Read<br>- Mail.readwrite<br>- Mail.Send                          |
|                                     | メールと共有             |Mail.Read.Shared<br>- Mail.ReadWrite.Shared<br>- Mail.send.shared     |
|                                     | 予定表                   |calendars.read<br>- calendars.readwrite                              |
|                                     | 予定表と共有             |calendars.read.shared<br>- calendars.readwrite.shared                |
|                                     | グループ                 |Group.Read.All<br>- Group.readwrite.all                              |
| OneDrive と SharePoint を使用       | -                         |Files.Read<br>- Files.Read.All<br>- Files.ReadWrite<br>- Files.ReadWrite.All<br>- Sites.Read.All<br>- Sites.ReadWrite.All<br>- Group.Read.All<br>- Group.ReadWrite.All<br>- User.Read.All<br>- プロファイル<br>- openid<br>- メール アドレス |

## 2. Integration Service を使用する場合

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

権限付与する対象：Microsoft OneDrive & Sharepoint ・Microsoft Outlook 365

1. Microsoft 365 管理センターで連携するコネクター（アプリ）に対してアクセス許可を設定する

### UiPath Automation Cloud の Integration Service に移動する

1. [コネクタ] タブから、必要な Microsoft コネクタ (Microsoft OneDrive & SharePoint、または Microsoft Outlook 365) を選択する

2. コネクションを追加する

| コネクター                       | 許可スコープ                                       |
| ---------------------------------- | ------------------------------------------------- |
| Microsoft OneDrive & Sharepoint    | - offline_access<br>- Files.Read<br>- Files.Read.All<br>- Files.ReadWrite<br>- Files.ReadWrite.All<br>- Sites.Read.All<br>- Sites.ReadWrite.All<br>- Group.Read.All<br>- Group.ReadWrite.All<br>- profile<br>- openid<br>- email. |
| Microsoft Outlook 365              | - Mail.Read<br>- Mail.Read.Shared<br>- Mail.ReadWrite<br>- Mail.ReadWrite.Shared<br>- Mail.Send<br>- Mail.Send.Shared<br>- MailboxSettings.Read<br>- Calendars.Read<br>- Calendars.Read.Shared<br>- Calendars.ReadWrite<br>- Calendars.ReadWrite.Shared<br>- profile<br>- openid<br>- email<br>- offline_access<br>- User.Read |