Dit artikel is onderdeel van de artikelserie over het Wolters Kluwer Account.
Is het Wolters Kluwer Account nieuw voor je? Lees dan eerst het volgende artikel: Het Wolters Kluwer Account - Introductie
Partnerapps
Als je een specifiek bedrijfsproces ondersteunt met een app of pakket van een andere leverancier, waarvan de financiële gevolgen in Twinfield Boekhouden moeten worden opgenomen, dan is aan jouw Twinfield administratie een partnerapp gekoppeld. We spreken hier over een partnerkoppeling. Zo'n partnerkoppeling is een veel gebruikte manier om 'straatjes' te bouwen: met specifieke apps die gespecialiseerd zijn in een stukje van jouw geautomatiseerde proces. Twinfield Boekhouden koppelt wel met zo'n 600 specifieke partnerapps, lees er alles over op deze overzichtspagina: Partnerkoppelingen - Basisbegrippen en termen
Hoe werkt een koppeling tussen een applicatie en Twinfield?
Applicaties koppelen met Twinfield op basis van Oauth2. Hoe Oauth2 werkt leggen we uit aan een voorbeeld uit het dagelijks leven:
Stel je voor dat je iemand (laten we zeggen Alex) op het feest hebt ontmoet, en je hebt hem tijdelijk toegang gegeven tot je kluisje met je telefoon erin. Tot nu toe mocht Alex alleen kijken naar je spullen (lezen). Maar nu wil je dat hij je telefoon even oppakt en een foto voor je maakt (toevoegen). Hoe werkt dit precies, en hoe weet je dat Alex het was die die foto heeft gemaakt?
1. Extra toestemming voor het toevoegen van data
Alex komt naar je toe en vraagt nu om toestemming om niet alleen te kijken, maar ook dingen te doen in je kluisje (zoals een foto maken met je telefoon). Je geeft hem toestemming, maar niet zomaar! Je geeft hem een tijdelijke sleutel die nu aangeeft dat hij mag kijken én mag gebruiken. Dit is het geven van toestemming bij het maken van een connectie tussen twee applicaties en de andere applicatie namens jou mag kijken en gebruiken. Dit doen we bij Twinfield door middel van een koppelgebruiker aan te maken, zodat de gebruikerscode gebruikt kan worden bij de transactie.
2. Een nieuwe, speciale sleutel
De sleutel die je Alex hebt gegeven, is aangepast: hij is speciaal ingesteld om extra dingen te mogen doen, zoals het gebruiken van je telefoon in het kluisje. Dit is dus niet dezelfde sleutel als die hij had toen hij alleen mocht kijken. Met deze nieuwe sleutel kan hij een foto maken of zelfs iets op je telefoon aanpassen (zoals data toevoegen).
3. Logging: hoe weten we dat Alex de foto heeft gemaakt?
Stel je voor dat de kluisjes een logboek hebben waarin automatisch wordt vastgelegd wie welke sleutel heeft gebruikt en wat er met de spullen is gebeurd. Dus wanneer Alex je telefoon oppakt en de foto maakt, wordt er in het logboek genoteerd dat Alex met jouw toestemming de actie heeft uitgevoerd en wanneer dat is gebeurd. Als je later terugkijkt in het logboek, zie je precies dat Alex het was die de foto heeft gemaakt. Dit is de Twinfield koppelgebruiker die gebruikt wordt om een connectie tussen twee applicaties toe te voegen.
4. Controle over de sleutel
Omdat jij eigenaar bent van de kluis (jouw administratie) en de sleutels, kun je op elk moment de toestemming van Alex intrekken. Als je niet meer wilt dat Alex foto's maakt of je telefoon gebruikt, kun je zijn sleutel ongeldig maken. Dan kan hij vanaf dat moment niets meer doen in je kluisje, ook al had hij eerder toegang.
Samengevat:
Door OAuth2 geef je iemand zoals Alex niet alleen een sleutel, maar bepaal je precies wat hij wel en niet mag doen. Dit is in Twinfield geregeld met gebruikersrechten die je geeft aan de koppelgebruiker. Je kunt later in het logboek zien dat Alex de foto heeft toegevoegd, en je hebt de controle om op elk moment zijn rechten in te trekken. Zo blijf jij de baas over wat er gebeurt, zelfs als je anderen tijdelijk toegang geeft.
Welke scenario's zijn er bij het overzetten van een koppelgebruiker naar het Wolters Kluwer Account?
Wolters Kluwer Account gebruikers dienen een uniek e-mailadres te hebben. Dit heeft te maken met identificatie en authenticatie. Bij het aanmaken van gebruikers in Twinfield is het invullen van het e-mailadres verplicht. Dit vormt de basis voor het aanmaken van een WKA.
- Er is een koppelgebruiker met een uniek e-mailadres in de omgeving voor een koppeling. Nodig de koppelgebruiker uit voor het WKA en accepteer de uitnodiging. Je hoeft niet de koppeling opnieuw te leggen tussen de applicaties. Die blijft gewoon werken.
- Er zijn meerdere koppelgebruikers met ieder een uniek e-mailadres in de omgeving voor meerdere koppelingen. Nodig de gebruikers uit voor het WKA en accepteer de uitnodigingen. Je hoeft niet de koppeling opnieuw te leggen tussen de applicaties. Die blijven gewoon werken.
- Er zijn meerdere koppelgebruikers met een (niet uniek zijnde) e-mailadres in de omgeving aanwezig voor meerdere koppelingen. Hiervoor dien je unieke e-mailadressen aan te maken of een alias te creëren. Hoe je een alias creëert verschilt per domein, maar voor Microsoft werkt het op deze manier.
FAQ:
Is er documentatie beschikbaar omtrent het maken van een koppeling op basis van OAuth2?
Documentatie over het maken van een koppeling met Twinfield met OAuth2 is te vinden op de volgende site: https://wktaaeu.my.site.com/nlcommunity/s/article/API-Best-Practices-Introduction?language=en_US
