MailSuite Pro documentation

Configuring integration with social networks

Introduction

In current version, it's possible to configure integration of webmail application with various social networks and file sharing services. For all of those, the similar approach is used - in a special console offered by that network or service, you create an application and obtain a special set of parameters used for authentication from within webmail application.

Dropbox

Integration with Dropbox allows webmail users to attach files directly from their Dropbox account.

IMPORTANT: For this to work, webmail application must be running on SSL-enabled (https) host.

# Open App Console at Dropbox website. You'll be asked to log into your Dropbox account if you're not logged in yet.

# Click Create App button, then fill the parameters of your application as follows:
Social-config-dropbox.png

# Supply arbitrary application name and click Create App.

# On next screen, the product installation domain(s) must be added under Drop-ins domains list. To Redirect URIs list, URLs of the following kind must be added: http://yourdomain.com/webmail/?dropbox where http://yourdomain.com/webmail/ is product installation URL.

# Copy App key and App secret values from that screen, and paste those in respective fields under Common > Social Networks screen of AdminPanel, make sure "Dropbox" option is enabled there.

By default, Dropbox application can only be accessed by up to 100 users. To remove those limits, you'll need to apply for production status as described here.

Google

The following configuration needs to be performed if you'd like to be able to allow users for attaching files from their Google Drive storage.

# Navigate to https://console.developers.google.com/project and click Create Project. Supply arbitrary Project Name and unique Project ID, click Create. Once the project is created, it will be selected automatically.

# In left pane, select APIs & auth -> Consent screen. On this page, you can supply various information about your application. Note that Product name and Email address fields are mandatory.

# In APIs & auth > APIs screen, locate Google Picker API and Drive API entries, and make sure both are enabled.

# Switch to APIs & auth -> Credentials page. Under OAuth section, click Create new client ID button.
Application type needs to be set to "Web application".

In Authorized JavaScript Origins, webmail URL should be supplied.

In Authorized Redirect URIs list, URLs of the following kind must be added: http://yourdomain.com/webmail/?google where http://yourdomain.com/webmail/ is product installation URL.

# In Public API access section of that page, press Create New Key button and select Browser Key option. You'll be asked to provide a list of URL patterns the key can be used for. You can leave it empty, the key will work for any address then.

# From that page, obtain "App ID" (CLIENT ID), "App Secret" (CLIENT SECRET) and API KEY, they should be supplied under Common > Social Networks screen of AdminPanel.

In case of AfterLogic Aurora, integration with Google also allows for logging into HelpDesk interface using Google account. This is only about users of the support system (your clients which post inquiries in Helpdesk), those who have Aurora account log into it the standard way. The same can be done using Twitter and Facebook as described below.

Twitter

Allows for accessing Helpdesk of AfterLogic Aurora using your Twitter account. This is only about users of the support system (your clients which post inquiries in Helpdesk), those who have Aurora account log into it the standard way.

# Navigate to https://dev.twitter.com/apps and click Create a new application.

# Fill all the mandatory fields, make sure Callback URL is set to webmail URL.

# From Details tab obtain "App ID"(Consumer key) and "App Secret"(Consumer secret), which should be supplied under Common > Social Networks screen of AdminPanel.

Facebook

Allows for accessing Helpdesk of AfterLogic Aurora using your Facebook account. This is only about users of the support system (your clients which post inquiries in Helpdesk), those who have Aurora account log into it the standard way.

# Navigate to https://developers.facebook.com/apps and click Create a new app.

# On the left pane, select Settings > Basic tab, and supply webmail URL in App Domains and Site URL fields.

# From the same page, obtain App ID and App Secret values to be supplied under Common > Social Networks screen of AdminPanel.

# Enable Client OAuth Login on Advanced tab.