Browser authentication

Connecting to your environment with Browser authentication is useful in the following situations:

• You have a MFA (multi-factor authentication) configuration.
• You are encountering network issues.
• The other authentication methods are not working.
• The site address of the environment is not linked to your windows account (when this scenario occurs with a Microsoft 365 environment, the ShareGate migration tool will set the Authentication to Browser by default).
• You are using Forms Based Authentication.

Note: The app supports most MFA configurations, but if you are having issues authenticating, it is possible that you may need to contact support to validate if your configuration is supported.

Index

• Prerequisites
• How-to

Prerequisites

To connect with browser authentication, you need the same permissions as when you run the migration or connect your environment. To see what permissions you need for each type of migration, see Microsoft administrative permissions.

How-to

1. Access your connection screen. This can be done from:
   • + Add connection in the Explorer.
   • Running a new Copy content only, Copy Structure and content, Import from file share, or Import from Google Drive task in Migration.
2. Enter the address of the site you are connecting to in the Site Address field of the connection panel.
   For more details on the connection process, see Connect to SharePoint and Microsoft 365.
3. In the Authentication dropdown, select Browser.
4. Click Connect.
5. A Browser Authentication window will now open.
   
   • Note: This is a secure Microsoft authentication session.
6. Enter either the email address, phone number, or Skype address which is associated to your account.
   • Note: The email associated with your account is usually your work email, if you are associated to an organization. If you forget your credentials, you can click the Can't access your account? button which will take you through steps to recover them quickly and securely.
7. Click Next.
8. You will now be signed in, and have access to your site(s).

If you are experiencing difficulties connecting to your environment, you can see our Connection troubleshooting section.

Tip: You can also use Browser authentication with PowerShell. For more information, see Connect Site.