Gebruik Gekoppelde applicaties in Topdesk

Een goeie maand geleden is er een nieuwe optie beschikbaar om applicaties te laten connecteren met Topdesk.
Dit heet “Gekoppelde applicaties”.

Deze nieuwe functionaliteit geeft jullie de mogelijkheid om andere systemen te laten praten met Topdesk via een OAuth authenticatie in plaats van de klassieke API-accounts.

Recent kan je bij het aanmaken van een integratieclient nu ook rechten koppelen (zoals een webhook uitvoeren).

Authenticatie via API-account (Applicatie token) vs OAuth (gekoppelde applicaties)

Accounts aanmaken

API-accounts:

• Deze accounts worden via de klassieke manier aangemaakt (Nieuw- Ondersteunende bestanden - api account)
• Deze account moeten steeds aan een kantoor worden gekoppeld.
  Meestel maak je dan een apart kantoor aan (bv service accounts) om deze accounts snel te kunnen terugvinden.
• Om deze accounts af te schermen van de andere behandelaars, moet je werken met een kantoorfilter of behandelaarsfilter
• De applicatie token moet je apart aanmaken, alsook instellen hoelang deze geldig is.
  In sommige ligt die geldigheidsdatum ver in de toekomst, wat wel eens een beveiligingsrisico kan meebrengen.

Gekoppelde applicaties:

• Deze integraties zijn een part onderdeel in Topdesk. (Modules - ondersteunende bestanden - gekoppelde applicaties)
• Hier maak je een integratie aan.
  De integratieclient bevat :
  • Client id
  • Client secret
  • Geldigheid van 1 jaar
• Deze integraties kan je via rechten in een rechtengroep afschermen.

Authenticatie in een actiereeks

API-accounts:

• De authenticatie met deze accounts zijn te configureren in de connecties bij de actiereeksen.
• De authenticatie is een basic base64 authenticatie.
• Het gebruik is straightforward en gemakkelijk

Gekoppelde applicaties:

• Om de authenticatie uit te voeren zal je een aantal stappen moeten uitvoeren in de actiereeksen.
• in bijlage vinden jullie de actiereeks die dit zal uitvoeren.