Skip to content

sequence-sh/M365Connector

Repository files navigation

Sequence Microsoft 365 Connector

The Sequence Connector for Microsoft 365 allows users to automate ediscovery and forensic workflows that use Microsoft Graph.

This connector has Steps to:

  • Read Email
  • Read Chats
  • List Users
  • List Teams
  • List Channels of a Team
  • Read messages in a channel

Authentication

Using this connector requires authenticating with Microsoft 365.
There are two ways to do this:

  • Use steps as normal. The first time you use a step which requires authentication, a message will be logged containing a url and a code. Follow the url, enter the code and login to authenticate.
  • Create a token by logging in previously and supply this token as a parameter to M365Login

Connector Settings

The Sequence Connector for Microsoft 365® requires additional configuration which can be provided using the settings key in connectors.json.

Supported Settings

Name Required Type Description
TenantId string Directory Id of the application
ClientId string Application Id
GraphUserScopes string[] Permission scopes to use. Each step has its own required scopes

If you do not have the Tenant and Client Ids you may have to create an application, follow the instructions on this page

Example connectors.json Entry

"Sequence.Connectors.Microsoft365": {
  "id": "Sequence.Connectors.Microsoft365",
  "enable": true,
  "version": "0.17.0",
  "settings": {
    "TenantId": "abc123",
    "ClientId": "def456",
    "GraphUserScopes": [
      "Mail.Read",
      "User.ReadBasic.All",
      "Team.ReadBasic.All",
      "Chat.Read",
      "Channel.ReadBasic.All",
      "ChannelMessage.Read.All"
    ]
  }
}

Documentation

https://sequence.sh

Download

https://sequence.sh/download

Try SCL and Core

https://sequence.sh/playground

Package Releases

Can be downloaded from the Releases page.

NuGet Packages

Release nuget packages are available from nuget.org.

Licensing

This product is licensed under the Apache License, Version 2.0. For further details please see http://www.apache.org/licenses/LICENSE-2.0.

Microsoft does not test, evaluate, endorse or certify this product.