Microsoft 365 Connector

Introduction

The Microsoft 365 Connector module gives you a connector service that makes it possible for developers to easily connect to the Microsoft Graph API.

This module consists of various submodules which provide several blocks to interact with Microsoft 365 from your drupal site. You can read about the module and the submodules on the documentation pages dedicated to them:

Documentation on Drupal.org API documentation

Features

Features of this module include:

• Microsoft Teams integration: using a combination of this module and the Group module you can connect groups with Teams. For now this adds a feature that lists files from a Team in the Group in Drupal. We also have added a feature for people to send messages from Drupal to others on Teams without leaving Drupal.
  There is also an option to start a chat or a call with team members.
  In the future there will be better integration with Teams (for instance your activity stream), and better and more integration between Microsoft 365 and Groups.
• Outlook Calendar integration: using this module you are able to create events from Drupal (as a node) and automatically add this event to your own Outlook Calendar and even have the option to invite other attendees as well.
• Lots more, just check it out, or read the documentation pages

Requirements

This module requires the following modules (downloaded via composer.json):

• OAuth2 Client
• External Authentication
• Microsoft Graph Library for PHP

Installation

See this documentation page.

Configuration

Configuration is (or will be) described on the documentation pages of this module. Have a look at this documentation page.

Updating from 5.x.x to 6.0.x

This release adds a new feature that makes it possible to use multiple connectors. This has been added in #3295745: Make it possible to use multiple Office 365 connectors (6.x). Some changes will be updated in a update hook, but others will need some manual work.

To use this you need to change the structure of the config in the settings file. The old structure was:

$settings['o365']['api_settings']['client_id'] = '<client_id>';
$settings['o365']['api_settings']['client_secret'] = '<client_secret>';
$settings['o365']['api_settings']['tenant_id'] = '<tenant_id>';

The new structure will be this:

$settings['o365'] = [
  '<connector-1-id>' => [
    'client_id' =>'<client_id>',
    'client_secret' => '<client_secret>',
    'tenant_id' => '<tenant_id>',
  ],
  '<connector-2-id>' => [
    'client_id' =>'<client_id>',
    'client_secret' => '<client_secret>',
    'tenant_id' => '<tenant_id>',
  ],
];

The connector id can be found on https://www.example.com/admin/config/system/o365/settings/o365-connectors when you edit the available connectors. You need to use the machine name. For existing instances this will most likely be "default" because this is created during the update hook.

Also keep in mind the change in the return URL. This needs to be configured in the Azure app and will have the connector id added to the url.

Support

For any questions, please add an issue to the issue queue.