Outlook Out of Office Connector

[olivier_detilleux]

	Description	SaaS Connector to get Outlook out of Office Status
	Legal Agreement	By using this CoLab item, you are agreeing to SailPoint’s Terms of Service for our developer community and open-source CoLab.
	Repository Link	https://github.com/sailpoint-oss/colab-saas-conn-outlook-out-of-office
	New to SaaS connectors in the CoLab?	Read the getting started guide for SaaS Connectors in the CoLab.
	Supported by	Community Developed

Overview

This connector leverages the Microsoft Graph API to get the out of office status directly from Office 365 Outlook. You can then use this information to automate some actions on Identity Security Cloud like enabling automatic forward, disabling some accounts or delegation permissions.

Requirements

This connector requires some permissions in Graph API to work properly. Review the Guide below to set up the permissions.

Guide

Register an application in Entra ID

First, you need to create an Entra ID App Registration and grant below API permissions in Microsoft Graph API

API / Permissions name	Type
Directory.Read.All	Application
MailboxSettings.Read	Application
User.Read	Delegated

Then, you need a client secret for this app and find your tenant Id

Install the connector

Getting Started with SaaS Connectors in the CoLab

Use this category to view and download Identity Security Cloud (ISC) SaaS Connectivity connectors built by the community. Download the Connector To download a connector from the CoLab, follow these steps: Download the connector you want from the SaaS Connectors category. Use the SailPoint CLI to create a new connector: sail conn create "my-connector-name", where my-connector-name is the name that will show up for your connector in the SailPoint CLI. Use the SailPoint CLI to upload the connect…

Configure a new Source

Create a new source using the new connector type. Configure the source with your clientId, clientSecret and tenantId. In order to get only the mail enabled users, you can add a filter. For instance, to get only Business Essentials licensed users, I use this filter : assignedLicenses/any(u:u/skuId eq 3b555118-da6a-4418-894f-7df1e2096870)

Get Outlook of Office Status

The connector brings licensed users as accounts with the below schema :

Attributes	Description
scheduledEndDateTime	The date and time that automatic replies are set to end, if Status is set to Scheduled .
scheduledStartDateTime	The date and time that automatic replies are set to begin, if Status is set to Scheduled .
automaticRepliesSetting	The current Out of Office Status. Can be enabled (if Status is set to Scheduled and current date time is between scheduledStartDateTime and scheduledEndDateTime or if Status is alwaysEnabled. You can rely on that attribute to trigger some actions.
automaticRepliesStatus	Configurations status for automatic replies. The possible values are: disabled , alwaysEnabled , scheduled .]

Supported Operations

Test Connection
Account List
Account Read

[JessAscanio1 (Jessica Ascanio)]

Hi @olivier_detilleux!
REALLY excited to work with this connector.
I got everything installed, but when I do a test connection I’m running into the following error:

Office 365 Out of Office SaaS Connector - IdentityNow (IDN) / IDN Show and Tell - SailPoint Developer Community Forum

Any insight as to what to troubleshoot first?
PS: This topic did not allow me to use the “colab” tag.

[olivier_detilleux]

Hi Jessica, really sorry, I only see your message right now. I did a little search and found another message related to this error : ConnectorError with new connector that uses SaaS Connectivity framework
Let me try to add that in my code.

[questjj (Jason Quest)]

github link broke

[colin_mckibben]

Sorry about that. It’s public now.

[TheOneAMSheriff (Amar Sheriff)]

Hi @olivier_detilleux,

Thank you for this wonderful SaaS connector. I am interested in knowing what the applications of this connectors could be. Could you perhaps also share what motivated you to build this?

[olivier_detilleux]

Hi @TheOneAMSheriff, the idea behind this connector was simply to get the Out Of Office status from Outlook to ISC. With that, we can for instance automate the “Work Reassignment” in ISC using a workflow. That way, if someone is on PTO and set the Out of Office in Outlook, then it does not have to set the workf reassignment in ISC. I’ve shared a workflow to do that : Workflow to manage Work Reassignments based on Identity Attribute Change

[TheOneAMSheriff (Amar Sheriff)]

Hi @olivier_detilleux,

Thanks for the response. Sounds like a very sweet deal for the owners/approvers.