4.3 - Target Connections

Follow

“Target Connections” pane is located at the right side of the main screen, and is designed to display the user created Target connections and its content containers.

 

mceclip0.png Add (SharePoint 2016/2019) Connection Adds a new SharePoint 2013/2016 Target Connection
mceclip1.png Add Office 365 icon Opens a dialog to add a new Office 365 Target Connection
  mceclip2.png Edit Target Connection Edits configuration of selected target connection
mceclip3.png Refresh Target Connection Refreshes the content tree view for selected connection

 

Click on mceclip5.png icon (for Office 365), or the mceclip4.png (for SharePoint) located in Target Connection ribbon group to create a target connection. This launches a new dialog.

SharePoint 2016/2019 Site Collection Connection

mceclip12.png

The following fields needs to be configured for a SharePoint Connection:

  • Name: Name of connection to uniquely identify the connection within the
    workspace.
  • Site Collection URL: URL of the target SharePoint Site Collection.
  • UserName: The Username for connecting to SharePoint. The user should be an administrator for the target Site Collection.
  • Password: The Password for the above-mentioned user.
  • Domain Name: The domain name where SharePoint user is created.
  • Default User: The default user to be used for setting Author/Editor fields in the target Site Collection if the source user is not found. This field is optional.
    Click on the "Test Connection" button to verify that the details entered are correct.
    Click on the “Add” button to add the SharePoint connection.

SharePoint Online Connection 

For more information on authentication options see Accessing Microsoft 365 from PMA – Proventeq Migration Accelerator

 

The following connection types are supported in SharePoint Online: 

  • Tenant – Add Office 365 tenant connection to migrate across site collections and OneDrive sites. 
  • Site Collection – Add site collection connection to migrate to a particular site collection. 

blobid0.png

The following fields needs to be configured for a SharePoint Connection:  

  • Name: Name of connection to uniquely identify the connection within the workspace. 
  • Connect To: Select Tenant or Site Collection. 
  • SharePoint URL: The SharePoint tenant admin URL 

The general recommendation is to use App based Authentication whenever possible.

 

SharePoint Online App Only Authentication 

You need to send below the URL to Global Administrator to provide admin consent and return to the application without granting consent. 

https://login.microsoftonline.com/<TenantID>/adminconsent?client_id=d1e5e128-9660-4380-aabb-3e0061c1047c  

Refer go below link to get tenant-id for your organisation and replace in above URL. 

https://docs.microsoft.com/en-us/onedrive/find-your-office-365-tenant-id    

 

blobid1.png

If user is Global admin user, then the user will get a consent screen and user will need to accept the consent. 

blobid2.png 

Tick the checkbox for giving the consent on behalf of your organisation and click on the “Accept” button. This will redirect you back to Add Target Connection screen. 

If user is not Global Admin, then user will need to request Admin user to login and accept the consent for Proventeq Migration Accelerator application.  

 

blobid3.png

Note: To know more about Azure application permissions and admin consent in Microsoft identity platform endpoint. Please refer the below link:

https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-permissions-and-consent

 

blobid4.png

App Based Authentication Settings: 

  • Username: The Username for connecting to SharePoint. If we select Connect to as Tenant option, then user should be SharePoint Online Admin or Global Admin of the Office365 tenant. If we select Connect to as Site Collection, then the user should be a site collection administrator. 
  • Password: The Password for the above-mentioned user. 
  • Default User: The default user to be used for setting Author/Editor fields in the target Site Collection if the source user is not found. This field is optional. 

Click on the "Test Connection" button, a screen will pop-up to sign into the account of the whitelisted username by Microsoft. 

blobid5.png

Click on the “Add” button to add the SharePoint connection. 

 

SharePoint Online Client Id Authentication 

blobid6.png

Client Id Authentication Settings: 

  • Client ID: The app-only principal Client ID. 
  • Client Secret: The app-only principal Client Secret. 
  • Default User: The default user to be used for setting Author/Editor fields in the target Site Collection if the source user is not found. This field is optional.  

Click on the "Test Connection" button to verify that the details entered are correct. 

Click on the “Add” button to add the SharePoint connection. 

Note: To set up app-only principal Client ID/Client Secret. Please refer the below link:  

https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azureacs

 

SharePoint Online Admin Credentials Authentication 

blobid7.png 

Admin Credentials Authentication Settings: 

  • Username: The Username for connecting to SharePoint. The user should be a site collection administrator for the target Site Collection or SharePoint Online Admin for the tenant level connection. 
  • Password: The Password for the above-mentioned user. 
  • Default User: The default user to be used for setting Author/Editor fields in the target Site Collection if the source user is not found. This field is optional. 

Click on the "Test Connection" button to verify that the details entered are correct. 

Click on the “Add” button to add the SharePoint connection. 

Note: If the domain is other than “. sharepoint.com" then update this application configuration file from Proventeq Migration Accelerator installation directory (typically "C:\Program Files\Proventeq\Proventeq Migration Accelerator\Proventeq.MigrationAccelerator.exe.config") 

<add key="SharePointOnlineDomainPart" value=".sharepoint.us" /> 

<add key="SharepointOnlineAzureEnvironment" value="USGovernment"/> 

Was this article helpful?
1 out of 1 found this helpful

Comments