移行先 Exchange Online における権限

移行先に接続するには、認証方法として、サービス アカウント・Fly アプリ プロファイル・カスタム アプリ プロファイルのいずれかの使用を選択することができます。サービス アカウントと Fly アプリ プロファイルの組み合わせ、またはサービス アカウントとカスタム アプリ プロファイルの組み合わせを使用することもできます。

認証方法によって必要な権限については、以下のセクションを参照してください。

Fly アプリ プロファイル権限

テナント所有者またはサービス管理者のロールを持っている場合、AvePoint Online Services > 管理 > アプリ管理 で Fly アプリ プロファイルを作成して、Fly アプリを使用している Microsoft 365 テナントに接続することができます。

Fly アプリ プロファイルの作成方法および必須権限については、Fly アプリ プロファイル権限 を参照してください。

NOTE
  • Exchange Online テナントの検出または Exchange Online から Exchange Online への移行を実行する場合、アプリを承認するアカウントがメールボックス (Exchange ライセンスの割り当てまたは PowerShell の使用のいずれかによって作成されているメールボックス) を持っていることを確認してください。

  • 以下の場合に、Exchange 管理者 ロールを AvePoint Fly アプリに割り当てる必要があります。詳細については、以下の Exchange 管理者ロールのアプリへの割り当て方法 を参照してください。

    • 移行先で共有メールボックス / 配布リスト / メールが有効なセキュリティ グループを作成する

アプリの承認ユーザーに Exchange 管理者 ロールを割り当てない場合は、アプリにカスタム ロールを追加して上記の機能が利用可能であることを確保します。詳細については、アプリへのカスタム役割の追加方法 を参照してください。

カスタム アプリ プロファイル権限

NOTE

AvePoint Online Services は、Exchange Web Services (EWS) から Microsoft Graph への移行を実行しています。この移行の一環として、Gmail から Exchange Online への移行の場合、管理者は AvePoint アプリケーションを再認証して必要な Microsoft Graph アクセス許可を付与するか、以下の Microsoft Graph API アプリケーションのアクセス許可を移行先カスタム Azure アプリに追加する必要があります。

  • Contacts.ReadWrite
  • Mail.ReadWrite
  • MailboxFolder.ReadWrite.All
  • MailboxItem.ImportExport.All
  • MailboxItem.Read.All
  • MailboxSettings.ReadWrite
  • Tasks.ReadWrite.All

テナント所有者またはサービス管理者のロールを持っている場合、AvePoint Online Services > 管理 > アプリ管理 でカスタム アプリ プロファイルを作成して、カスタム Azure アプリを使用している Microsoft 365 テナントに接続することができます。

カスタム アプリ プロファイルを作成するには、以下の説明を参照してください。

  1. Microsoft Entra ID で証明書を準備します。詳細については、カスタム Azure アプリ用の証明書の準備 を参照してください。

    証明書がある場合、このステップを無視することができます。

  2. Microsoft Entra IDでカスタム Azure アプリを作成します。詳細については、カスタム Azure アプリの作成 を参照してください。

  3. テナントを AvePoint Online Services に接続 します。

  4. AvePoint Online Services で カスタム Azure アプリ用アプリ プロファイルを作成 します。

NOTE

アプリ プロファイルの再承認時に権限の更新がある場合、承認後、アプリ プロファイルがトークンの更新を完了するまで約 1 時間がかかります。その間、アプリ プロファイルを移行の実行に使用することはできません。

以下の表の内容に従って、Exchange Online 移行に必要な API アクセス許可を追加してください。

以下のことに注意してください。

  • Exchange Online テナントの検出を実行する場合、アプリを承認するアカウントがメールボックス (Exchange ライセンスの割り当てまたは PowerShell の使用のいずれかによって作成されているメールボックス) を持っていることを確認してください。

  • 以下の場合に、カスタム アプリに Exchange 管理者 ロールを割り当てる必要があります。詳細については、以下の Exchange 管理者ロールのアプリへの割り当て方法 を参照してください。

    • Exchange Online PowerShell を使用してアプリを承認するアカウントのメールボックスを作成する

    • 移行先で共有メールボックス / 配布リスト / メールが有効なセキュリティ グループを作成する

    アプリの承認ユーザーに Exchange 管理者 ロールを割り当てない場合は、アプリにカスタム ロールを追加して上記の機能が利用可能であることを確保します。詳細については、アプリへのカスタム役割の追加方法 を参照してください。

APIアクセス許可タイプ目的
Office 365 Exchange Onlinefull_access_as_app
(Use Exchange Web Services with full access to all mailboxes)
アプリケーションすべてのメールボックスからアイテムを取得して移行します。
*注意: この権限をアプリに追加しない場合、アプリに RBAC 割り当てを作成して、特定のメールボックスへのアクセス権のみをアプリに付与します。詳細については、ApplicationImpersonation ロールなしでのメールボックスの移行方法 セクションのオプション 3 を参照してください。
(移行に EWS を使用している場合に必要です。)
Office 365 Exchange OnlineExchange.ManageAsApp
(Manage Exchange As Application)
アプリケーションGoogle グループおよびメールボックスのアイリアスを使用します。
(移行に Graph API または EWS を使用している場合に必要です。)
Microsoft GraphUser.Read.All
(Read and write all users’ full profiles)
アプリケーションMicrosoft 365 ユーザー プロファイルの情報を取得します。
(移行に Graph API または EWS を使用している場合に必要です。)
Microsoft GraphCalendars.ReadWrite
(Read and write calendars in all mailboxes)
アプリケーション移行元イベント出席者の応答状態を移行先に保持する場合に必要です。
(移行に Graph API または EWS を使用している場合に必要です。)
Microsoft GraphContacts.ReadWrite
(Read and write contacts in all mailboxes)
アプリケーションメール アドレスを置き換えるため、連絡先を取得して更新します。
(移行に EWS の代わりに Graph API を使用している場合に必要です。)
Microsoft GraphMail.ReadWrite
(Read and write mail in all mailboxes)
アプリケーションメールを取得し、競合するメールを削除します。
(移行に EWS の代わりに Graph API を使用している場合に必要です。)
Microsoft GraphMailboxFolder.ReadWrite.All
(Read and write all the users' mailbox folders)
アプリケーションメールボックス フォルダーを取得してリストアします。
(移行に EWS の代わりに Graph API を使用している場合に必要です。)
Microsoft GraphMailboxItem.ImportExport.All
(Allows the app to perform backup and restore for all mailbox items)
アプリケーションメールボックス アイテムを取得します。アーカイブ メールボックスに関与する場合に必要です。
(移行に EWS の代わりに Graph API を使用している場合に必要です。)
Microsoft GraphMailboxItem.Read.All
(Read all the users' mailbox items)
アプリケーション競合するアイテムを識別するため、メールボックス アイテムを取得します。
(移行に EWS の代わりに Graph API を使用している場合に必要です。)
Microsoft GraphMailboxSettings.ReadWrite
(Read and write all user mailbox settings)
アプリケーション受信トレイのルールなど、メールボックス設定をリストアします。
(移行に EWS の代わりに Graph API を使用している場合に必要です。)
Microsoft GraphTasks.ReadWrite.All
(Read and write all users’ tasks and tasklists)
アプリケーション競合するタスクを削除します。
(移行に EWS の代わりに Graph API を使用している場合に必要です。)
Microsoft GraphGroup.ReadWrite.All
(Read and write all groups)
アプリケーションアプリに Exchange 管理者 ロールを割り当てない場合にのみ必要です。Microsoft 365 グループのメールボックスおよびメールボックス タイプを取得し、移行先で Microsoft 365 グループのメールボックスを作成します。
(移行に EWS を使用している場合に必要です。)

簡単に使用するため、以下のコマンドを直接使用して、マニフェスト を介して必要な API アクセス許可を Microsoft 365 テナントに追加することができます。

"requiredResourceAccess": [
	{
		"resourceAppId": "00000003-0000-0000-c000-000000000000",
		"resourceAccess": [			
			{
				"id": "df021288-bdef-4463-88db-98f22de89214", //Required when using either the Graph API or EWS for migration.
				"type": "Role"
			},
			{
				"id": "ef54d2bf-783f-4e0f-bca1-3210c0444d99", // Required when using either the Graph API or EWS for migration.
				"type": "Role"
			},
			{
                "id": "6918b873-d17a-4dc1-b314-35f528134491", //Required when using the Graph API instead of EWS for migration.
                "type": "Role"
            },
            {
                "id": "e2a3a72e-5f79-4c64-b1b1-878b674786c9", //Required when using the Graph API instead of EWS for migration.
                "type": "Role"
            },
            {
                "id": "fef87b92-8391-4589-9da7-eb93dab7dc8a", //Required when using the Graph API instead of EWS for migration.
                "type": "Role"
            },
            {
				"id": "76577085-e73d-4f1d-b26a-85fb33892327", //Required when using the Graph API instead of EWS for migration.
				"type": "Role"
			},
			{
				"id": "7d9f353d-a7bd-4fbb-822a-26d5dd39a3ce", //Required when using the Graph API instead of EWS for migration.
				"type": "Role"
			},
			{
				"id": "6931bccd-447a-43d1-b442-00a195474933", //Required when using the Graph API instead of EWS for migration.
				"type": "Role"
			},
			{
				"id": "44e666d1-d276-445b-a5fc-8815eeb81d55", //Required when using the Graph API instead of EWS for migration.
				"type": "Role"
			},
			{
				"id": "62a82d76-70ea-41e2-9197-370581804d09", //Required when using the EWS for migration.
				"type": "Role"
			}
		]
	},
	{
		"resourceAppId": "00000002-0000-0ff1-ce00-000000000000",
		"resourceAccess": [
			{
				"id": "dc890d15-9560-4a4c-9b7f-a736ec74ec40", //Required when using the EWS for migration.
				"type": "Role"
			},
			{
				"id": "dc50a0fb-09a3-484d-be87-e023b12c6440", //Required when using either the Graph API or EWS for migration.
				"type": "Role"
			}
		]
	}
],

サービス アカウント権限

Microsoft 365 テナントに AvePoint Online Services を接続するには、テナントの所有者およびサービス管理者は Microsoft 365 に対して サービス アカウント プロファイルの作成 を実行することもできます。

NOTE

多要素認証 (MFA) が有効なユーザーは、移行を実行するためのサービス アカウントとして使用することはできません。その代わりに、委任アプリ プロファイルを使用することができます。

サービス アカウントは以下の要件を満たすメールボックス (Exchange ライセンスの割り当てまたは PowerShell の使用のいずれかによって作成されているメールボックス) を持っていることを確認してください。

NOTE

サービス アカウントがメールボックスを持っていることを確認するには、Microsoft 365 管理センター > ユーザー > アクティブなユーザー に移動して、サービス アカウントの ライセンスとアプリ タブで Exchange Online を選択します。

必須権限注記
移行内の移行先メールボックスに対する ApplicationImpersonation ロールまたは フル アクセス 許可Microsoft は、Exchange Online の ApplicationImpersonation ロールを廃止することを発表しました。詳細については、Exchange Online の ApplicationImpersonation ロール廃止の影響と対応策 を参照してください。
移行で Google メールボックスを移行しない場合、ApplicationImpersonation ロールを追加せずに フル アクセス 許可を付与することができます。
Mail Recipients ロールGmail 移行の実行中にメールボックスを取得します。
Mail Recipient Creation ロール移行先で共有メールボックスおよびリソース メールボックスを作成する場合に必要です。
Distribution Groups ロールGoogle グループまたは配布グループを移行する場合に必要です。
Security Group Creation and Membership ロールGoogle グループをメールが有効なセキュリティ グループに移行する場合に必要です。サービス アカウントが Exchange 管理者 である場合、このロールが必須ではありません。
管理センターの グループ管理者 ロールGoogleグループを既存の Microsoft 365 グループに移行する場合に必要です。

アプリ プロファイルも使用する場合の必須権限

移行先 Exchange Online でサービス アカウント認証とアプリ プロファイル認証の両方を使用しており、かつアプリ プロファイルが Exhcnage 管理者 ロールを持っている場合、サービス アカウントに必要な権限がありません。アプリ プロファイルが Exhcnage 管理者 ロールを持っていない場合、サービス アカウントはメールボックスを持っており、かつ以下の権限が付与されている必要があります。

NOTE

サービス アカウントがメールボックスを持っていることを確認するには、Microsoft 365 管理センター > ユーザー > アクティブなユーザー に移動して、サービス アカウントの ライセンスとアプリ タブで Exchange Online を選択します。

移行先サービス アカウント権限注記
Mail Recipients ロールGmail 移行の実行中にメールボックスを取得します。
Mail Recipient Creation ロール移行先で共有メールボックスおよびリソース メールボックスを作成する場合に必要です。
Distribution Groups ロールGoogle グループまたは配布グループを移行する場合に必要です。
Security Group Creation and Membership ロールGoogle グループをメールが有効なセキュリティ グループに移行する場合に必要です。

委任アプリ プロファイル権限

Fly 委任アプリ プロファイルまたはカスタムの委任アプリ プロファイルを使用してワークスペースに接続することができます。

委任アプリ プロファイルを使用するには、以下のことに注意してください。

  • 同意ユーザーのライセンスと権限の要件は、サービス アカウントのライセンスと権限の要件と同じです。詳細については、サービス アカウント権限 を参照してください。

  • 委任アプリ プロファイルの同意ユーザーの多要素認証 (MFA) が有効になっている場合、MFA の有効化後に委任アプリ プロファイルを承認または再承認する必要があります。MFA の有効化後にアプリ プロファイルを承認または再承認しないと、委任アプリ プロファイルを使用している移行ジョブは失敗します。

  • アプリ プロファイルの再承認時に権限の更新がある場合、承認後、アプリ プロファイルがトークンの更新を完了するまで約 1 時間がかかります。その間、アプリ プロファイルを移行の実行に使用することはできません。

  • 21Vianet テナントに委任アプリ プロファイルのみを使用している場合、Exchange PowerShell を使用することはできません。

必要な権限を持っているカスタム委任アプリ プロファイルを使用するには、Fly 委任アプリ プロファイルの権限 セクションを参照してください。

必要な権限を持っているカスタムの委任アプリ プロファイルを使用するには、以下の説明を参照してください。

  1. Microsoft Entra ID でアプリを登録した後、以下の表内の権限をアプリに追加します。

    APIアクセス許可タイプ目的
    Office 365 Exchange OnlineEWS.AccessAsUser.All
    (Access mailboxes as the signed-in user via Exchange Web Services)
    委任済み指定したユーザーにアクセスし、データをインポートします。
    Office 365 Exchange OnlineExchange.Manage
    (Manage Exchange configuration)
    委任済みメールボックス権限、配布リスト、動的配布リストを移行する Exchange PowerShell を使用します。
    Microsoft GraphDomain.Read.All
    (Read domains)
    委任済みMicrosoft 365 グループ メールボックスを作成します。
    Microsoft GraphGroup.ReadWrite.All
    (Read and write all groups)
    委任済みMicrosoft 365 グループ メールボックスを作成します。

    簡単に使用するため、以下のコマンドを直接使用して、マニフェスト を介して必要な API アクセス許可を Microsoft 365 テナントに追加することができます。

    "requiredResourceAccess": [
     	{
     		"resourceAppId": "00000003-0000-0000-c000-000000000000",
     		"resourceAccess": [
     			{
     				"id": "2f9ee017-59c1-4f1d-9472-bd5529a7b311",
     				"type": "Scope"
     			},
     			{
     				"id": "4e46008b-f24c-477d-8fff-7bb4ec7aafe0",
     				"type": "Scope"
     			}
     		]
     	},
     	{
     		"resourceAppId": "00000002-0000-0ff1-ce00-000000000000",
     		"resourceAccess": [
     			{
     				"id": "ab4f2b77-0b06-4fc1-a9de-02113fc2ab7c",
     				"type": "Scope"
     			},
     			{
     				"id": "3b5f3d61-589b-4a3c-a359-5dd4b5ee5bd5",
     				"type": "Scope"
     			}
     		]
     	}
     ],
  2. アプリの画面の左側の [認証] をクリックします。

  3. [プラットフォームを追加] をクリックします。

  4. プラットフォームの構成 パネルで Web を選択します。

  5. Web の構成 パネルで、リダイレクト URI フィールドに AvePoint Online Services URL (https://www.avepointonlineservices.com) を入力します。

    Web の構成パネル

  6. [構成] をクリックします。

  7. 認証 ページで アクセス トークン および ID トークン チェックボックスを選択します。

    アクセス トークンおよび ID トークン チェックボックス

  8. [保存] をクリックします。

  9. AvePoint Online Services で モダン モード を使用してアプリ用のアプリ プロファイルを作成するには、委任されたアクセス許可を持つカスタム Azure アプリへの同意 を参照してください。

    NOTE

    アプリに同意する際に、アプリに管理者の同意権限を付与し、パブリック クライアント フローを許可している場合、グローバル管理者の同意 または ユーザーの同意 方法を選択することができます。そうしない場合、グローバル管理者の同意 方法のみを使用できます。