How the SharePoint Migration Tool works

The SharePoint Migration Tool authenticates to the destination tenant after which you are prompted for the source file location and destination SPO site collection where you want the files to be migrated. After you submit the migration jobs by clicking Migrate, the scanning, packaging, uploading, and importing steps are performed in parallel across all the files submitted for migration.

The SharePoint Migration Tool authenticates to the destination tenant after which you are prompted for the source file location and destination SPO site collection where you want the files to be migrated. After you submit the migration jobs by clicking Migrate, the scanning, packaging, uploading, and importing steps are performed in parallel across all the files submitted for migration.

Note

Use a Site Collection administrator account on the target SharePoint Online site when prompted for credentials.

AUTHENTICATION: After opening the tool, the first thing you must do is authenticate to the destination -- the tenant where you will be migrating your files. Providing your username and password to the tenant associates the migration jobs you submit to this account. This allows your to resume your migration from another computer if needed by logging in with the same credentials. This account should be a site collection administrator of the destination you want to migrate to.The following authentication methods are supported:

  • NTLM
  • Kerberos
  • Forms
  • ADFS
  • Multi-factor authentication
  • SAML based claims
  • Client certificate authentication

[!IMPORANT] If multiple authentication methods including NTLM or Kerberos, are enabled in the on-premises SharePoint Web Application, NTLM and Kerberos authentication are not supported by the SharePoint Migration Tool. Please use a secondary form of authentication or convert the Web Application to use NTLM and/or Kerberos authentication only.

SCAN: After you click Migrate, a scan is performed on every file. A scan is always performed, even if you elect to not migrate your files (see Advanced Settings). The scan verifies that there is access to the data source and write access to the SharePoint Online destination. It also scans the files for known potential issues.

PACKAGING: In the packaging stage, a content package is created that contains a manifest.

UPLOAD: In the upload stage, the content package is uploaded to Azure with the manifest. Before a migration job can be accepted from an SPO provided Azure container, the files and manifest are encrypted at rest using the AES-256-CBC standard.

IMPORT: During the import phase, the key is provided to SPO SAS. Only Azure and SPO are interacting to fetch and migrate the data to the destination. This process is a timer job based, but does not prevent other jobs from being queued up. During the import, a report is created in the working folder and live updates are made. After the migration job is completed, the log is stored in the Azure container and a final report is created.

SESSION AND RESUME: While the migration is being performed, the tool saves information of the session in a hidden list on the users OneDrive for Business site. This allows the migration tool to resume any previous migration sessions.

Encryption and security

During the upload and import phases, data is encrypted and Azure containers and keys are generated.

Important

The Sharepoint Online service and a select number of engineers can run maintenance commands against them, but they do not have direct access to the accounts. Datacenter technicians are not prepped with knowledge of how data is laid out on disk, and do not have ready access to equipment to mount disks. All drives are physically destroyed before leaving the datacenter. Physical security is also in place across all of our datacenters.

Each container is dedicated to the customer and not reused. The data is stored in the Azure blob anywhere from 30 to 90 days after which it is deleted. When the data is deleted, the files are de-linked and later soft deleted from disk. A file in an account and on-disk are may be shared across many servers. The same process is used for replicas, including backup copies (geo-replicated data if applicable).

The random, single-use default container key is generated programmatically, and is only valid for 3 days. This key is the only way to gain access to the container. SharePoint Online never stores the key.

The container itself lives longer than the key. The container is purged anywhere from 30 to 90 days from its creation date. The container is housed in a shared Microsoft storage outside the tenant but within the region and is protected using the container key.

If your key is lost or obtained by someone else, there are two defenses in place that protect you. First, the container only enables read/write operations. The container has no list which means you would need to know the details of the files stored in the container in order to read or write to them. Secondly, the files are encrypted at rest with AES-256-CBC.

Important

Only those who have the key have access to the container. Other users in the subscription or the tenant do not have access.

Note

The SharePoint Migration Tool is not available for users of Office 365 operated by 21Vianet in China. It is also not available for users of Office 365 with the German cloud using the data trustee, German Telekom. However, it is supported for users in Germany whose data location is not in the German datacenter.