In ontwikkeling
Interfaces, Core
- Casper van der Harst
- Martin Wilmink
Inleiding
Op deze pagina's staan de verantwoordelijkheden die horen bij de interfaces in het MedMij Afsprakenstelsel. In elke functie wordt gebruik gemaakt van één of meer van deze interfaces. Onderstaande tabel laat zien welke functies welke interface gebruiken.
| hoofdfunctie | Regie | Uitwisseling | Coördinatie | |||||
|---|---|---|---|---|---|---|---|---|
| interface | user interface | authorization interface | token interface | resource interface | GNL interface | OCL interface | ZAL interface | WHL interface |
| geboden door rol | Authorization Server | Resource Server | MedMij Registratie | |||||
| Opvragen Gegevensdienstnamenlijst | X | |||||||
| Opvragen OAuth Client List | X | |||||||
| Opvragen Aanbiederslijst | X | |||||||
| Opvragen Whitelist | X | |||||||
| Verzamelen | X | X | X | X | ||||
| Delen | X | X | X | X | ||||
| Beheren toestemmingen | X | X | ||||||
Verantwoordelijkheden over de adressering van deze interfaces komen hieronder aan de orde. Verantwoordelijkheden voor de specifieke interfaces zijn opgenomen in specifieke subpagina's, die klikbaar zijn in bovenstaande tabel.
Adressen en interfaces
Op de interfaces in de flows van Verzamelen en Delen adresseren Applicatie-rollen elkaar op basis van een URI. Onderstaande tabel geeft een overzicht.
| hoofdfunctie | interface | geadresseerde | bericht | kanaal |
|---|---|---|---|---|
| Regie | authorization interface | Authorization Endpoint van de Authorization Server | authorization request | frontchannel |
OAuth Client (redirect_uri) | authorization response | |||
| token interface | Token Endpoint van de Authorization Server | access token request | backchannel | |
| Uitwisseling | resource interface | Resource Endpoint van de Resource Server | resource request |
In de nu verantwoordelijkheden wordt bepaald hoe de URI's zijn opgebouwd waarmee de adresbepaler de adresgebruiker de geadresseerde laat adresseren, en hoe de parameters worden gevuld. De opbouw van het adres is steeds dezelfde, ook voor frontchannel en backchannel. Desondanks maken we in het logische informatiemodel, in de Aanbiederslijst, wel onderscheid tussen Frontchanneluri en Backchanneluri. Dat houdt dat model wendbaarder, mocht er ooit wel adresseringsverschillen tussen frontchannel en backchannel ontstaan.