Via onze API is het mogelijk om een Single Sign-On (SSO) oplossing te bouwen of om data uit te wisselen tussen jouw applicatie en Johan. Ter voorbereiding op beide type koppelingen zijn er een aantal zaken die gedaan en gecontroleerd moeten worden:
Toegang Johan-omgeving
Voordat je kunt beginnen met koppelen dien je eerst toegang te hebben tot jouw Johan-partneromgeving. Het enige dat je hiervoor moet doen is het tekenen van onze licentieovereenkomst. Vervolgens zal één van onze medewerkers jouw omgeving voor je klaarzetten.
Heb je nog geen toegang tot jouw partneromgeving? Neem contact met ons op via consult@johan.nl.
OAuth 2.0
Binnen Johan werken alle koppelingen via OAuth 2.0. Het is helaas niet mogelijk om via andere protocollen te koppelen. Werken jullie niet via OAuth 2.0, dan is het maken van een koppeling helaas niet mogelijk.
API-credentials aanmaken
Nadat je toegang hebt gekregen tot jouw Johan-omgeving kun je jouw API-credentials aanmaken. Deze worden gebruikt om de API-calls die je op onze API doet te authentiseren. Het aanmaken van jouw API-keys gaat als volgt:
- Log in met jouw beheerdersaccount via https://admin.johan.nl
- Ga naar Instellingen > Partner informatie
- Onderin de pagina zie je ‘Application’ staan. Klik op de knop Add application.
- Vul een Redirect URL in en vink Active en OAuth_data aan. De Redirect URL is de url waar een deelnemer naar wordt doorgestuurd nadat hij succesvol is ingelogd t.b.v. de SSO-koppeling.
- Klik op Save
Nu zie je op de pagina jouw API-keys staan die je kunt gebruiken. Heb jij onder Partner informatie niet de ‘Add application’ knop staan en zie je hier ook niet de API-key staan? Dan ben jij niet de primaire beheerder van deze partneromgeving. Vraag aan jouw primaire beheerder of hij deze voor jou kan aanmaken en om de Key aan je door te sturen.