Common preparations

This page shows how to setup external file stores. For all of these file stores you have to install the package "open-xchange-oauth", which provides the necessary authentication mechanisms.

Moreover your setup is required to be reachable via HTTPS, since the providers expect that a call-back URL to your setup is specified. Such a call-back URL is only accepted if it contains the "https://" scheme., e.g.:

"https://my.oxsetup.invalid/ajax/defer"

Keep HTTPS protocol

Appsuite:Grizzly#Cluster_setup shows that HTTPS communication is terminated by the Apache balancer in front of the Open-Xchange nodes. To let the Open-Xchange application know about the HTTPS protocol that is used to communicate with the Apache server:

Either set a special header in the SSL virtual hosts configurations in Apache to forward this information. The de facto standard for this is the "X-Forwarded-Proto" header. See Appsuite:Grizzly#X-FORWARDED-PROTO_Header for how to setup that header.

Or force the Open-Xchange application to assume it is reached via SSL through setting property "com.openexchange.forceHTTPS=true" in file /opt/open-xchange/etc/server.properties.

Deferrer URL

Open-Xchange application uses the deferrer URL as call-back for some of the providers, which use OAuth v2.0 authentication (such as Google).

If your OX server is reachable only via one host name, you won't have to do anything. If it is reachable by more than one host name, create or open the file /opt/openexchange/etc/deferrer.properties and set the properties therein as such:

com.openexchange.http.deferrer.url=https://mymaindomain.invalid

Dropbox

To setup the Dropbox file store you have to install the package "open-xchange-file-storage-dropbox".

Google Drive

Registering your app

Please follow these instructions to create a new project with a client ID, which is needed to call the sign-in API

Enable the following APIs for your project

BigQuery API

Calendar API

Contacts API

Drive API

Drive SDK

Gmail API

Google Cloud SQL

Google Cloud Storage

Google Cloud Storage JSON API

Configuration

In addition you have to configure the following properties in file /opt/open-xchange/etc/googleoauth.properties:

Enable the OAuth connector to Google OAuth

com.openexchange.oauth.google=true

Set the API key and secret, which is Client ID and Client Secret to call the sign-in API (Select your project, select API manager from upper left burger menu, select credentials in left side bar, select Client ID for Web application)