Webmail Integration: Webmail API

PROBLEM

How do I connect the atmail suite webmail with the atmail mail server webadmin?

ENVIRONMENT

• atmail suite - API server
• atmail mail server
• Admin UI
  • Services > WEBMAIL INTEGRATION > Webmail API

CAUSE

Requirement to connect atmail suite and atmail mail server together for account creation and modification. 

RESOLUTION

1. Ensure webmail integration plugin has been installed during atmail mail server installation. 
   
   10. OPTIONAL: Use yum to install the atmail-mailserver-plugin-WebmailIntegration rpm (required if also running atmail suite).
   

   [root@localhost atmail-mailserver-[version]]# yum install atmail-mailserver-plugin-WebmailIntegration[version].el7.centos.x86_64.rpm -y -q

2. Login to your webadmin. 
   
3. Go to Services > WEBMAIL INTEGRATION > Webmail API.
   
4. Enter details. 
   API server URL
   Specify atmail webmail API server url. e.g. http://localhost:3000/ (direct to API) or https://<host>/api/ (via webserver)
   Username
   Your admin username for authenticating with the atmail webmail API server. This user must have the “admin” role.
   Password
   Your admin password for authenticating with the atmail webmail API server.
5. Save settings and publish config. 
   
6. atmail suite apiserver is now connected to atmail mail server.