Before you can use Office 365™ to create and edit Documents and Media files, you must configure Liferay DXP to connect with an application in the Azure portal.
Register an Application with the Microsoft Identity Platform
First, configure your application with the Microsoft identity platform™. To do so, follow the steps described in Microsoft’s documentation.
To construct a URL for the Redirect URI parameter, follow this pattern:
https://[hostname]/o/document_library/onedrive/oauth2
Here’s the minimum permission set needed to use Office 365™ integration:
- Files.Read.All
- Files.ReadWrite.All
For more information about permissions, see Microsoft’s documentation.
Configuring Liferay DXP
Now you must connect your Liferay DXP installation with your Microsoft identity platform™ application. You can do this at two scopes:
- Globally, for all instances in your Liferay DXP installation.
- At the instance scope, for one or more instances in your Liferay DXP installation.
You can override the global configuration for one or more instances by configuring those instances separately. Similarly, you can configure only the instances you want to connect to your application and leave the global configuration empty.
Follow these steps to configure your Liferay DXP installation to connect to your application:
-
Note that the configuration options are the same in the global and instance-level configurations.
To access the global configuration, go to Control Panel → Configuration → System Settings → Documents and Media.
To access the instance-level configuration, go to Control Panel → Configuration → Instance Settings → Documents and Media.
-
Under VIRTUAL INSTANCE SCOPE, select OneDrive.
-
Enter your application’s OAuth 2 client ID and client secret in the Client ID and Client Secret fields, respectively.
-
Enter your tenant ID in the Tenant field. To find your tenant ID, see Microsoft’s documentation.
-
Click Save.
Figure 1: Enter your application's client ID, client secret, and tenant.