09.07.2015 Views

DigiD Application Programming Interface - Logius

DigiD Application Programming Interface - Logius

DigiD Application Programming Interface - Logius

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

| <strong>DigiD</strong> <strong>Application</strong> <strong>Programming</strong> <strong>Interface</strong> | 16 augustus 2010Het antwoord van <strong>DigiD</strong> bestaat uit:Key Type Value Omschrijvinguid String [Gebruikers ID] De identiteit van de geauthenticeerde gebruiker.app_id Int [Applicatie ID] Uniek ID van de Webdienst applicatieuitgegeven door <strong>DigiD</strong> Beheer.organization String [<strong>DigiD</strong> organisatie] Naam van <strong>DigiD</strong> organisatie.betrouwbaarheidsniveau [betrouwbaarheidsniveau] Het zekerheidsniveau van de authenticatie.rid String [Request ID] De rid die gebruikt is tijdens initiatie vanauthenticatiea-select-server String [<strong>DigiD</strong> ID] Server-id van <strong>DigiD</strong>.Result_code String [resultaatcode] Het resultaat van de aanroep. ‘0000’ indiensuccesvol.Opmerkingen• <strong>DigiD</strong> gebruikt zekerheidsniveaus. Op dit moment zijn de volgendezekerheidsniveaus gedefinieerd:o 10: (basis) De gebruiker heeft online een gebruikersnaammet wachtwoord aangevraagd en geactiveerd, en heeftzich geauthenticeerd met zijn permanente wachtwoord.o 20: (midden) De gebruiker heeft online eengebruikersnaam met wachtwoord aangevraagd engeactiveerd, en heeft daarnaast een mobieltelefoonnummer als extra factor ontsloten (smsauthenticatie).De gebruiker heeft zich geauthenticeerdmet zijn permanente wachtwoord en een tijdsgebondensms-transactiecode.Belangrijk: De webdienst dient zelf te controleren of er een authenticatieop het juiste zekerheidsniveau heeft plaatsgevonden. Met anderewoorden: er vindt een match plaats tussen het door <strong>DigiD</strong>teruggekoppelde zekerheidsniveau (A) en het door de webdienst gewensteminimale zekerheidsniveau (B). Als (A) < (B) wordt de authenticatie nietgeaccepteerd; als (A) ≥ (B) wordt de authenticatie geaccepteerd.Let op: In de verdere toekomst zullen ook andere middelen op niveauMidden en Hoog worden ontsloten. De gebruikte parameterid’s voor deparameter zekerheid zullen analoog hieraan oplopen. Om aanpassingen opdat moment te voorkomen, adviseren we u het volgende:• Configureer uw webdienst zodanig dat deze alle zekerheidsniveausaccepteert, die gelijk of hoger zijn dan degene die minimaal vooruw webdienst zijn genoodzaakt. Voorbeeld: als uw webdienstminimaal authenticatie vereist op niveau basis (dit zou 10 zijn),zorg er dan voor dat alle authenticaties worden geaccepteerd dieminimaal 10 of hoger zijn (bijvoorbeeld ≥ 10).Meer informatie over de zekerheidsniveaus kunt u vinden in dehandreiking.Pagina 10 van 14

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!