Microsoft 365 integration – COYO Campus

Microsoft 365 integration in COYO makes your digital home that little bit more complete. Your employees will find all common Office programs on a single platform, which will make their daily work easier. You can set up quick and clear access to Word, Excel and the like with the following steps.

Authentication

In COYO

First, you need to add a new authentication provider in COYO.
Under "Administration" > "Authentication", you can find the button "Create authentication provider" in the top right-hand corner:

We’ve simplified the connection for you as far as Microsoft allows: We have saved default settings so that COYO automatically completes the fields where the parameters don’t differ.

Name: Freely selectable – for recognition purposes, we recommend "M365" / "Microsoft 365"
Type: OpenID Connect
Default setting: Microsoft 365 + Integrations

Bildschirmfoto_2021-01-22_um_11.39.59.png

Once you’ve selected the default settings, all of the fields are completed automatically – apart from two.
You now need to generate the last two fields, "Client ID" and "Client Secret", from your Microsoft account.

In Microsoft Azure

Please open this link and log in with your Microsoft account:
https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade

Under "App Registration", you’ll find the button "+ New registration":

Then enter a name of your choice in the new app registration and select the second point "Accounts in any organizational directory (any Azure AD directory – Multi-tenant)" and confirm with "Register".

Once you have registered the app – i.e. COYO – in your Microsoft Azure account, the settings will open.
Here, copy the "Application ID (Client)" and paste this into the field "Client ID" in COYO.

Under the menu point on the left, "Certificates & Secrets", you now create a new "Secret Client Key".
Here, too, you’re free to choose a name.

You can set the validity to "Never" as the connection exists for as long as you hold the license for COYO or the license for M365.

Note:

The newly created key is only visible once when it’s created. It’s no longer possible to copy the code later on.

Copy this key and paste it into COYO under "Client Secret".
In the lower area shown in blue, the "redirect URL" is now created.
Please copy this and paste it under "redirect URL" in your Azure account (see screenshot above).Don’t forget to

The next step is to set the permissions in Azure under "API Permissions", which are listed in the COYO configuration under "Scope".

Bildschirmfoto_2021-08-12_um_13.20.28.png

To do this, you must enter these permissions:

openid
offline_access
User.Read 
Calendars.ReadWrite 
mail.read
Sites.Read.All

If you do not want to assign one of these permissions, you can simply omit it.

save! You’re finished in the Microsoft Azure interface.

You now also need to finally save in the COYO Administration.

For the final implementation, you need to log out and log in with the M365 application:

Note:

It’s possible that a different description will appear for you here. In the first step, you selected the name that should be used for the authentication provider within the COYO interface. If necessary, you can change the name later on without any problems. Please also ensure that the users are already saved in COYO for the login with M365.

Make Microsoft 365 available to users

You’ve now connected COYO to Microsoft 365 and put in place all of the technical requirements. To allow the users to be able to use the Microsoft 365 functions, you need to select "Office 365" as active integration and grant your users the permission "Activate Microsoft 365", which you can find in your roles under "User administration". Only then can they use the features.

Integrated Microsoft 365 applications

We’re constantly optimizing the interaction between COYO and the Microsoft 365 applications. For far, this includes:

Authentication

In COYO

In Microsoft Azure

Make Microsoft 365 available to users

Integrated Microsoft 365 applications

Missing something?