Implementatiehandleiding idin Versie 1.0 December 2016
Inhoud 1. Inleiding... 3 2. Varianten idin... 4 3. Technische ondersteuning... 5 4. Zelfbouw... 6 5. Externe dienstverlener... 8 6. Certificaten... 9 7. Weergave op website... 10
1. Inleiding Wat is idin idin is de nieuwe manier van online identificeren en authentiseren. Ontwikkeld én ondersteund door de Nederlandse banken (ABN AMRO, ASN, ING, Rabobank, Regio Bank, SNS Bank en Triodos). Met idin kan een persoon zich online identificeren bij een bedrijf of instelling. Gemakkelijk, vertrouwd en veilig met de inlogmethode van de bank. Met idin kunt u via uw website op een veilige manier de identiteit van uw klanten vaststellen. Dit beschermt u tegen fraude en bespaart u veel administratief werk en bijkomende kosten. Gebruik van de vertrouwde inlog middelen van de bank zullen uw klanten het gevoel hebben dat hun gegevens niet bij de verkeerde personen terecht komen. Doordat alle banken zijn aangehaakt is het direct door iedere Nederlandse burger met een bankrekening te gebruiken. Naast inloggen kunt u idin ook integreren in uw on-boarding proces. Hierdoor weet u direct met welke persoon u te maken heeft. Door het vereenvoudigen van het proces voor uw klant verhoogd u ook uw conversie. Hoe werkt idin? Banken identificeren en authentiseren ten behoeve van de Know Your Customer (KYC) wetgeving hun klanten. Met idin kan een persoon toestemming geven om zijn bij de bank bekende gegevens worden te online met u te delen bijvoorbeeld om in te loggen of zijn of haar leeftijd te bevestigen. Bij het gebruik van idin klikt uw klant op inloggen met idin. Hij kiest zijn bank en vervolgens komt hij in de vertrouwde omgeving van internetbankieren van zijn eigen bank. Daar worden automatisch alle door u opgevraagde gegevens getoond. Uw klant kiest vervolgens vanaf welke rekening hij de gegevens wil delen. Hierna keurt hij de getoonde gegevens goed en verzendt hij deze met zijn edentifier of PIN-5. Bij akkoord ontvangt u vervolgens vrijwel meteen de opgevraagde gegevens. De bank van uw klant heeft dan al gecontroleerd of uw klant bevoegd is om van idin gebruik te maken. Starten met idin? Om uw klanten idin aan te bieden, sluit u bij ons een idin contract af. Via uw relatiemanager of CTS consultant.
2. Varianten idin Welke variant idin past bij u? ABN AMRO biedt twee varianten idin aan. De varianten verschillen in de technische stappen die u moet ondernemen. Lees hier welke variant het beste bij u past. Zelfbouw Wilt u de idin volledig integreren in uw systemen? Dan past Zelfbouw het beste bij u. U ontvangt van ons de technische specificaties. Op basis daarvan voert u zelf de benodigde technische aanpassingen uit. Houd er rekening mee dat u voor deze variant voldoende technische kennis en tijd nodig heeft. Externe dienstverlener Een externe dienstverlener kan zorgen voor uw aansluiting op ABN AMRO idin. U besteedt de technische aansluiting uit aan een Digital Identity Service Provider (DISP) van uw keuze. In overleg met de DISP bepaalt u hoe de integratie van idin met uw systemen wordt geregeld. Er zijn drie type externe partijen met betrekking tot de aansluiting en het contract: Full DISP: Hierbij heeft de DISP een idin contract met ABN AMRO en u een contract met een DISP. Ook de technische aansluiting wordt verzorgd door de DISP Data Processor: Hierbij heeft u een contract met ABN AMRO maar verzorgd de data processor voor de technische aansluiting.
3. Technische ondersteuning Door de grote verscheidenheid aan websites en systemen is het voor ABNAMRO Bank niet mogelijk om technische ondersteuning te bieden bij de integratie van idin op uw eigen website. De beschikbare documentatie is echter zodanig opgesteld dat een ervaren ontwikkelaar hiermee goed uit de voeten kan. Heeft u toch nog een vraag, suggestie of opmerking? Neem dan contact met ons op door een e-mail te sturen aan de specialdesk.e-commerce@nl.abnamro.com.
4. Zelfbouw Als u gekozen heeft voor de Zelfbouw-variant moet u rekening houden met het volgende: U vraagt de Merchant Implementation Guidelines aan (https://www.betaalvereniging.nl/giraal-en-online-betalen/idin/documentatie-aanvragen/). Hierin staat de technische documentatie zodat u 'idin' naar uw eigen voorkeur met uw website kunt integreren. U maakt zelf de XML-berichten, u bouwt een interface met ABN AMRO idin en u zorgt voor de integratie met uw eigen systemen. Om idin en uw systemen eenvoudiger aan elkaar te koppelen zijn software libraries beschikbaar in.net, Java en PHP. U heeft voldoende technische kennis en tijd nodig voor de optie Zelfbouw. De geschatte doorlooptijd is 1-2 maanden. Die tijd heeft u nodig voor het bouwen van de functionaliteit 'idin' en het integreren daarvan in uw eigen systemen. De geschatte contractuele aansluittijd bij ABN AMRO idin is 2 werkdagen. Het is noodzakelijk dat u in staat bent om de software libraries te kunnen integreren in uw eigen portaal Welke stappen moet u doorlopen? 1. Via uw RM / CTS consultant vraagt u een idin contract aan. 2. De RM / CTS consultant maakt het contract op en stuurt het u toe. 3. Bij akkoord, stuurt u het contract ondertekend terug naar client support. 4. Vraag de Merchant Implementation Guidelines aan via https://www.betaalvereniging.nl/giraal-en-online-betalen/idin/documentatie-aanvragen/. Hier kunt u ook de software libraries aanvragen. Bij een update van de documentatie wordt u via e-mail op de hoogte gesteld. 5. Integreer op basis van de documentatie de software libraries in uw eigen webomgeving. 6. Als het idin contract getekend is en het door ons is ontvangen voeren wij u op in onze systemen en ontvangt u verschillende e-mails (inclusief url en checklist van ABN AMRO) met nadere uitleg hoe uzelf dient te registreren bij ABN AMRO idin. Hiermee krijgt u toegang tot het ABN AMRO dashboard voor zowel de productie- als de testomgeving. 7. Let op er zijn twee omgevingen: (1) de test-omgeving (ABN AMRO Digital Dashboard) en (2) de test-omgeving. U krijgt op beide omgevingen toegang. 8. U ontvangt de volgende e-mails met instructies om toegang te verkrijgen tot beide omgevingen: a. Mail 1a: Uw gebruikersnaam voor het ABN AMRO Dashboard. b. Mail 1b: Kies uw wachtwoord voor het ABN AMRO Dashboard (productie omgeving). c. Mail 2: Kies uw wachtwoord voor het Test Integratiesysteem. d. Mail 3: Bevestiging van uw aanmelding op het ABN AMRO idin Dashboard (productie omgeving)en het idin Test Integratie Systeem. 9. Na de registratie bij ABN AMRO test en productie omgeving, start u met het uitvoeren van de testen in de testomgeving: a. De public signing key (te vinden in de testomgeving in het dashboard onder tabblad documenten) van de ABN AMRO routing service dient u in uw eigen webomgeving te plaatsen. Op die manier kan uw website met zekerheid vaststellen dat de digitale
handtekening in de ontvangen berichten afkomstig is van de ABNAMRO Routing Service en juist is. b. Upload uw eigen public signing key in uw testomgeving van ABN AMRO idin. Onder het tabblad merchant beheer onder de button services. c. U kunt nu transacties inscheten naar de test gateway: https://abnamro-test.bankrequest.com/bvn-idx-bankid-rs/bankidgateway d. Voer alle testcases uit zoals beschreven in de idin checklist (te vinden in de testomgeving in het dashboard onder tabblad documenten). Controleer daarbij of u de antwoorden die u vanuit de testomgeving retour ontvangt goed kunt verwerken in uw eigen omgeving. 10. Na het succesvol afronden van de testen gaat u naar de productieomgeving. Hier voert u de volgende stappen uit: a. De public signing key van de ABN AMRO routing service dient u in uw eigen productieomgeving te plaatsen. Te vinden in het dashboard onder tabblad documenten. b. Upload uw eigen public signing key in de productieomgeving van ABN AMRO idin (onder Services -> Nieuw Certificaat). 11. Vervolgens controleer u in het ABN AMRO productie-omgeving (incassantbeheer -> services - > check uw implementatie button) aan de hand van de checklist of u aan alle gestelde eisen voldoet. Zo ja dan bevestigt u dit door de checkpoints af te vinken en te bevestigen. 12. U ontvangt na activatie een bevestigingsmail met daarin een link naar de productie omgeving. 13. U kunt gebruikmaken van ABN AMRO idin.
5. Externe dienstverlener U neemt de technische oplossing af bij een derde partij, een Digital Identity Service Provider (DISP) of een Data Processor (DP). Deze partij levert het technische platform waarmee u idin' kunt aanbieden op uw website. U heeft geen contract met ABN AMRO, echter wel met uw DISP De integratie met uw systemen wordt door de DISP verzorgd. Kiest u voor een Data Processor dan heeft u een contract met ABN AMRO. De integratie met uw systemen wordt door uw Data Processor verzorgd. Samen met de Externe Dienstverlener van uw keuze regelt u de integratie met uw systemen. De geschatte aansluittijd bij ABN AMRO voor idin is 2 werkdag. De tijd die u nodig heeft voor uw eigen activiteiten en die van de Externe Dienstverlener zijn hierin niet meegenomen. Welke stappen moet u doorlopen? 1. Sluit een idin contract met ons af. 2. Neem contact op met de Externe Dienstverlener van uw keuze en maak nadere afspraken over de implementatie van idin. 3. Als het idin contract in onze systemen is geactiveerd ontvangt u verschillende e-mails (inclusief url) met nadere uitleg hoe uzelf te registreren bij ABN AMRO idin. Hiermee krijgt u toegang tot het ABN AMRO dashboard. 4. Na de registratie bij ABN AMRO idin geeft u in het dashboard aan via welke Externe Dienstverlener u idin laat verzorgen a. indien u voor een Full DISP heeft gekozen wordt u opgevoerd door uw DISP en ontvangt u van hen een sub id. b. indien voor data processor geeft u na de registratie aan in het dashboard voor welke data processor u heeft gekozen 5. U ontvangt een e-mail dat idin voor u geactiveerd is en dat u gebruik kunt maken van de productieomgeving. 6. U kunt gebruikmaken van ABN AMRO idin. Wilt u de rol vervullen van DISP of Data Processor? Neem dan contact met ons op door een e-mail te sturen aan de specialdesk.ecommerce@nl.abnamro.com.
6. Certificaten Het ABN AMRO public signing heeft u nodig zodat u de digitale handtekening van de respons berichten van de routing service kunt controleren. Deze is te vinden onder het tabblad document in het dashboard. Verder heeft u een sleutelset nodig om uw idin aanvragen van een digitale handtekeningen te voorzien. Voor meer informatie verwijzen we u door naar de (technische) Merchant Implementation Guidelines van de BVN. In hoofdstuk 10 van de BVN Merchant Implementation Guidelines (aan te vragen via http://www.betaalvereniging.nl/giraal-en-online-betalen/idin/documentatie-aanvragen) vind u informatie over de eisen aan de beveiliging van uw berichten en hoe u de hiervoor benodigde certificaten kunt aanmaken. Dit is bijvoorbeeld mogelijk op sites als www.openssl.org of https://www.ideal-checkout.nl/ssl/ssl-automatisch-genereren. Het resultaat van het creëren van de sleutelset is dat u het certificaat van die sleutelset upload in het dashboard bij ABN AMRO.
7. Weergave op website De idin huisstijl Als u gebruikmaakt van idin dan moet u voldoen aan de eisen die gesteld worden aan de weergave van idin op de website. Informatie over deze huisstijl van Digitaal Incassomachtigen is te vinden op https://www.betaalvereniging.nl/giraal-en-online-betalen/idin/documentatie-aanvragen/ Hierin vindt u onder andere de eisen die gelden voor de weergave van het idin beeldmerk. Gebruik bijzondere tekens Het proces van de idin verzoeken is ingericht met de MES2 karakterset. Wij verzoeken u vanuit uw website geen andere karakterset te gebruiken.