Providing credentials to connect to Office 365
You can use Modern Authentication (OAuth) to provide credentials to connect to Office 365. To do this, add the Modern Authentication (OAuth) credentials using the Credential Editor. Go to the Quadrotech Archive Shuttle Planning Guide for more information.
|
|
NOTE: Windows Remote Manager (WinRM) needs to allow basic authentication to be able to proceed. Archive Shuttle was tested on Exchange Online PowerShell Module v2.0.5 and requires WinRM to be enabled. |
Configuring Application Impersonation
In order for the accounts specified above to be used to ingest data into Office 365 mailboxes of Personal Archives, the Application Impersonation role needs to be assigned to the user. This can be done in the Office 365 Portal or via PowerShell.
To do the required steps using PowerShell, follow the steps below:
1.Log in to a server that has Windows PowerShell installed
2.Issue the following commands in PowerShell, comments and responses are noted below each command:
$User-Credential = Get-Credential
Supply values for the following parameters:
Credential
A pop-up will appear asking for a username and password. The Global Administrator that needs to have Application Impersonation granted to them should be input.
|
|
NOTE: The Exchange Online Management PowerShell module is required. To learn more, click here. |
Connect-ExchangeOnline -UserPrincipalName name@domain.com
This connects a PowerShell session to Office 365 using the credentials that were just entered.
Import-PSSession $Session
This activates the above session. It may take a few seconds for this to return to the command prompt.
New-ManagementRoleAssignment Name:VaultAdminImpersonation Role:ApplicationImpersonation User:<upn>
This grants the user specified the Application Impersonation role.
|
|
NOTE: Customers may have a standard system for naming role assignments. That naming convention can be used, but the required role is fixed by Office 365 Application Impersonation. |
For more on Application Impersonations, click here.
Configuring Office 365 connection rather than autodiscover
Normally the Office 365 Module will use the default configuration and be able to contact Office 365. In some situations it might be necessary to configure a specific URL to access Office 365. This can be done on the System Configuration page as follows:
1.Go to the System Configuration page in Archive Shuttle.
2.Click on Office 365 Module
3.Locate the Connection URL entry near the bottom, and update it to show the required value.
4.Click Save to commit the changes.
Configuring access to Office 365 through a proxy server
If the migration environment needs to use a web proxy to access HTTP or HTTPS sites on the internet, then the Office 365 module needs to be configured to also route traffic that way.
1.Log in to the server or workstation where the Office 365 Module is currently deployed using the account that is used to run the Archive ShuttleOffice 365 Service.
2.Browse to the folder where the module is installed, and locate the file ArchiveShuttle.Module.Office365.exe.config and open it in a text edit.
3.Remove the <!and > from the line containing the defaultProxy and set the value to be one of:
IEConfig
AutoDetect
WinHttpConfig
NoProxyServer
4.Save and close the file.
Restart the Office 365 Module service using Windows Service Control Manager.