Beställning av certifikat för anslutning till BankID (RP certificate) Version

Transkript

1 BankID Sida 1(12) Beställning av certifikat för anslutning till BankID (RP certificate) Version

2 BankID Sida 2(12) Innehållsförteckning 1 Bakgrund Versioner FP-certifikat för test Systemkrav för BankID Keygen Installera Java (JRE) Beställ FP-certifikat för produktion BankID Keygen grafisk version Starta BankID Keygen på en säker dator Påbörja en beställning Fyll i informationen om din myndighet Skicka certifikatbegäran till Finansiell ID-Teknik BID AB: Console Applikation Starta BankID Keygen på en säker dator Påbörja en beställning Skicka certifikatbegäran till Finansiell ID-Teknik BID AB: Installation av FP-certifikat BankID Keygen grafisk version Färdigt certifikat levererat av Finansiell ID-Teknik BID AB Skapa din PKCS#12 fil Console Applikation Färdigt certifikat levererat av Finansiell ID-Teknik BID AB Skapa din PKCS#12 fil... 12

3 BankID Sida 3(12) 1 Bakgrund Detta dokument beskriver hur en myndighet ansluten till Valfrihetssystem 2018 E-legitimering, i egenskap av förlitande part använder verktyget BankID Keygen för att beställa ett certifikat för anslutning till BankID (FP-certifikat). Certifikatet används för att identifiera myndigheten och för att användaren ska kunna se vilken tjänst som hen legitimerar sig mot eller utför en underskrift mot Versioner Datum Version Beskrivning Författare Ändrat krav för antal tecken i display name" till 40 samt uppdaterat länkar och Java version Tagit bort krav att behöva installera Unlimited Strength Jurisdiction Policy files. Uppdaterat krav för Java version till Testat på nyare OS versioner samt tagit bort tidigare versionshistorik Språkliga anpassningar för Valfrihetssystem 2018 E- legitimering. BankID BankID BankID 2 FP-certifikat för test För testmiljöer så ska man inte beställa certifikat. Instruktioner för hur du hämtar FP-certifikat för test finns på och i dokumentet BankID Relying Party Guidelines.

4 BankID Sida 4(12) 3 Systemkrav för BankID Keygen För att kunna köra Keygen så krävs det att följande är installerat: Java Runtime 1.9 Applikationen fungerar på de flesta plattformar. BankID har testat på följande: Windows Windows 10 Windows Server 2012 Ubuntu LTS Desktop macos Java versioner som testats är: JRE Installera Java (JRE) Du behöver ha Java för att använda BankID Keygen. Du hämtar senaste versionen av JRE (minst version 9.0.1), här:

5 BankID Sida 5(12) 4 Beställ FP-certifikat för produktion 4.1 BankID Keygen grafisk version Starta BankID Keygen på en säker dator Packa upp filen BankID_Keygen_valfrihetssystemet.ZIP i en egenvald katalog. BankID Keygen kräver ingen installation utan kan köras från t.ex. ett USB-minne. Du ska då ha ett kataloginnehåll enligt nedan: Påbörja en beställning Windows: Dubbelklicka på LaunchGUI.cmd för att starta beställningsprocessen. Linux: Sätt rättigheterna på filen LaunchGUI.sh så att du får köra den och kör sedan./launchgui.sh Om du har problem att starta Keygen kan det bero på att du saknar java-stöd i din dator. Se kapitel 3. Klicka sedan på Create certificate request

6 BankID Sida 6(12) Fyll i informationen om din myndighet Ange Company name : Myndighetens officiella namn. Exempel : Myndigheten för digital förvaltning Ange VAT number : Ange myndighetens organisationsnummer utan bindestreck eller blanksteg (10 siffror). Name of the Bank : Här skall det stå Finansiell ID-Teknik BID AB. Gör det inte det används fel version av BankID Keygen. Password: Måste vara minst 12 tecken långt och innehålla minst 4 bokstäver och 1 siffra. Display name (max 40 tecken): Visas för användaren vid legitimering och underskrift och är obligatoriskt. Är normalt myndighetens officiella namn, men kan även vara ett mer känt namn som förknippas med myndigheten eller tjänsten. (högst 40 tecken) Exempel: Finansiell ID-Teknik BID AB är mer känt som BankID och kan då använda det i Display name för att visas för användare. Myndigheten för digital förvaltning är mer känt som DIGG och kan då använda det i Display name för att visa användaren. OBS det är mycket viktigt att du kommer ihåg lösenordet. Om du förlorar det finns det inget sätt att återskapa lösenordet. Om inte alla dessa uppgifter är helt rätt så kan inte beställningen genomföras. Finansiell ID-Teknik BID AB kommer att kontrollera innehållet i beställningen. Tips: Om du klickar på Browse så kommer applikationen föreslå ett filnamn åt dig.

7 BankID Sida 7(12) När du är klar klickar du på Create certificate request. Om allt går bra får du en bekräftelse liknande den nedan. Du ska nu ha följande filer sparade på din dator : Skicka certifikatbegäran till Finansiell ID-Teknik: Du ska nu skicka filen med certifikatbegäran (exempel Forlitande_cert_for_FinansiellID- TeknikBIDAB_ p10 ) i ett e-postmeddelande till adressen valfrihetssystem@bankid.com. Se till att det är en för myndigheten behörig beställare som skickar e-postmeddelandet innehållande filen. Finansiell ID-teknik utför r beställningen snarast, normalt inom tre arbetsdagar. När du sedan får tillbaka certifikatet ska du starta med instruktionerna under avsnitt 5.

8 BankID Sida 8(12) 4.2 Console Applikation Starta BankID Keygen på en säker dator Packa upp filen BankID_Keygen_valfrihetssystem.ZIP i en egenvald katalog. BankID Keygen kräver ingen installation utan kan köras från t.ex. ett USB-minne Påbörja en beställning Windows: Från en kommandotolk kör LaunchCons.cmd -createrequest privatekey.key certrequest.txt Linux: Sätt rättigheterna på filen LaunchCons.sh så att du får exekevera den och kör sedan./launchcons.sh -createrequest privatekey.key certrequest.txt Om du har problem att starta Keygen kanske du saknar java-stöd i din dator. Se kapitel 3. Ange Company name : Myndighetens officiella namn. Exempel : Myndigheten för digital förvaltning Ange VAT number : Ange myndighetens organisationsnummer utan bindestreck eller blanksteg (10 siffror). Name of the Bank : Här skall det stå Finansiell ID-Teknik BID AB. Gör det inte det, så används fel version av BankID Keygen.. Password: Måste vara minst 12 tecken långt och innehålla minst 4 bokstäver och 1 siffra. Display name (max 40 tecken): Visas för användaren vid legitimering och underskrift och är obligatoriskt. Är normalt myndighetens officiella namn, men kan även vara ett mer känt namn som förknippas med myndigheten eller tjänsten. (högst 40 tecken) Exempel: Finansiell ID-Teknik BID AB är mer känt som BankID och kan då använda det i Display name för att visas för användare. Myndigheten för digital förvaltning är mer känt som DIGG och kan då använda det i Display name för att visa användaren.

9 BankID Sida 9(12) Du ska nu ha följande filer sparade på din dator : Skicka certifikatbegäran till Finansiell ID-Teknik: Du ska nu skicka filen med certifikatbegäran (exempel Forlitande_cert_for_FinansiellID- TeknikBIDAB_ p10 )i ett e-postmeddelande till Finansiell ID-Teknik BID AB till adressen valfrihetssystem@bankid.com. Se till att det är en från myndigheten behörig beställare som skickar e-postmeddelandet innehållande filen. Finansiell ID-teknik utför beställningen snarast, normalt inom tre arbetsdagar. När du sedan får tillbaka certifikatet ska du starta med instruktionerna under avsnitt 5.

10 BankID Sida 10(12) 5 Installation av FP-certifikat 5.1 BankID Keygen grafisk version Färdigt certifikat levererat av Finansiell ID-Teknik BID AB Du kommer att få ett certifikat levererat av Finansiell ID-Teknik BID AB Skapa din PKCS#12 fil Börja med att starta BankID Keygen och välj sedan Create certificate Ange nu sökvägarna till din privata nyckel och till det certifikat du har fått från Finansiell ID-Teknik BID AB. Ange sedan sökvägen och filnamn till den fil du vill ska skapas. Lösenordet du anger är samma som du angav när du skapade din certifikatsansökan. (Om du inte kommer ihåg detta måste du göra en ny ansökan). Det lösenordet kommer också att vara det nya lösenordet på PKCS#12 filen.

11 BankID Sida 11(12) Nu har du ett färdigt FP-certifikat som kan användas i BankID-tjänsten. Se dokumentation för din programvara för att använda certifikatet. Kopiera det från PKCS#12 file path till den plats du önskar. RPcertifikatet installeras normalt i systemets keystore och BankIDs CA root certificate i systemets truststore. 5.2 Console Applikation Färdigt certifikat levererat av Finansiell ID-Teknik BID AB Efter en tid kommer du få ett certifikat levererat av din Finansiell ID-Teknik BID AB.. Exempel : Förlitande_part_AB_(publ)_webbuitken_01_Banknamn_AB_ der där datum och tidpunkt är då certifikatet har skapats.

12 BankID Sida 12(12) Skapa din PKCS#12 fil Windows: Från en kommandotolk kör LaunchCons.cmd -createp12 privatekey.key certificate.cer output.p12 Linux: kör./launchcons.sh -createp12 privatekey.key certificate.cer output.p12 Kommandot för detta exempel blir alltså: LaunchCons.cmd -createp12.\certs\forlitande_cert_for_finansiellid- TeknikBIDAB_ key.\certs\Forlitande_cert_for_FinansiellID-TeknikBIDAB_ p10.\certs\ FinansiellID-TeknikBIDAB_ p12 Lösenordet du anger är samma som du angav när du skapade din certifikatsbegäran. (Om du inte kommer ihåg detta måste du göra en ny begäran). Det lösenordet kommer också att vara det nya lösenordet på PKCS#12 filen. Nu har du ett färdigt FP-certifikat som kan användas i BankID-tjänsten.