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
Once you’ve selected the default settings, all of the fields are completed automatically – apart from three. You now need to generate the last three fields, "Client ID", "Client Secret" and "Tenant-Id" from your Microsoft account.
In Microsoft Azure
Log in to your Microsoft Azure and navigate to the app registrations section. There 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".
Afterwards the settings for this app registration will open. Here, copy the "Application ID (Client)" and paste this into the field "Client ID" in the authentication provider configuration in COYO. As well as copy the "Directory (tenant) ID" and paste this into the field "Tenant-Id" in the authentication provider configuration 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 under "Client Secret" in the authentication provider configuration in COYO.
Now save the configuration of the authentication provider in COYO once and edit it again.
In the lower area shown in blue, the "redirect URL" is now created. Please copy this and paste it under "Redirect URLs" in your Azure account (see right side of the screenshot above). Please always choose "Web" under "Web application" when adding the URL.
In the next step you have to set the API permissions in Azure under "API permissions". These are listed in the COYO configuration under "Scope". It is important that you set them as type "Delegated" and have them granted by an admin (this is indicated by the green check mark).
These are the mentioned permissions:
Calendars.ReadWrite
Mail.Read
offline_access
openid
Sites.Read.All
User.Read
If you do not want to assign one of these permissions, you can simply omit it.
Note:
If you omit permissions, certain features of the M365 integration will not work.
Save! You’re finished in the Microsoft Azure interface.
You can now also save the configuration 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:
- Edit Office documents in COYO
- Synchronize events with the Outlook calendar (from V20)
- Quick access to Microsoft 365 apps via the launchpad (from V20)
- Attach files to posts from SharePoint Online (from V21)
- Find SharePoint Online files via the COYO search (from V22)
