Page tree
Skip to end of metadata
Go to start of metadata
Microsoft Asset App is an app which provide functionality to use assets from office.com (Sharepoint, OneDrive) in magnolia.

Installation

Maven is the easiest way to install the module. Add the following dependency to your bundle:

  <dependency>
      <groupId>info.magnolia.external.dam</groupId>
      <artifactId>magnolia-external-dam-microsoft</artifactId>
      <version>${project.version}</version>
  </dependency>

Versions

6.2Magnolia 6.2


Configuration

Authentication

This module uses two authentication flows to access Microsoft assets:

Client Credentials

Client Credentials flow is the default/main/mandatory. For Microsoft Asset App to be able to access Microsoft assets we need to configure the module properly. Please provide following parameters:

  • tenantId
  • clientId
  • clientSecret

These properties can be provided directly in module configuration yaml file, or we can provide the path to the keystore property.
In the following example these properties are stored in the keystore workspace (passwords app) and we provide the path to the location of these properties:

/dam-microsoft/config.yaml

  tenantId: '/microsoft-credentials/default/tenantId'
  clientId: '/microsoft-credentials/default/clientId'
  clientSecret: '/microsoft-credentials/default/clientSecret'
  impersonate: false

Values stored in the passwords app:

Username/Password

Username/Password authentication flow is optional. This authentication flow can be enabled/disabled. By default, this authentication flow is disabled. To enable this flow set impersonate configuration property to true.

Example: /dam-microsoft/config.yaml

  tenantId: '/microsoft-credentials/default/tenantId'
  clientId: '/microsoft-credentials/default/clientId'
  clientSecret: '/microsoft-credentials/default/clientSecret'
  impersonate: true

Once enabled module will try to impersonate current magnolia user with Microsoft credentials provided in passwods app (keystore workspace).
Module will search for username, password, clientId properties in the keystore workspace under path:

  '/microsoft-credentials/[curent username]/clientId'
  '/microsoft-credentials/[curent username]/username'
  '/microsoft-credentials/[curent username]/password'

If these properties exists, for example:

this module will login to microsoft graph with delegated user privileges.

Important liks

Warnings

  • This module is at INCUBATOR level.

Changelog

  • Version 1.0 - Initial release of the extensions version of the module.
    • Put links to relevant tickets to help others