How to move from Basic Authentication to using OAuth for calendar integration in Competella

This article describes how to set up your Office 365 and Azure environment to start using the Competella calendar integration with Exchange online. Microsoft has changed the way of doing this authentication in Office 365 from the start of 13 October 2020. After this date there will be no support for the basic authentication. 

What you need to do?

To continue using the calendar services in your Competella solution from TDC Erhverv you need to do some basic setup of your Office 365 and Azure environment. This includes registering an App in Azure that handles the authentication towards the Competella solution from TDC Erhverv.

When the following steps have been completed, you must send three pieces of data to TDC Erhverv Cloud Support. This is described in detail at the bottom of this article.

Required basic knowledge 

The installation procedure requires that you have detailed knowledge of the existing IT environment and detailed knowledge of the Teams deployment in Azure. 

Accounts and Permissions Requirements 

The person performing the configuration tasks for the customer in Azure needs to have sufficient permissions in Azure to add applications in “App registrations” - for instance, the roles Application Administrator, Cloud Application Administrator or Global Admin. 

The step-by-step guide

1. Log on to portal.azure.com with an account with an Application AdministratorCloud Application Administrator or Global Admin role that has the permissions to create and manage Apps in your Tenant. 

blobid0.png

2. Click on Azure Active Directory followed by clicking on App registrations.

blobid2.png

3. Select New registration and input the following details:

  • Name: CompetellaCalendarOAuthApp 
  • Supported account types:  Accounts in this organizational directory only 
  • Redirect URI:Public client/native and urn:ietf:wg:oauth:2.0:oob 

blobid3.png

4. Click Register 

5. Copy the value of Application (client) ID to, for instance, a notepad.

blobid5.png

6. Click and select API permissions.

blobid4.png

7. Select Add permission.

8. Under Request API permissions select Exchange under Supported legacy APIs.

blobid7.png

9. Select Application permission. Under Select permissions set a check for full_access_as_app and click on the blue button Add permissions.

blobid8.png

10. Select Grant admin consent for <name of organization>.

blobid9.png

11. Click Yes in the popup. 

12. Select Certificate & secrets 

13. Click on New Client Secret  

  • Add short description: CompetellaCalendarOAuthAppSecret 
  • Set Expires to Never 

14. Click Add.

blobid10.png

15. Copy the value of the newly created client secret to, for instance, a notepad.

blobid11.png

And the final and most important step...

Send the below three pieces of data to TDC Erhverv Cloud Support using the ticket that we sent you:

  • The value of Application (client) ID that you copied in step 5
  • The secret value that you copied in step 15
  • Your tenant domain name - can be found under Azure Active Directory -> Custom domain names. The domain name we are looking for ends with onmicrosoft.com.

Once received, we will configure your Competella solution backend

Thank you very much for your help.

Was this article helpful?
0 out of 0 found this helpful
Fortæl os hvorfor


Udfyld venligst formularen med en gyldig e-mail og feedback til artiklen.

Comments