Guide - Aryson MBOX Converter

Step 4: Select the Export to Email Clients option and choose Microsoft 365 as the target destination.

Step 5: Authenticate the Microsoft 365 Account

Choose either Method A or Method B to authenticate the active Microsoft 365 account using valid login credentials.

1. Use OAuth 2.0 authentication

1. Enter your Microsoft admin account email and click on Authenticate.

2. Log In To Your Account

1. Select an Account
   • In the Pick an account window, click the Microsoft account you want to use.
   • Alternatively, select Use another account if your account is not listed.
2. Provide your password and click Sign in.
3. Approve Multi-Factor Authentication (MFA)
   • If prompted, open the Microsoft Authenticator app on your mobile device.
   • Approve the sign-in request.
   • If a matching number is displayed (e.g., 53 ), enter that number in the Authenticator app and approve the request.
4. Authentication Successful
   • Once verification is completed, a confirmation message will appear: "Authentication complete. You can close the browser and return to the application."
   • Close the browser window.

Note: While selecting the Office 365 account in the browser window, make sure you have already logged in to the required account before.

Note: Sign in to the required Microsoft 365 account in your browser before starting the migration. If multiple browser windows are open with different accounts, use the one where the required Microsoft ID is already logged in, as authentication will proceed only in that browser.

2. Authenticate Using Application Credentials

1. Turn off the Use OAuth 2.0 Authentication option.
2. Provide the Microsoft 365 Admin Account, Application (Client) ID, Client Secret, and Tenant ID to establish and authenticate the connection.

Enter Azure Application Details

Fill in the following information from your Azure app registration:

If you choose Application Credentials Authentication (Client ID, Client Secret, and Tenant ID), you must first create an Azure App Registration and assign the required API permissions in Microsoft Entra ID (Azure AD).

For complete instructions on creating the Azure Active Directory application and enabling API permissions, visit:

Create Azure Active Directory and Enable API Permission Guide

In the guide at step 17, you need to add the required API permissions. The image below lists all the API permissions that must be configured for successful authentication and migration.

3. After generating the credentials, fill in the required fields and click on Authenticate.

B.1: Select Mailbox Mapping Mode

Choose how to map the source files to the destination Microsoft 365 mailboxes.

• Migrate All Files to Selected Mailbox(es): Import all selected files into the specified Microsoft 365 mailbox(es).
• Map Each File to Specific Mailbox(es): Assign individual source files to their respective Microsoft 365 destination mailboxes.
• Next: Select the required mapping option and click Next to proceed with mailbox mapping and migration.

B 1.1: Migrate Files to Selected Mailboxes

• Fetch Users Automatically: Retrieve all available mailboxes from the authenticated Microsoft 365 tenant.
• Import via CSV: Optionally upload a CSV file to add specific destination mailbox users.
• Search Mailboxes: Use the search function to quickly locate a specific mailbox.
• Verify User Information: Review the name, user ID, mailbox type, and validation status of each mailbox.
• Select Destination Mailboxes: Select the required mailboxes individually or use Select All.
• Check Validation Status: Confirm that the selected mailboxes show Allowed status before proceeding.
• Proceed: Click Next to continue to mailbox mapping and start the migration configuration.

Note:

• Allowed indicates a licensed and valid mailbox, while Denied indicates a non-licensed or invalid mailbox.
• Mailbox types may include User Mailbox and Shared Mailbox.
• Only mailboxes with Allowed status can be selected as migration destinations.

Import Users via CSV

1. Enable CSV import and download the sample CSV template.
2. Enter mailbox details in the required format and save the file.
3. Click Import CSV and browse to the updated CSV file.
4. Review the imported users and verify their validation status.
5. Select the required mailboxes and click Next to continue.

B.1.2: Map Each File to the Appropriate Mailbox(es)

1. Verify Source Folders: Review the folders listed under Source Folder and confirm that all required mailbox data has been loaded successfully.
2. Assign Target Mailboxes: Click the -- Select Target Mailboxes -- dropdown corresponding to each source folder and assign the appropriate destination mailbox.
3. Select Folders: Use the checkboxes on the right to select or deselect folders for migration. Use Select All to include all available folders.
4. Import Mapping via CSV (Optional): Select CSV Import to upload a predefined mailbox-mapping file when migrating multiple user profiles in a single operation.

5. Save and Migrate: Click Save Mapping & Start >> to lock in your folder configuration and begin the migration process.

Step 6: Configure Migration Settings and Filters

Configure the following options to control the migration scope, destination, and folder structure:

• Date Range Filter: Specify a start date and end date to migrate only emails within the selected period.
• Custom Output Folder: Define a preferred destination path for saving the migrated data.
• Skip Existing Exports: Exclude items that have already been migrated to avoid duplicate processing and reduce migration time.
• Follow Tree Hierarchy: Preserve the source mailbox’s original folder hierarchy in the destination.
• Map with Default Mailboxes: Automatically map standard source folders to their corresponding default folders in the target mailbox.

Note: Mapping is available only when the selected MBOX folder contains a Google Takeout file. Mapping is not supported when using the Thunderbird loading method.

Step 7: Configure Advanced Migration Filters

• Attachment Handling: Configure how attachments are processed during migration. Enable the option to exclude attachments when they are not required in the destination.
• Duplicate Detection: Enable duplicate filtering to avoid migrating identical email items. The software identifies duplicates by comparing attributes such as To, From, Subject, Body, and CC.

Step 8: Click Start Export to begin the MBOX to Office 365 migration conversion process.

Step 9: Monitor and Complete the MBOX Migration

After clicking Start Export, monitor the migration progress and review transfer statistics in real time.

• Source MBOX File: Verify the MBOX file selected for conversion.
• Target Format: Confirm the selected output format and destination for the converted data.
• Mailbox Items Processed: Track the number of emails, folders, and other mailbox items being processed.
• Conversion Status: Monitor the current status of the conversion process.
• Execution Time: View the total time taken to complete the conversion.
• Total Messages: Check the number of email messages processed successfully.
• Target Location: Verify the destination path where the converted data is being saved.
• Progress Bar: Monitor the overall conversion progress in real time.
• Stop Conversion: Stop the conversion process if required

Step 10: Verify the Conversion Results

Once the conversion is completed, the software displays the message “All selected data has been exported successfully.” You can then use the available options to review the results or initiate another conversion task.

• Export Log: Open the detailed log report to review the conversion status, processed items, and export results.
• Start New Export: Initiate a new MBOX conversion or export task as required.

Step 4: Mark the Export to Email Clients radio button and select IMAP as the destination.

Step 5: Configure IMAP Server and Authenticate

1. Enter the destination email address.
2. Provide the app password or mailbox password.
3. Specify the IMAP Server Host and IMAP Port Number.
4. Click on the Server List option to fetch supported IMAP server details automatically.
   • Select the IMAP host as desired or search for a specific one and click Continue.

1. Enable Show Credentials to verify the entered password.
2. Click Authenticate to validate the mailbox connection and proceed with the migration.

Step 6: Configure Additional MBOX Conversion Options

1. Configure General Conversion Settings

• Date Range Filter: Select a specific date range to convert only the required emails from the MBOX file.
• Custom Output Folder: Specify the destination folder where the converted files, logs, and reports will be saved.
• Skip Existing Items: Skip items that have already been processed or exported to prevent redundant conversion.

2. Configure Advanced Conversion Options

• Attachment Handling: Choose whether to exclude attachments while converting the MBOX data.
• Duplicate Detection: Identify and skip duplicate emails based on To, From, Subject, Body, and CC fields.

Step 7: Click on the Start Export button to begin the MBOX to IMAP migration.

Step 8: Monitor and Complete the MBOX Migration

After clicking Start Export, monitor the migration progress and review transfer statistics in real time.

• Source MBOX File: Verify the MBOX file selected for conversion.
• Target Format: Confirm the selected output format and destination for the converted data.
• Mailbox Items Processed: Track the number of emails, folders, and other mailbox items being processed.
• Conversion Status: Monitor the current status of the conversion process.
• Execution Time: View the total time taken to complete the conversion.
• Total Messages: Check the number of email messages processed successfully.
• Target Location: Verify the destination path where the converted data is being saved.
• Progress Bar: Monitor the overall conversion progress in real time.
• Stop Conversion: Stop the conversion process if required

Step 9: Verify the Conversion Results

Once the conversion is completed, the software displays the message “All selected data has been exported successfully.” You can then use the available options to review the results or initiate another conversion task.

• Export Log: Open the detailed log report to review the conversion status, processed items, and export results.
• Start New Export: Initiate a new MBOX conversion or export task as required.

Step 4: Select Google Workspace under the Export to Email Clients drop-down list.

Step 5: Authenticate your Google Workspace Account

Log in via the Workspace admin account and JSON key, and click Authenticate.

You can generate a JSON file with the help of the detailed guide.

Step 6: Map Source Files to Google Workspace User Accounts

Associate the selected source file with the corresponding Google Workspace mailbox before starting the migration.

1. Select the imported source file from the mapping list.
2. Click Select Directory Users and choose the target Google Workspace user account.
   • Search or select the required User ID to map and click Apply.

3. Alternatively, you can import a CSV file for bulk user mapping.
   • Click on the Sample CSV button to save a demo CSV file.
   • Afterwards, click on the Import CSV button to import the saved CSV file.

• Click ok and click on Select CSV users.
• Select the required user IDs of the users and click Apply.

Step 7: Configure Migration Settings

Configure the available settings to control the MBOX conversion and export process.

1. Apply General Filters:

• Date Range Filter: Convert emails and other mailbox items within a specified start and end date.
• Custom Output Folder: Select a destination location for saving the converted files, logs, and reports.
• Skip Existing Exports: Prevent previously exported items from being processed again during subsequent conversions.
• Preserve Folder Hierarchy: Maintain the original MBOX mailbox folder structure in the output.
• Map Default Folders: Automatically map standard MBOX folders, such as Inbox, Sent Items, Drafts, and Deleted Items, to their corresponding folders in the selected destination format.

2. Apply the Advanced Filters:

• Attachment Handling: Choose whether to include or exclude email attachments during conversion.
• Duplicate Detection: Identify and skip duplicate emails based on criteria such as To, From, Subject, Body, and CC.

Step 8: Click the Start Export button to begin the MBOX to Google Workspace migration.

Step 9: Monitor and Complete the MBOX Migration

After clicking Start Export, monitor the migration progress and review transfer statistics in real time.

• Source MBOX File: Verify the MBOX file selected for conversion.
• Target Format: Confirm the selected output format and destination for the converted data.
• Mailbox Items Processed: Track the number of emails, folders, and other mailbox items being processed.
• Conversion Status: Monitor the current status of the conversion process.
• Execution Time: View the total time taken to complete the conversion.
• Total Messages: Check the number of email messages processed successfully.
• Target Location: Verify the destination path where the converted data is being saved.
• Progress Bar: Monitor the overall conversion progress in real time.
• Stop Conversion: Stop the conversion process if required

Step 10: Verify the Conversion Results

Once the conversion is completed, the software displays the message “All selected data has been exported successfully.” You can then use the available options to review the results or initiate another conversion task.

• Export Log: Open the detailed log report to review the conversion status, processed items, and export results.
• Start New Export: Initiate a new MBOX conversion or export task as required.