Create application for integration

When setting up the Exchange integration in Lanteria HR, the authentication method is to be selected. The users can choose between the Basic (login and password) and Modern (OAuth) authentication. Microsoft announced deprecation of basic authentication to connect to their services including Exchange Web Service. Thus, it is recommended to choose Modern and configure the OAuth authentication method.  

The OAuth configuration steps in the Microsoft Entra ID (previously known as Azure Active Directory) admin center are as follows:

1. Sign in to the Azure portal, browse to Microsoft Entra ID > App registrations, and then click New registration to create a new application registration. 
   
2. In the Register an application window, in the Name field, specify the name of the application.
   
3. Under the Supported Account Types field, select Accounts in this organizational directory only (Default Directory only - Single tenant).ur scenario.
4. Under Redirect URI, select Public client (mobile & desktop) and set the value to https://login.microsoftonline.com/common/oauth2/nativeclient.
   
5. Click Register. From the page that opens, copy the values of the Application (client) ID and Directory (tenant) ID and save them. These will be used when setting up the Lanteria HR part of integration.
   
6. Under Manage, click Manifest.
7. Locate the requiredResourceAccess property in the manifest (use Ctrl+F to find a key), and set 
   • "resourceAppId" to "00000002-0000-0ff1-ce00-000000000000
   • Under resourceAccess, change "id" to "dc890d15-9560-4a4c-9b7f-a736ec74ec40" and "type" to "Role". After the changes, the manifest must look as follows:
     

8. Click Save.
9. Under Manage, click API permissions.
10. Confirm that the full_access_as_app permission is listed.
    
11. Select Grant admin consent for app and provide confirmation.
12. Under Manage, click Certificates and Secrets, and then add a new client secret, which will be used when you fill in the Azure AD Connection Settings field while configuring Exchange Integration Settings in Lanteria HR.
13. In the Description field, type the secret description.
14. Set Expires to 730 days (24 months).
15. Click Add.
    
16. Once a new client secret is created, please copy its value and save somewhere, it will be used when configuring Lanteria HR.
    
    Note

    The portal Never Expire option for the Client Secret Expiry was removed in April 2021.

    Please set up a reminder to create a new client secret and update Lanteria HR settings before it expires.