Authentication via external services

Introduction

WebMail Pro 8 offers integration with various external services: Google, Facebook and Dropbox. For each of those services, integration is configured in the similar way - in a console offered by that service, you create an application and obtain a set of parameters used for authentication, and specify those parameters in WebMail Pro 8 admin interface section. Once that's done, users will be able to authenticate via those services and use access file storage where applicable.

Google

This configuration will allow your users to authenticate with their Google accounts and access their Google Drive storage.

Setting up application in Google

On the screen currently open, locate Drive API link and click it. Click Enable button. Then in left panel select Overview, locate Google Picker API on that screen and click the link to enable this API.

In left pane, select Credentials and click Create credentials button. Choose API key option and then Browser key button. Change Name if needed and click Create button. API key created will be shown. You should save it to use in WebMail Pro 8 settings.

Make sure you have the following option enabled on Status & Review tab:

Do you want to make this app and all its live features available to the general public?

Performing configuration in WebMail Pro 8

Under System > Facebook Auth screen of admin interface, enable Facebook connector by selecting its checkbox.

App ID and App Secret values should be set to those obtained from Facebook Developer console.

Dropbox

Integration with Dropbox allows WebMail Pro 8 users to authenticate with their Dropbox accounts and access their Dropbox storage.

IMPORTANT: For this to work, WebMail Pro 8 must be running on SSL-enabled (https) host.

Setting up Dropbox app

Open Dropbox App Console. 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:

Supply arbitrary application name and click Create App.

On next screen, the product installation domain(s) must be added under Chooser/Saver domains list. To Redirect URIs list, URLs of the following kind must be added: http://yourdomain.com/aurora/?oauth=dropbox where http://yourdomain.com/aurora/ is product installation URL.

Copy App key and App secret values from that screen.

Setting up Dropbox integration in WebMail Pro 8

Under System > Dropbox Auth screen of admin interface, enable Dropbox connector by selecting its checkbox;

App ID is set to App key value obtained from Dropbox App Console;

App Secret should be set to App secret value;

Removing restrictions of Dropbox integration

By default, a single Dropbox app can only be accessed by up to 100 users. To remove the limit, you'll need to apply for production status as described here.