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 2010rid=A77C582B33C03912&as_url=https://as.digid.nl/aselectserver/server?request=login1&a-select-server=<strong>DigiD</strong>1&result_code=0000De Webdienst zal de browser van de gebruiker dus moeten redirectennaar:https://as.digid.nl/aselectserver/server?request=login1&rid=A77C582B33C03912&a-select-server=<strong>DigiD</strong>1Opmerkingen• Let op de concatenatie van de parameters rid en a-select-serveraan de verkregen URL van <strong>DigiD</strong> voordat de browser wordtgeredirect naar <strong>DigiD</strong>.• Webdiensten dienen de verkregen rid parameter te onthouden alsonderdeel van hun eigen sessie management tijdens deauthenticatieslag.3.4 Verificatie van AuthenticatieVerificatie van authenticatie moet gebeuren wanneer de browser bij deWebdienst komt met in de URL een boodschap afkomstig van <strong>DigiD</strong>. Dezeboodschap bevat vercijferde informatie die de Webdienst onveranderdnaar <strong>DigiD</strong> moet sturen ter verificatie. Hiervoor stuurt de Webdienst eenrequest=verify_credentials verzoek. Als de verificatie succesvol is, zal<strong>DigiD</strong> informatie terugsturen over de geauthenticeerde gebruiker.<strong>DigiD</strong> stuurt drie parameters naar Webdiensten die zij moeten herkennen:• aselect_credentials• rid• a-select-serverWebdiensten die eigen parameters in hun URL gebruiken dienen rekeningte houden met bovenstaande gereserveerde namen.Webdiensten dienen bij het ontvangen van dit verzoek van <strong>DigiD</strong> controleste doen op de rid en a-select-server parameters. Deze moeten immersvoorkomen in de lijst van lopende sessies met <strong>DigiD</strong>.Key Type Verplicht Value Omschrijvingrequest String Ja verify_credentials Verificatie van authenticatiea-select-server String Ja [a-select-server-ID] Naam van de <strong>DigiD</strong> Burger Server.aselect_credentialsString Ja [vercijferde informatie] De vercijferde informatie die deWebdienst onveranderd door moet sturennaar <strong>DigiD</strong>.shared_ secret String Ja [Authenticatiecode] Geeft de door <strong>DigiD</strong> uitgegevenauthenticatiecode aan.rid String Ja [Request ID] De rid die gebruikt is tijdens initiatie vanauthenticatie. Deze parameter moetvoorkomen in een door de <strong>DigiD</strong> eerdergeïnitieerde en nog lopende authenticatiesessie met <strong>DigiD</strong>.Pagina 9 van 14

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

Saved successfully!

Ooh no, something went wrong!