Admin - Office 365 email integration with Laminin

Xander van Wyk

Created May 25, 2024

Admin - Office 365 email integration with Laminin

How to integrate your Office 365 email with Laminin

45
    p

Microsoft Azure Portal

46 Steps

Login to your Microsoft Azure Portal. Note that you will need to be an Administrator on your Microsoft Azure Portal in order to complete the next steps.

1

First we will create a new Enterprise application that will be accessed by Laminin in order to manage selected users' mail accounts

2

From the Home page search for "Enterprise applications" in the top search bar

From the Home page search for "Enterprise applications" in the top search bar
3

Click on "Enterprise applications"

Click on "Enterprise applications"
4

Click on "New application"

Click on "New application"
5

Click on "Create your own application"

Click on "Create your own application"
6

Give your application a name

Give your application a name
7

Choose the "Integrate any other application you don't find in the gallery (Non-gallery)" option

Choose the "Integrate any other application you don't find in the gallery (Non-gallery)" option
8

Click on "Create"

Click on "Create"
9

With the application created we need to specify the permissions of the application.

10

Click on "Permissions" in the left menu.

Click on "Permissions" in the left menu.
11

Click on "app registration"

Click on "app registration"
12

Click on "Add a permission"

Click on "Add a permission"
13

Click on "Microsoft Graph"

Click on "Microsoft Graph"
14

Click on "Application permissions"

Click on "Application permissions"
15

In the search bar type "user"

In the search bar type "user"
16

Click on User to expand the user permissions

Click on User to expand the user permissions
17

Select the "User.Read.All" permission

This allows Laminin to read your Office 365 users' full profiles

Select the "User.Read.All" permission
18

Go back to the search bar and type "mail"

Go back to the search bar and type "mail"
19

Click on Mail to expand the mail permissions

Click on Mail to expand the mail permissions
20

Select the "Mail.ReadWrite" and "Mail.Send" permissions

This allows Laminin to access to read and write mail in all mailboxes and send email using your mail account in the My Mail feature

Select the "Mail.ReadWrite" and "Mail.Send" permissions
21

Go back to the search bar and type "calendars"

Go back to the search bar and type "calendars"
22

Click on Calendars to expand the calendar permissions

Click on Calendars to expand the calendar permissions
23

Select the "Calendars.ReadWrite" permission

This allows Laminin to view and manage your calendar which is used for instance in the Appointment Setup feature

Select the "Calendars.ReadWrite" permission
24

Go back to the search bar and type "people"

Go back to the search bar and type "people"
25

Click on People to expand the people permissions

Click on People to expand the people permissions
26

Select the "People.Read.All" permission

This allows Laminin to access your contacts in order to select this contact in the My Mail feature

Select the "People.Read.All" permission
27

Click on Add permissions

Click on Add permissions
28

Click on "Grant admin consent for YourCompany"

Click on "Grant admin consent for YourCompany"
29

Click on Yes

Click on Yes
30

Next we will add users to the application whose mail accounts will be accessible through Laminin

31

Go back to your application root directory by either clicking on your application name as shown here or by going back to "Enterprise applications" and selecting your application

Go back to your application root directory by either clicking on your application name as shown here or by going back to "Enterprise applications" and selecting your application
32

Click on "Users and groups"

Click on "Users and groups"
33

Click on "Add user/group"

Click on "Add user/group"
34

Under Users click on "None Selected"

Under Users click on "None Selected"
35

Select the users that requires mail integration with Laminin

Select the users that requires mail integration with Laminin
36

Click on Assign

Click on Assign
37

Next we will add a client secret that Laminin will use to authenticate itself to your Azure authentication service

38

Go back to your application root directory by either clicking on your application name as shown here or by going back to "Enterprise applications" and selecting your application

Go back to your application root directory by either clicking on your application name as shown here or by going back to "Enterprise applications" and selecting your application
39

Click on Permissions

Click on Permissions
40

Click on app registration

Click on app registration
41

Click on Certificates & secrets

Click on Certificates & secrets
42

Click on New client secret

Click on New client secret
43

Give the client secret a name

Give the client secret a name
44

Select from the dropdown list how long the client secret will be valid for

Select from the dropdown list how long the client secret will be valid for
45

Click on Add

Click on Add
46

Lastly we will complete the configuration in Laminin

    d

Laminin

6 Steps
47

Open the Admin menu in Laminin

Open the Admin menu in Laminin
48

Click on "Integrations" in the left menu

Click on "Integrations" in the left menu
49

Under "Integrations" click on "Office 365 Settings"

Under "Integrations" click on "Office 365 Settings"
50

Click on "New Office App"

Click on "New Office App"
51

Give the New Office App a name

Give the New Office App a name
52

Select the tenant that this Office Application will be accessed by

Select the tenant that this Office Application will be accessed by
    p

Microsoft Azure Portal

2 Steps
53

Go back to the Azure Portal and click on Overview

If you click on Overview and don't see your Application ID and Tenant ID you are probably in the root directory of your application. Follow steps 38-40 and then click on Overview.

Go back to the Azure Portal and click on Overview
54

Copy the value of "Directory (tenant) ID"

Copy the value of "Directory (tenant) ID"
    d

Laminin

1 Step

Go back to Laminin

55

Back at Laminin paste the Tenant Id into the "Tenant Id" field

Back at Laminin paste the Tenant Id into the "Tenant Id" field
    p

Microsoft Azure Portal

1 Step

Go back to the Azure Portal

56

Copy the value of "Application (client) ID"

Copy the value of "Application (client) ID"
    d

Laminin

1 Step

Go back to Laminin

57

Back at Laminin paste the Application ID into the "Application ID" field

Back at Laminin paste the Application ID into the "Application ID" field
    p

Microsoft Azure Portal

3 Steps

Go back to the Azure Portal

58

Click on "Certificates & secrets"

Click on "Certificates & secrets"
59

Click on Client secrets

Click on Client secrets
60

Copy the Value of Client Secret created earlier in Step 41-45

Please make sure you copy the Value and not the Client ID

Copy the Value of Client Secret created earlier in Step 41-45
    d

Laminin

13 Steps
61

Back at Laminin paste Client Secret into the "ClientSecret" field

Back at Laminin paste Client Secret into the "ClientSecret" field
62

Check the "People Api Enalbed?" checkbox to allow accessing your Office 365 Contacts

This is to access the "People.Read.All" permission that was configured in Step 26

Check the "People Api Enalbed?" checkbox to allow accessing your Office 365 Contacts
63

Check the "Calendar Api Enalbed?" checkbox to allow accessing your Office 365 Calendar

This is to access the "Calendars.ReadWrite" permission that was configured in Step 23

Check the "Calendar Api Enalbed?" checkbox to allow accessing your Office 365 Calendar
64

Click on Save

Click on Save
65

Now that the configuration is done we need to enable mail integration for the users that were added in Step 35

66

Click on User Management

Click on User Management
67

Under "User Management" click on "Manage Users"

Under "User Management" click on "Manage Users"
68

Select the user you want to enable mail integration for

Select the user you want to enable mail integration for
69

Tick the "Mail Integration Enabled?" checkbox

Tick the "Mail Integration Enabled?" checkbox
70

Select the Office 365 Application we just created from the Mail Provider dropdown

Select the Office 365 Application we just created from the Mail Provider dropdown
71

Click on Save

Click on Save
72

The user will now have access to My Mail

The user will need to log out and back in to Laminin for this change to take effect

The user will now have access to My Mail
73

The user can now manage their email using Laminin

The user can now manage their email using Laminin
Well done!
Create how-to guides like this in a snap. Get Tango now.