Configure a Microsoft OneDrive Content Connector
After you configure and enable a Microsoft OneDrive content connector, you can connect to OneDrive and pull required content from it into Oracle Content Management.
A Microsoft OneDrive content connector enables you to import assets from the OneDrive repository into Oracle Content Management. As an Administrator or Developer, you can configure a Microsoft OneDrive content connector from the Integrations menu in an Oracle Content Management instance.
To configure a OneDrive content connector:
- Get the Oracle Content Management host name and authorization URL details.
- Sign in to Oracle Content Management as an Administrator or Developer.
- Click Integrations in the Administration area of the navigation menu on the left.
- In the Integrations menu, choose Content Connectors.
- Click the check box next to the OneDrive content connector.
- Click Create.
- On the General tab, note the Redirect URL, which will be in
this
format:
https://<hostname>.<domainname>.com:<port>/documents/web/AR_COMPLETE_AUTHORIZATION
The Redirect URL field is truncated. Double-click the field to copy the value to your clipboard. You'll need to provide this value later in the OneDrive URL field on the Additional Fields tab.
- Create a OneDrive app.
- Sign in to Microsoft Azure at https://portal.azure.com/:
- Pick an account that has your Microsoft user name.
- Enter your Microsoft password.
- Choose Office365.
- Click Sign in.
- Click Yes to stay signed in and reduce multiple sign-ins.
- On the Azure services page, click App registrations.
- On the App registrations page, click New registration.
- On the Register an application page, enter a name and choose the account types that can use the application. At the bottom, paste a redirect URL and then click Register.
- On your application's page, click Certificates & secrets in the left menu, and then click the New client secret button on the page.
- Under Add a client secret, enter a description for your client secret, select Never under Expires, and then click Add.
- Click the Copy to clipboard icon on the bottom right to record the secret. You'll need to enter it later in the Client Secret field on the Additional Fields page for the content connector. Also click Copy to clipboard to record other details.
- On the API permissions page, click
Add a permission to add a OneDrive permission,
such as User.Read, a Delegated
permission for OneDrive to sign in as the user and access an API. Another
permission you might want to add is off-line access,
which enables the refresh token.
In addition to User permissions, you can grant AllSites, Myfiles, Sites, and TermStore permissions.
- Click Add an app.
- Enter an application name, and click Create. The sampleApp Registration screen is displayed.
- Under Properties, type the name of your application.
- Note the Application id value.
- Sign in to Microsoft Azure at https://portal.azure.com/:
- Add the OneDrive connector to a repository..
- In Oracle Content Management, select Integrations on the left navigation menu.
- On the Integrations page, choose Content Connectors from the drop-down menu.
- In the list of content connectors, click the name of the OneDrive content connector.
- Configure the Microsoft OneDrive content connector in Oracle Content Management.
- On the General tab:
- The Name, Description, Connector service URL, and Redirect URL fields are prepopulated.
- In the Connector tags field, you can assign tags that will be applied to assets pulled from the content connector (for example, the content connector name). This lets you search for all items from that content connector in an asset repository.
- Make sure Enabled for end users
is selected.
You can review the Terms of use and Privacy Policy below the Enable for end users button.
- Click the Additional Fields tab, and
enter the following information:
- Client ID (the value of Application id that you noted down earlier)
- Client Secret (the value of the generated password)
- OneDrive URL
- Tenant ID
- Access Scope
- When you're done, click Save.
- On the General tab:
- Add the connector to a repository.
- Click Content in the Administration area of the navigation menu on the left.
- Open an existing repository or click Create to create a new one.
- If you're creating a new repository, specify the repository name, publishing channels, languages, and other options.
- Under Content Connectors, select one or
more connectors to associate with the repository.
This menu lists all the content connectors that have been configured and enabled in your Oracle Content Management instance.
If any of the connectors you select have content types associated with them, the types appear under Content Types.
After a Microsoft OneDrive content connector is configured, enabled, and associated with a repository, it's available in the asset repository for Oracle Content Management users to download content, through the Add drop-down menu Import from Microsoft OneDrive option on the Assets page.
Note:
An authorized application for a OneDrive content connector must provide a link to
https://account.live.com/consent/Manage
, or to another location specified
for a OneDrive content connector, with a clear indication that end users can go to that
Microsoft site to revoke permissions at any time. If end users must take additional
steps to disable the authorized application's access to end-user information, then the
application must clearly indicate to end users the additional steps required to disable
access. These requirements do not apply where Microsoft provides the end-user web
interface.