Procedure: Exchange Online met OAuth gebruiken om afspraken te synchroniseren

Vereisten

• Exact Globe+ of Exact Compact+ 500SP7 of 501SP1 van 15 december 2022 of recenter.
• Exact Globe Next of Exact Compact 422SP14, 423SP7 of 424SP1 van 9 december 2022 of recenter.
• Exact Synergy Enterprise 267SP14, 500SP7 of 501SP1 van 15 december 2022 of recenter.
  
• Exact Lightweight Integration Server (ELIS) ​​voor productupdate 267SP14, 500SP7 of 501SP1 van 5 december 2022 of recenter.

Exact-software kan worden geïntegreerd met Exchange Online-services om afspraken te synchroniseren. In dit document vind je instructies voor een succesvolle integratie. Je kunt ook Exchange-e-mails synchroniseren. Lees meer over de procedure om Exchange Online met OAuth te gebruiken om e-mails te synchroniseren.

Voor het gebruik van de Exact Online Migration Tool en Exact Lightweight Integration Server (ELIS), heb je de Application ID (Client ID), Directory ID (tenant ID) en Client Secret nodig om toegang te krijgen tot Microsoft Exchange Online. Zorg ervoor dat volgende stappen zijn voltooid voordat je Exact-oplossingen verbindt met de Microsoft Exchange Online-applicatie:

1. Registreer een nieuwe app.
2. Configureer de authenticatie voor jouw app.
3. Definieer de instellingen om agenda-items te synchroniseren.
4. Verkrijg de Client ID, Tenant ID en Client Secret.

Registreer een nieuwe app in Microsoft Azure via App registrations

1. Ga naar https://portal.azure.com.
2. Klik in de sectie Azure services op Microsoft Entra ID.
3. Klik in het linkerpaneel op App registrations.
4. Klik op +New registration.
5. Definieer een naam voor de applicatie op de pagina Register an application en klik op Register. De applicatie- en directory-ID's worden weergegeven op de volgende pagina in de sectie Essentials.

Configureer de authenticatie voor jouw app

1. Klik in het linkerpaneel op Authentication in de sectie Manage nadat bovenstaande stappen zijn voltooid.
2. Klik op Add URI in de sectie Web.
3. Geef het adres op in het betrokken veld, zoals bijvoorbeeld https://<servername>/Synergy/docs/SysJwtTokenLogin.aspx.
4. Selecteer de checkbox Access tokens in de sectie Implicit grant and hybrid flows.
5. Klik op Save.
6. Klik vervolgens op Add a platform in de sectie Platform configurations. Het paneel Configure platforms wordt weergegeven.
7. Klik op Mobile and desktop applications. Selecteer de checkbox https://login.microsoftonline.com/common/oauth2/nativeclient.
8. Klik op Configure en klik vervolgens onderaan de pagina op Save.

Definieer de instellingen om agenda-items te synchroniseren

1. Klik in het linkerpaneel op API permissions.
2. Klik op + Add a permission.
3. Klik op het tabblad APIs my organization uses en zoek naar office 365 exchange in het filterveld.
4. Selecteer Office 365 Exchange Online.
5. Klik op Application permissions en activeer het volgende:
   • Other permissions > full_access_as_app
6. Klik op Add permissions.
7. Als de kolom Status voor de betreffende API of permission name leeg is of “Not granted for the Domain name” weergeeft, klik dan op Grant admin consent for [Domain name].
8. Je ziet nu de melding “Grant admin consent confirmation.”.
9. Klik op Yes. De status wordt nu aangepast naar “Granted”.

Opmerking: Je kunt de Microsoft Graph API verwijderen uit de lijst met toestemmingen als deze is geactiveerd, maar je deze niet gebruikt.

Client ID, Tenant ID en Client Secret verkrijgen

Na het aanmaken van een applicatie zoals hierboven beschreven, kun je de Client ID en de Tenant ID als volgt verkrijgen:

1. Ga naar https://portal.azure.com.
2. Klik in de sectie Azure services op Microsoft Entra ID.
3. Klik in het linkerpaneel op Overview.
4. De Tenant ID wordt weergegeven bij Directory (tenant) ID, en de Client ID wordt weergegeven bij Application (client) ID in de sectie Essentials.

Doe vervolgens het volgende om een Client Secret aan te maken:

1. Klik in het linkerpaneel op Certificates & secrets.
2. Klik op + New client secret.
3. Definieer de omschrijving, selecteer de vervalperiode en klik op Add.
   Opmerking: Wanneer de client secret vervalt, moet je een nieuwe client secret aanmaken en de nieuwe waarde in jouw Exact-product opgeven.
4. De Client Secret wordt weergegeven in de kolom Value.
   Opmerking: Het is belangrijk om de client secret op dit moment ergens te noteren, omdat het alléén zichtbaar is bij het aanmaken. De client secret wordt naderhand niet meer getoond.

Je kunt nu de gegevens van de Client ID, Tenant ID en Client Secret gebruiken.