Description

This repository contains a Nuxeo Live Connect plugin for the Microsoft Graph API using Microsoft's Java SDK. This restores the ability to use Nuxeo Live Connect with OneDrive.

How to build

git clone https://github.com/nuxeo-sandbox/nuxeo-liveconnect-onedrive-graph
cd nuxeo-liveconnect-onedrive-graph
mvn clean install

Azure Configuration

• Log into the Azure portal with your Microsoft account
• Use the search bar to locate the "App registrations" service
• Click New registration
  • Set a value for Name; this is the display name shown in the OAuth dialog so choose something meaningful
  • For Supported account types choose Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)
  • Set the Redirect URI to https://<your_SERVER>/nuxeo/site/oauth2/msgraph/callback
  • Click on Register
  • Make note of the Application (client) ID; this will be used in Nuxeo later
• Open the Authentication menu
  • Add a second redirect URI https://<your_SERVER>/nuxeo/ui/nuxeo-liveconnect/nuxeo-liveconnect-onedrive-picker.html
  • Check Access tokens and ID tokens under Implicit grant
• Open the Certificates & secrets menu
  • Create a New client secret
  • Copy the Value; this will be used in Nuxeo later
  • Note: do not copy the ID, this is just the UUID of the secret record
• Open the API permissions menu
  • Click on Add permission
    • Choose Microsoft Graph
    • Choose Delegated permissions
    • Enable OpenId permissions > offline_access
    • Enable Files > Files.ReadWrite.All

Nuxeo Configuration

• Log into Nuxeo as an administrator
• Go to Administration > Cloud Services in the left drawer menu
• Edit the msgraph service, set the Client ID and Client Secret to the values copied in the preceding
• Unless your app is multi-tenant, and you are a verified published, replace /common/ by the tenant ID in the authorization server url and token server url
• Check Enabled
• Click Save

Unless your app is multi-tenant, and you are a verified published, In nuxeo.conf, set the microsoft tenant name

nuxeo.liveconnect.msgraph.tenantName=

The tenant name is found in the sharepoint url https://<tenantName>-my.sharepoint.com/

MS Graph API documentation

here

Support

These features are not part of the Nuxeo Production platform.

These solutions are provided for inspiration and we encourage customers to use them as code samples and learning resources.

This is a moving project (no API maintenance, no deprecation process, etc.) If any of these solutions are found to be useful for the Nuxeo Platform in general, they will be integrated directly into platform, not maintained here.

License

Apache License, Version 2.0

About Nuxeo

Nuxeo Platform is an open source Content Services platform, written in Java. Data can be stored in both SQL & NoSQL databases.

The development of the Nuxeo Platform is mostly done by Nuxeo employees with an open development model.

The source code, documentation, roadmap, issue tracker, testing, benchmarks are all public.

Typically, Nuxeo users build different types of information management solutions for document management, case management, and digital asset management, use cases. It uses schema-flexible metadata & content models that allows content to be repurposed to fulfill future use cases.

More information is available at www.nuxeo.com.