# alimail-integration

Part of **ALIMAIL**

# Alibaba Mail Integration Console Guide

## Operations Overview

| Operation | Console Entry | Prerequisites | Description |
|----------|---------------|---------------|-------------|
| Integrate Alibaba Mail with Outlook | Console > Mail > Outlook Plug-in | Outlook client installed; Alibaba Mail account with access to organization address book | Install and configure the Outlook plug-in to access organizational contacts during email composition |
| Migrate Email Data | Products > Domains & Websites > Email > Manage | Alibaba Cloud account; domain info for POP3/IMAP/SMTP/WebMail; original email passwords; email data ≤1 TB; employee accounts set up | Perform bulk email migration from any IMAP/POP3 system to Alibaba Mail |
| Migrate Exchange Emails to Alibaba Mail | Console > Mail > Migration > Exchange Migration | Exchange 2007+; PowerShell access; valid SSL cert; AD server registry access; consistent email prefixes | Migrate emails from Microsoft Exchange using EWS with a superman account and throttling policy |

## Step-by-Step Instructions

### Integrate Alibaba Mail with Outlook

**Navigation**: Console > Mail > Outlook Plug-in

**Prerequisites**:
- Outlook client installed on Windows
- Alibaba Mail account with access to organization address book

1. Download the Outlook plug-in from the provided link  
   - Element: **http://aliyun-alimail-desktop.oss-cn-hangzhou.aliyuncs.com/Windows/AlimailOutlookPlugin_0.1.3_201705181120.exe** (link) — main content area  
   - Notes: The download link is for Windows only. The file is an .exe installer.

2. Install the downloaded plug-in on your local machine  
   - Element: **Install** (button) — installer window  
   - Notes: Run the .exe file and follow the installation prompts.

3. Open Outlook and verify that the Alibaba Mail plug-in is loaded  
   - Element: **Alibaba Mail** (menu) — top ribbon  
   - Notes: After installation, the plug-in should appear in the Outlook ribbon under 'Add-ins'.

### Migrate Email Data

**Navigation**: Products > Domains & Websites > Email > Manage

**Prerequisites**:
- An Alibaba Cloud account
- Domain name information for POP3, IMAP, SMTP, and WebMail services
- Original email account passwords (for bulk migration)
- Client configuration with updated SMTP server domain
- Email data size within 1 TB
- Completion of employee account and department structure setup

1. Access the Alibaba Cloud Console  
   - Element: **Console** (button) — upper-right corner

2. Navigate to Email Services page  
   - Element: **Domains & Websites > Email** (menu) — left-side navigation pane

3. Click Manage for the target domain  
   - Element: **Manage** (button) — Actions column

4. Log on to the mailbox administrator platform  
   - Element: **Logon** (button) — Basic Info tab of the Email Management page  
   - Notes: Use postmaster@domain.com and corresponding password. First-time login requires password change.

5. Create multiple accounts in batch  
   - Element: **Import/Export** (link) — DEPTs & Users > Employee Accounts  
   - Notes: Download template, fill it, and upload.

6. Create a mail group  
   - Element: **Create Mail Group** (button) — DEPTs & Users > Mail Groups  
   - Notes: After saving, click Manage Members to import members.

7. Enable email migration  
   - Element: **Enable Email Migration** (button) — Tools > Email Migration  
   - Notes: Configure migration parameters including original server address, port, SSL logon, and folder options.

8. Upload employee list via template  
   - Element: **Download template** (button) — Email Migration configuration page  
   - Notes: Fill original email addresses, save, and upload the file.

9. Confirm target accounts are imported  
   - Element: **Confirm** (button) — Migration confirmation screen

10. Monitor migration progress  
    - Element: **Search icon** (button) — Migration status view  
    - Notes: View all users' migration status.

11. Disable migration when complete  
    - Element: **Disable** (button) — Migration settings

| Parameter | Type | Required | Options/Values | Description |
|-----------|------|----------|----------------|-------------|
| Original email address | text_input | Yes | — | The email address in the source system that needs to be migrated. |
| Original server address | text_input | Yes | — | The hostname or IP address of the original email server (e.g., pop.sg.aliyun.com). |
| Port number (normal) | number_input | Yes | — | The port number used for unencrypted communication with the original email server. |
| Port number (encrypted) | number_input | Yes | — | The port number used for encrypted communication (SSL/TLS) with the original email server. |
| Include Domain in | dropdown | No | All domains, Specific domains only | Specifies whether to include all domains or only selected ones during migration. |
| Allow SSL logon | checkbox | No | — | Enables secure connection using SSL/TLS during migration. |
| Move Email history to Original Folder | radio | No | Yes, No, Specify a folder | Determines where migrated emails are stored after transfer. |

### Migrate Exchange Emails to Alibaba Mail

**Navigation**: Console > Mail > Migration > Exchange Migration

**Prerequisites**:
- Exchange 2007 or higher version
- Exchange administrators with PowerShell access
- Valid SSL certificate for Exchange web service
- Access to Active Directory server registry
- Consistent email address prefix between source and target systems

1. Check the Exchange EWS service certificate by accessing https://mail.domain.com/EWS/Exchange.asmx in a browser  
   - Element: **Continue** (button) — certificate warning dialog  
   - Notes: Ensure the certificate is valid and matches the domain name

2. Log in with an Exchange email account and password  
   - Element: **Log On** (button) — authentication dialog

3. Run Exchange PowerShell as administrator to create the superman account  
   - Element: (text_input) — PowerShell console  
   - Notes: Use the provided command: `New-Mailbox -UserPrincipalName superman@domain -Alias superman -Database "MDB1" -Name superman -OrganizationalUnit Users -Password $password -FirstName super -LastName man -DisplayName "super man" -ResetPasswordOnNextLogon $false`

4. Assign the ApplicationImpersonation role to the superman account  
   - Element: (text_input) — PowerShell console  
   - Notes: Command: `New-ManagementRoleAssignment -Name:impersonationAssignmentName -Role:ApplicationImpersonation -User:superman`

5. Grant full access permission to the superman account on user mailboxes  
   - Element: (text_input) — PowerShell console  
   - Notes: Command: `Add-MailboxPermission -Identity "user001" -User superman -AccessRights FullAccess -InheritanceType All`

6. Export all mailbox addresses to a CSV file  
   - Element: (text_input) — PowerShell console  
   - Notes: Command: `Get-Mailbox -database "MDB1" -resultsize unlimited |select primarysmtpaddress|Export-Csv -Path d:\allmailbox.csv -encoding utf8`

7. Batch authorize superman to access all user mailboxes  
   - Element: (text_input) — PowerShell console  
   - Notes: Command: `Import-CSV d:\allmailbox.csv | ForEach {Add-MailboxPermission -Identity $_.primarysmtpaddress -User superman -AccessRights FullAccess -InheritanceType All}`

8. Create a new throttling policy named SupermanPolicy with no restrictions  
   - Element: (text_input) — PowerShell console  
   - Notes: Command: `New-ThrottlingPolicy SupermanPolicy`

9. Set all throttling parameters to null to remove concurrency limits  
   - Element: (text_input) — PowerShell console  
   - Notes: Command: `Set-ThrottlingPolicy SupermanPolicy -RCAMaxConcurrency $null -RCAPercentTimeInAD $null -RCAPercentTimeInCAS $null -RCAPercentTimeInMailboxRPC $null -EWSMaxConcurrency $null -EWSPercentTimeInAD $null -EWSPercentTimeInCAS $null -EWSPercentTimeInMailboxRPC $null -EWSMaxSubscriptions $null -EWSFastSearchTimeoutInSeconds $null -EWSFindCountLimit $null -OwaMaxConcurrency $null`

10. Apply the SupermanPolicy to the superman mailbox  
    - Element: (text_input) — PowerShell console  
    - Notes: Command: `Set-Mailbox "superman" -ThrottlingPolicy SupermanPolicy`

11. Apply the SupermanPolicy to all migrated mailboxes  
    - Element: (text_input) — PowerShell console  
    - Notes: Command: `Import-CSV d:\allmailbox.csv | ForEach {Set-Mailbox -Identity $_.PrimarySmtpAddress -ThrottlingPolicy SupermanPolicy}`

12. Verify that the throttling policy is applied correctly  
    - Element: (text_input) — PowerShell console  
    - Notes: Command: `get-ThrottlingPolicy SupermanPolicy | fl RCAMaxConcurrency,RCAPercentTimeInAD,RCAPercentTimeInCAS,RCAPercentTimeInMailboxRPC,EWSMaxConcurrency,EWSPercentTimeInAD,EWSPercentTimeInCAS,EWSPercentTimeInMailboxRPC,EWSMaxSubscriptions,EWSFastSearchTimeoutInSeconds,EWSFindCountLimit,OwaMaxConcurrency`

13. Open the Windows Registry Editor as an administrator  
    - Element: **Start** (menu) — Start menu  
    - Notes: Navigate to Run → regedit

14. Modify the MaxConcurrentApi DWORD value under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Netlogon\Parameters  
    - Element: **MaxConcurrentApi** (dropdown) — Registry Editor  
    - Notes: Set decimal value to 100

15. Restart the Netlogon service  
    - Element: **Stop** (button) — Services panel  
    - Notes: Stop then restart the Netlogon service after modifying the registry

## FAQ

Q: Where can I find the Outlook plug-in for Alibaba Mail?
A: The plug-in is available on the Alibaba Mail Console under Mail > Outlook Plug-in. A direct download link is provided on that page.

Q: Can I migrate emails larger than 1 TB?
A: No. The migration service supports email data up to 1 TB in total size. Larger datasets are not supported.

Q: Do I need to keep the migration enabled after completion?
A: No. Once migration is complete and verified, you should click **Disable** in the migration settings to stop the process and prevent unintended transfers.

Q: What permissions does the superman account need for Exchange migration?
A: The superman account requires the ApplicationImpersonation role, FullAccess permissions on all user mailboxes, and assignment to a custom throttling policy with no concurrency limits.

Q: Can I modify employee accounts after importing them via template?
A: Yes. Imported employee accounts can be edited individually or in bulk through the DEPTs & Users > Employee Accounts section.

## Pricing & Billing

### Billing Model
The email migration service and Outlook plug-in are provided at no additional cost as part of the Alibaba Mail offering.

### Free Tier
Free to use for all Alibaba Mail users. The plug-in and migration tools are included with the service.

### Quota Limits
- General migration: Email data size must be within 1 TB.
- Exchange migration: Up to 100 concurrent connections via the MaxConcurrentApi registry setting.

### Billing Notes
No charges apply for using the migration or integration features. Only standard Alibaba Mail storage and subscription fees (if any) apply after migration. Typical migration takes about 2 weeks depending on bandwidth.