Als ontwikkelaar wil ik duidelijke foutmeldingen voor authenticatie/autorisatie

[joeribekker]

...zodat ik het daadwerkelijke probleem kan oplossen.

Als er iets fout is geconfigureerd is het onduidelijk wat een foutmelding echt betekent (bijvoorbeeld bij "Authenticatiegegevens zijn niet opgegeven"):

1. Benodigde scope niet in JWT (vaak het geval)?
2. Helemaal geen JWT meegegeven?
3. Client ID bestaat niet, of heeft ongeldig secret?
4. Wie geeft deze foutmelding? Soms komt deze foutmelding van het component zelf, maar soms van het NC en komt de notificatie alleen niet goed door, of van een ander component (het ZRC dat het ZTC raadpleegt bijvoorbeeld). Dit speelt vooral bij de eerste keer als je alles installeert.
5. HTTP 500 komt ook nog wel eens voor :(

Bepaling prioriteit door PO

• verbreding of verdieping API's
• stimuleert gebruik door gemeenten
• stimuleert gebruik door leveranciers

... eventueel nog toelichting door PO

Definition of ready

• Iedereen in het team begrijpt de user story
• de gewenste (aanvulling op de) functionaliteit van de API's duidelijk en beschreven is.
• Is klein genoeg (maximaal 1/5 van sprint)
• Product Owner akkoord en voorzien van prioriteit (mag alleen afgevinkt worden door PO)
• Idee hebben van hoe deze user story kan worden gedemonstreerd.
• Globale oplossingsrichting bekend
• Vastgelegd in Github en geplaatst in kolom ready

Definition of done

• Er is een OAS 3.0 specificatie
• Er is een referentieimplementatie
• Er zijn tests aanwezig die de wijziging aantonen en waarmee de user story getest kan worden.
• De technische specificatie (standaard.md) is gepubliceerd leesbaar
• Gebruikte gegevensmodel is na iedere iedere sprint bijgewerkt.

Acceptatiecriteria

• De DSO URI- en API-strategie worden gevolgd of afwijkingen zijn vastgelegd als ontwerp keuze
• Er zijn geen bekende GEMMA tegenstrijdigheden of afwijkingen zijn vastgelegd.

Taken

• Implementeren in referentie-implementatie [verantwoordelijke]
• Schrijven (unit) test voor referentie-implementatie [verantwoordelijke]
• Genereren/opstellen van OAS 3.0 [verantwoordelijke]
• Human Readable publiceren Open API Specificatie (v.3.0) [verantwoordelijke]
• Documentatie bijwerken
• Gegevensmodel bijwerken