Authorizing Outlook / Office 365 integration

📮 This article is meant to be shared with your organization administrators as well

Connecting your Outlook calendar with Lunatask will allow you to see your calendar events directly next to your task list in Lunatask. However, depending on your organization's policies, the integration might require approval from your organization's administrators.

Why is that?

Your organization will most likely have policies that prohibit anyone from authorizing any unknown third-party application to access organization data. This is reasonable and common practice.

Additionally, Lunatask is built by an indie developer registered with Microsoft Partner Center as an individual developer. Therefore, the integration cannot get "verified" status from Microsoft as they offer publisher verification only to companies. Hence, the Microsoft login page might show that the integration is unverified and display a warning.

Is the integration safe to use?

Yes, it is. Lunatask cares about your privacy – all communication goes from your computer directly to Microsoft servers. Your calendar data is never transmitted through Lunatask infrastructure, and the app has read-only access to your calendar events and nothing else.

How can the integration be approved?

There are two ways, depending on how your organization account with Microsoft is set up.

First, your organization might have admin consent requests enabled. In that case, the flow is easy, and you can request that your organization's administrations approve (or deny) you connecting your calendar with Lunatask directly in the authorization window itself.

If not, your organization administrators can allow connecting calendars with Lunatask organization-wise by granting a tenant-wide consent (see "Manually grant tenant-wide admin consent" section below).

When admin request consent flow enabled

As a Lunatask user, when signing in with your Microsoft account, you’ll be presented with a screen that will allow requesting admin consent while providing a reason why you want this consent to be given, i.e. “so I can see my calendar inside this productivity app I using”.

This is what that looks like from your point of view:

When submitted, your organization administrators will be notified and can approve (or deny) the request in their Azure Portal. Here's what that will look like in Azure AD:

Upon approval, try connecting your Microsoft account again – this time, the integration will be authorized.

Manually grant tenant-wide admin consent

Please note this guide is for Azure AD administrators only.

Lunatask is an all-in-one encrypted personal productivity application. You can learn more about it here. You can also learn more about our approach to encryption and privacy.

As per Microsoft documentation, the tenant-wide admin consent URL follows the following format:

https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={client-id}

Where {tenant-id} is your organization’s Tenant ID or any verified domain name and where {client-id} is our application’s Client ID (its value is 41090573-3b1f-41c3-a30d-62642b12ebd9).

Now, construct the URL by substituting the placeholders for Tenant ID and Client ID, visit the page, and sign in as a user authorized to consent on behalf of the organization.

Then, review the permissions and click "Accept". Do not worry if upon accepting "Oh no! :(" message pops up – this is expected. Now, Lunatask should be added to your enterprise applications, and you should be able to see it in Azure AD.

As the last step, visit Enterprise Applications section in Azure AD, verify the app is there, click to open the application detail, and verify "Enabled for users to sign-in" is checked.

Alternatively, if this flow is not an option, or you're experiencing issues going through it, consider temporarily enabling admin request consents instead.

I need help

Whether you are a Lunatask user or an organization admin, feel free to send a message and we'll be happy to help.

Alternative approaches

There is an alternative approach to connecting your Outlook calendar.

You can either find a way to sync your Outlook calendar into Google calendar and use our Google calendar integration instead. Some of our users achieved this by using OGCS.

Others had success with Outlook CalDav Synchronizer. What this tool does is putting what is basically CalDAV proxy/interface in front of Outlook. Use our generic CalDAV integration with this tool.