AppSuite:Filestorages - Revision history

Malasa: /* Microsoft Onedrive */ changed azure page link, configuration changed

2020-08-18T04:57:16Z

Microsoft Onedrive: changed azure page link, configuration changed

← Older revision		Revision as of 04:57, 18 August 2020
Line 129:		Line 129:

	= Microsoft Onedrive =		= Microsoft Onedrive =
	To setup the Microsoft OneDrive file store you have to install the package "open-xchange-file-storage-onedrive".		To setup the Microsoft OneDrive file store you have to install the package "open-xchange-file-storage-onedrive".

	== Registering your app ==		== Registering your app ==
	* ~~Please follow~~ [https://~~msdn~~.~~microsoft~~.com/~~en-us~~/~~library~~/~~ff751474.aspx this guide~~] ~~to create/register your app~~		* register your app on the [https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade Azure App registration] page
	* application ID maps to apiKey in OX properties		* application ID maps to apiKey in OX properties
	* create credentials and copy it to apiSecret		* create credentials and copy it to apiSecret
	* choose "Web" as platform		* choose "Web" as platform
	* enter the redirect URL ~~according to the instruction in msliveconnectoauth.properties~~		* enter the redirect URI/URL, see below
	* enter profile data for your application		* enter profile data for your application

	== Configuration ==		== Configuration ==
	In addition you have to configure the following properties in file ''/opt/open-xchange/etc/msliveconntectoauth.properties'':		In addition you have to configure the following properties in file ''/opt/open-xchange/etc/microsoftgraphoauth.properties'' (before 7.10.x ''/opt/open-xchange/etc/msliveconntectoauth.properties''):

	* Enable the OAuth connector		* Enable the OAuth connector
	<syntaxhighlight lang="properties">		<syntaxhighlight lang="properties">
	com.openexchange.oauth.~~msliveconnect~~=true		com.openexchange.oauth.microsoft.graph=true
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>
Line 150:		Line 150:
	* Set the API key and secret		* Set the API key and secret
	<syntaxhighlight lang="properties">		<syntaxhighlight lang="properties">
	com.openexchange.oauth.~~msliveconnect~~.apiKey=REPLACE_THIS_WITH_YOUR_MS_LIVE_CONNECT_CLIENT_KEY		com.openexchange.oauth.microsoft.graph.apiKey=REPLACE_THIS_WITH_YOUR_MS_LIVE_CONNECT_CLIENT_KEY
	com.openexchange.oauth.~~msliveconnect~~.apiSecret=REPLACE_THIS_WITH_YOUR_MS_LIVE_CONNECT_CLIENT_SECRET		com.openexchange.oauth.microsoft.graph.apiSecret=REPLACE_THIS_WITH_YOUR_MS_LIVE_CONNECT_CLIENT_SECRET
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>
Line 157:		Line 157:
	* Set the redirect URL		* Set the redirect URL
	<syntaxhighlight lang="properties">		<syntaxhighlight lang="properties">
	com.openexchange.oauth.~~msliveconnect~~.redirectUrl=REPLACE_THIS_WITH_YOUR_MS_LIVE_CONNECT_REDIRECT_URL		com.openexchange.oauth.microsoft.graph.redirectUrl=REPLACE_THIS_WITH_YOUR_MS_LIVE_CONNECT_REDIRECT_URL
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>

			Note: the redirect URL must be the same as defined in the azure app registration, it should be https://<REPLACE_WITH_FQDN>/ajax/defer

	You can define them system-wide or via the config cascade mechanism.		You can define them system-wide or via the config cascade mechanism.

Malasa: link to doc.o.c

2020-01-30T11:35:56Z

link to doc.o.c

← Older revision		Revision as of 11:35, 30 January 2020
Line 1:		Line 1:
			'''Note:''' you can find updated guides at [https://documentation.open-xchange.com/7.10.2/middleware/3rd_party_integrations.html https://documentation.open-xchange.com/7.10.2/middleware/3rd_party_integrations.html]

			This page is only for pre 7.10.2 versions.

	= Common preparations =		= 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.		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.

WolfgangRosenauer: /* Registering your app */

2018-04-05T09:17:16Z

Registering your app

← Older revision		Revision as of 09:17, 5 April 2018
Line 129:		Line 129:
	== Registering your app ==		== Registering your app ==
	* Please follow [https://msdn.microsoft.com/en-us/library/ff751474.aspx this guide] to create/register your app		* Please follow [https://msdn.microsoft.com/en-us/library/ff751474.aspx this guide] to create/register your app
			* application ID maps to apiKey in OX properties
			* create credentials and copy it to apiSecret
			* choose "Web" as platform
			* enter the redirect URL according to the instruction in msliveconnectoauth.properties
			* enter profile data for your application

	== Configuration ==		== Configuration ==

Frank.de-bruijcker: /* Configuration */

2018-03-23T10:08:15Z

Configuration

← Older revision		Revision as of 10:08, 23 March 2018
Line 50:		Line 50:
	<br>		<br>

	* Set the redirect URL. Please ensure the ~~following conditions are met:~~		* Set the redirect URL. Please ensure the use the same URL as specified in the Dropbox App:
	** The redirect URL specified in the Dropbox App ~~needs to be the same as the one specified by this property.~~
	** The redirect URI uses <source enclose="none" lang="java">"https://"</source> as protocol
	** The redirect URI follows the pattern: <source enclose="none" lang="java">"https:~~//" + <host-name> + "/ajax/defer"</source>~~
	<syntaxhighlight lang="properties">		<syntaxhighlight lang="properties">
	com.openexchange.oauth.dropbox.redirectUrl=		com.openexchange.oauth.dropbox.redirectUrl=
	</syntaxhighlight>		</syntaxhighlight>
	~~E.g. <source enclose="none" lang="java">"https://myappsuite.mydomain.invalid/ajax/defer"</source>~~
	<br>		<br>

Frank.de-bruijcker: /* Registering your app */

2018-03-23T10:08:05Z

Registering your app

← Older revision		Revision as of 10:08, 23 March 2018
Line 27:		Line 27:
	* Log in to your Dropbox account [https://www.dropbox.com/login here], and create your Dropbox app [https://www.dropbox.com/developers/apps/create here]		* Log in to your Dropbox account [https://www.dropbox.com/login here], and create your Dropbox app [https://www.dropbox.com/developers/apps/create here]
	* There are two options available creating an app, Drops-in App & Dropbox API App. Please select '''Dropbox API''' app and enter the name of your app.		* There are two options available creating an app, Drops-in App & Dropbox API App. Please select '''Dropbox API''' app and enter the name of your app.
	* Go to [https://www.dropbox.com/developers/apps App Console] and select your created app. Select settings tab to view the <source enclose="none" lang="java">APP_KEY</source> (App key) and <source enclose="none" lang="java">SECRET_KEY</source> (App secret)		* Go to [https://www.dropbox.com/developers/apps App Console] and select your created app. Select settings tab to view the <source enclose="none" lang="java">APP_KEY</source> (App key) and <source enclose="none" lang="java">SECRET_KEY</source> (App secret) and to configure the redirect URI to your AppSuite platform under the Oauth2 section. All the other fields can keep their default value.
			* Please ensure the following conditions are met for the redirect URI:
			** The redirect URI uses <source enclose="none" lang="java">"https://"</source> as protocol
			** The redirect URI follows the pattern: <source enclose="none" lang="java">"https://" + <host-name> + "/ajax/defer"</source>
			** E.g. <source enclose="none" lang="java">"https://myappsuite.mydomain.invalid/ajax/defer"</source>
			<br>

	== Configuration ==		== Configuration ==

WolfgangRosenauer: /* Registering your app */

2018-03-22T21:52:01Z

Registering your app

← Older revision		Revision as of 21:52, 22 March 2018
Line 82:		Line 82:
	** Google Cloud Storage		** Google Cloud Storage
	** Google Cloud Storage JSON API		** Google Cloud Storage JSON API
			* perform [https://support.google.com/webmasters/answer/35179 Google's site verification]
			** you can use any method listed by Google in general
			** in case our OXaaS offering is used the HTML tag and HTML file methods are not accessible but the DNS based approach is required
	* [[AppSuite:GoogleAppVerification\|get your app verified by Google]] to avoid awkward warnings		* [[AppSuite:GoogleAppVerification\|get your app verified by Google]] to avoid awkward warnings

WolfgangRosenauer at 21:46, 22 March 2018

2018-03-22T21:46:00Z

← Older revision		Revision as of 21:46, 22 March 2018
Line 82:		Line 82:
	** Google Cloud Storage		** Google Cloud Storage
	** Google Cloud Storage JSON API		** Google Cloud Storage JSON API
			* [[AppSuite:GoogleAppVerification\|get your app verified by Google]] to avoid awkward warnings

	== Configuration ==		== Configuration ==

Malasa: path not etc/groupware anymore

2017-05-30T04:32:18Z

path not etc/groupware anymore

← Older revision		Revision as of 04:32, 30 May 2017
Line 15:		Line 15:
	Open-Xchange application uses the deferrer URL as call-back for some of the providers, which use OAuth v2.0 authentication (such as Google).		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~~/groupware~~/deferrer.properties'' and set the properties therein as such:		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:
	<syntaxhighlight lang="properties">		<syntaxhighlight lang="properties">
	com.openexchange.http.deferrer.url=https://mymaindomain.invalid		com.openexchange.http.deferrer.url=https://mymaindomain.invalid

Ioannis.chouklis: /* Configuration */

2017-03-20T12:56:09Z

Configuration

@@ Line 42: / Line 42: @@
   com.openexchange.oauth.dropbox.apiKey=REPLACE_THIS_WITH_DROPBOX_APP_KEY
   com.openexchange.oauth.dropbox.apiSecret=REPLACE_THIS_WITH_DROPBOX_APP_SECRET
 </syntaxhighlight>
 <br>

Daniel.becker: /* Registering your app */

2016-10-17T10:38:34Z

Registering your app

← Older revision		Revision as of 10:38, 17 October 2016
Line 27:		Line 27:
	* Log in to your Dropbox account [https://www.dropbox.com/login here], and create your Dropbox app [https://www.dropbox.com/developers/apps/create here]		* Log in to your Dropbox account [https://www.dropbox.com/login here], and create your Dropbox app [https://www.dropbox.com/developers/apps/create here]
	* There are two options available creating an app, Drops-in App & Dropbox API App. Please select '''Dropbox API''' app and enter the name of your app.		* There are two options available creating an app, Drops-in App & Dropbox API App. Please select '''Dropbox API''' app and enter the name of your app.
	* Go to [~~http~~:~~//%20https~~//www.dropbox.com/developers/apps App Console] and select your created app. Select settings tab to view the <source enclose="none" lang="java">APP_KEY</source> (App key) and <source enclose="none" lang="java">SECRET_KEY</source> (App secret)		* Go to [https://www.dropbox.com/developers/apps App Console] and select your created app. Select settings tab to view the <source enclose="none" lang="java">APP_KEY</source> (App key) and <source enclose="none" lang="java">SECRET_KEY</source> (App secret)

	== Configuration ==		== Configuration ==