Office 365 Plugin 2.0

This module requires the installation of version 1.2 or more of the OAuth plugin.

OAuth Configuration in Azure AD

To be able interact with documents stored in Office 365, it is necessary to indicate to Office 365 that our web application wants to access. For that, it is necessary to configure OAuth authentication in Azure Active Driectory.

You can follow the following documentation which explains how to register your web application:

http://graph.microsoft.io/docs/authorization/associate_account

https://dev.onedrive.com/app-registration.htm

To access Azure AD, please go to the Office 365 menu on the top left and click Admin:

In the Administration Center, click "Azure AD" found in the "ADMINISTRATOR" section:

When you are in Azure AD, you must create a Directory. For this, click on "NEW" at the bottom left and fill out the form fields:

After that, you must create an application in the directory. To do this, go to the directory that you created earlier, and click "APPLICATIONS". Click "ADD" at the bottom of the page:

The CONNEXION URL must be of the type

http(s)://www.mywebsite.com[:port]/[WEBAPP]/plugins/Office365Plugin/jsp/oauth/doAuth.jsp

Once the application is created, click on it and then "CONFIGURE":

You must add permissions for other applications. To do this, click on "Add Application", select the application in the left column. It is then added to the right column and press OK. Once the application added to the list, you must check the "Application Permissions" and "Delegated permissions":

These permissions may have to change in future updates of the plugin.

REMEMBER TO COMPLETE THE "KEYS" SECTION BY SELECTING FOR EXAMPLE "2 YEARS"

Then click "SAVE" at the bottom of the page.

After Recording:

• Copy the key that appears in the "Keys" section. Do not lose this key because it will be necessary to configure the Office 365 plugin.
• Copy the Client ID required also to the Office 365 plugin configuration

Office 365 plugin configuration

Go to the plugin administration, and enter the 2 previous keys in their respective fields.

It is possible to configure a root category that will be used to store document templates.

Remember to enable the document type you selected in the workspace where you want to use the Office 365 plugin.

Connecting a member to Office 365

Go to the member profile edition, and click on the "Access Account" tab.

Click "Connect to Office 365". In the window that opens, you authorize the requested rights.

The window closes. You are now connected.

Creating an Office document

To create a new document, click the "Add" menu of the topbar, and then "Documents", then "An Office365 document".

You can either create a new blank document or a new document from a local document.

From there, a document on Office 365 is then linked to a document on your site. You see the Office 365 viewer.

therefore it is possible to:

• Edit the document directly online or through one of your Office software (Word, Excel, Powerpoint) present on your computer
• Share the document with other members who can edit or view
• Fetch the document content on Office 365 in order to update the document linked on your site
• Stop edition: it would effectively remove the document Office 365, then you will not see the Office 365 viewer on your site. When you stop editing, it is possible to recover the content before stopping to update the document on your site.

Creating an Office document from a FileDocument

For that, you have to go on the document page and in the right menu click on "Edit with Office 365"

After clicking, a confirm modal opens. After confirmation, the modal closes after processing time and then you are redirected to your new document Office 365.

The Exporer portlet

Once added to your portal, the portlet allows you to:

• Browsing in your Office 365 space
• Create, rename, delete directories
• Upload new documents
• Search in your Office 365 space