Integratie

Welke stappen zijn nodig voor integratie met 'consumer' applicaties

Authenticatie en Autorisatie

De API van IKO maakt gebruik van JWT-gebaseerde autorisatie. In de praktijk wordt IKO meestal gekoppeld aan dezelfde OIDC-provider als de client-applicatie. Door in de requests een Bearer-token in de Authorization-header mee te sturen, krijgt de client toegang tot de API. Zorg er daarom voor dat de client-applicatie eveneens integreert met deze OIDC-provider voor Single Sign-On (SSO).

API setup

IKO heeft een API-first aanpak en werkt met 'Endpoint', 'Samengesteld gegevensprofiel' en 'Relaties':

• Samengesteld gegevensprofiel: definieer gegevens strategieën per entiteit.

• Relations: configureren van ketens van gegevens opdrachten.

• Endpoint: API endpoints voor specifieke queries.

Acties:

• Maak profiel aan via IKO Web-applicatie (Admin GUI).

  • Ga naar de Admin UI van IKO.

  • Maak een 'Samengesteld gegevensprofie' aan met gewenste Endpoints en Relaties.

  • Sla het 'Samengesteld gegevensprofiel' op.

• Open profiel in je client-applicatie:

  • Samengesteld gegevensprofiel wordt aangesproken via API endpoint van IKO.

  • Typisch endpoint: GET /api/aggregated-data-profiles/{samengesteld-gegevensprofile-naam}/{zoekParam}.

  • Output is JSON dat je kunt verwerken.