Overview
This integration uses application based authentication to access your company's Outlook data. This makes it easy for anyone with access to the MS365 cloud upload feature to seamlessly use our Outlook integration without any additional mailbox delegation requirements.
This article describes the steps required to set up the integration. For details on how to use the integration once it's been set up, click here. It is a 2 step process that is very similar to connecting to the Microsoft Teams integration, involving:
Registering a new application in MS Azure
Generating the app certificate from Logikcull and uploading it into MS Azure
Configuring the Integration in Azure Active Directory
You will need access to your organization's Microsoft Tenant's Azure Active Directory to register the application.
Register/Create Application in Azure AD
Navigate to Azure Portal Home > Azure Active Directory:
Click App registrations > New registration:
Name the application, select supported account types, and click Register:
Set Application Permissions
Once the application is registered, navigate to API Permissions:
Click Add a permission, then select Microsoft Graph from the list of APIs:
Search for and add all of the necessary APPLICATION permissions for Microsoft Graph:
Required permissions for Microsoft Graph API:
Mail.Read
User.Read.All
With all Microsoft Graph permissions configured, click Grant admin consent. Green check marks indicate permissions have been granted:
Setting up the Integration in Logikcull
This initial setup must be completed by an Account Owner. Once complete, any users with the necessary permissions may use the integration.
Generate/Download a Certificate in Logikcull Account
Navigate to the Account Preferences page. Click the house icon on the left toolbar and select Preferences:
Scroll down to the Third Party Integrations header > click Connect next to Microsoft Outlook:
When prompted, click Generate New Certificate. Next, click Download Certificate. The certificate (a file with a .pem extension) will be saved to your local drive:
Add Certificate to Registered App in Microsoft Tenant
If you have not yet registered an Application in Azure Active Directory, follow the instructions in 🔗 Configuring the Integration in Azure Active Directory.
Open Azure Active Directory > App Registrations. Click on the name of the registered Application for the Logikull Outlook app you just registered.
Then navigate to Certificates & secrets (or the link under Client Credentials):
Click Upload Certificate and upload the certificate (.pem extension) downloaded from Logikcull:
Browse for the certificate, enter a description, and click Add:
You should now see the certificate listed in Azure Active Directory:
Add the Registered App Information in Logikcull
Locate the Application ID, Object ID, and Tenant ID within your Microsoft Tenant Application. Copy them to your clipboard and paste them into the Logikcull Account Administration modal:
Paste the Application ID, Object ID, and Tenant IDs from your clipboard. Click Connect to Microsoft Outlook:
Once the connection has been established, Logikcull will display a summary page. Click Close summary, and you’re ready to start using the integration!
Note that this will give everyone who has access to our Microsoft cloud uploads feature within your account the ability to create Microsoft Outlook uploads.
FAQS
Do I need a subscription to use this integration?
No, Microsoft has only made the Teams app metered. You do not need to connect to a subscription to upload Outlook data.
Can I connect the integration as a Microsoft user?
You can, but there are limitations with this approach. To connect as a user, you need to be an Exchange Admin, and every mailbox that you want to collect from needs to be explicitly delegated to you. This typically involves IT in order to delegate, and then remove access to the mailboxes once the collection is complete. Delegation also has the unfortunate side effect of giving the Exchange Admin read/write visibility of the delegated mailboxes from the Outlook app - which may pose security concerns.
References
App Access:
Register an application with the Microsoft identity platform:
What is an Azure Active Directory Application?