Connect ExtraFax for Exchange with Dropbox

Link:  http://www.extracomm.com/Extracomm/FAQ.NSF/FAQs/5a11f0a781fd62be48257f5c002e8108
Apply to:  ExtraFax for Exchange

Last Modified Date:  02/17/2016


Connect ExtraFax for Exchange with Dropbox

Starting from ExtraFax for Exchange 3.0, you can setup ExtraFax to connect to Dropbox. This will be useful if you want to achieve the following objective:

  1. Route incoming faxes to Dropbox automatically

ExtraFax for Exchange connects to Dropbox using the OAuth 2.0 protocol.


Route incoming faxes to Dropbox

You need to do the following:

    • Create an app in Dropbox App Console using your Dropbox account
    • Create an OAuth 2.0 provider in ExtraFax
    • Create an Inbound Routing Rule that will route faxes to a Dropbox folder that is connected with the above Dropbox account.



Implementation Details

The sections below describe the configuration details.



Create an App in Dropbox App Console

1) Sign in to Dropbox Developer Page.

2) Create a new app by selecting "Create your app"

3) Choose "Dropbox API". Choose "App folder". Type a name for the app, e.g. ExtraFax. Click Create App.



4) Under OAuth2 Redirect URIs, enter URI using the format
<http protocol>://<extrafax server dns name>/auth2/dropbox_oauth2/callback
For example, https://faxserver.adatum.com/auth2/dropbox_oauth2/callback.
Click Add.


5) Click Show next to App secret. Take a note of both App key and App secret.



Create an OAuth 2.0 provider in ExtraFax

1. Sign in to ExtraFax as administrator. Under System, click OAuth 2.0 Provider on the left menu. Click New.
Fill in the details using App key as the Client Id and App secret as the Secret value (see section above).
Use the syntax <http protocol>://<extrafax server dns name>/auth2/dropbox_oauth2/callback for the field Redirect URL.
Select "Dropbox" for the Provider field.
Click Save.





Specify Dropbox in Inbound Routing Configuration

1) Sign in to ExtraFax as administrator. Under System Management, click Inbound Routing Configuration. Click New or Edit an existing configuration.

2) In Route to File System, select Cloud Storage. Select the provider created previously. Click Specify Folder Path.


3) A window from Dropbox will pop up. Sign in with your Dropbox account. You will be prompted to grant access to the application (for example, ExtraFax) you created previously. Click Allow to continue.
When succeed, you will be presented with a success screen. Close the window.

4) On the Inbound Routing Configuration page, your login name will be shown. Specify the folder in your Dropbox where the incoming faxes will be stored. Note that the fax will be stored in Apps/<Application name>/<folder>. For example, Apps/ExtraFax/infax.


5) Click Save to save the configuration.

6) You may send a test fax to ExtraFax server to verify that incoming faxes are saved in the specified Dropbox folder.


Important Note: By default, ExtraFax use the same filename "AllPages.pdf" when saving file. To avoid overwriting old files, please enable the setting "Insert Timestamp and Fax Record Number Prefix to Incoming Fax Filename" under Organization -> Inbound Settings.