LUDUS Web Vejledning i eksport af certifikat Indhold 1. Introduktion... 2 2. Opsætning af Path-variablen... 3 3. Eksport af certifikat... 4 4. Indsendelse af certifikat... 6 5. Test af forbindelse til US2000... 8 5.1 Ved problemer med at teste forbindelsen... 9 CSC Scandihealth A/S Side 1 af 9
1. Introduktion For at LUDUS Web kan kommunikere med SU-styrelsens system US2000, er det nødvendigt, at der er installeret et officielt SSL-servercertifikat til brug for LUDUS Web. CSC har en vejledning til installation af et sådant certifikat på vores kundenet på http://www.csc.com/sundhed/ds/38377-kundenet. Når certifikatet er installeret korrekt, skal certifikatets offentlige nøgle eksporteres til en fil, og sendes til SU-styrelsen. Den offentlige nøgle vil herefter blive installeret i US2000, som herefter vil kunne genkende jeres LUDUS Web-installation. Når jeres offentlige nøgle er installeret i US2000, er LUDUS Web klar til at påbegynde indsendelse af SU-oplysninger om jeres kursister til US2000. CSC Scandihealth A/S Side 2 af 9
2. Opsætning af Path-variablen Som ved installation af certifikat, skal programmet keytool.exe bruges ved eksport af certifikatet. Derfor skal keytool.exe findes i Path-miljøvariablen. Programmet er installeret sammen med Java (i underbiblioteket bin). Sandsynligvis findes keytool.exe allerede i Path-miljøvariablen. Dette kan verificeres ved at åbne en kommandoprompt og skrive keytool. Hvis systemet svarer med en liste over keytools parametre, så er Path-variablen sat korrekt op, og vejledningen kan fortsættes fra afsnit 3. Path-variablen kan redigeres på følgende måde: 1. Åbn kontrolpanelet fra Start-menuen. 2. Vælg System. 3. Vælg avancerede indstillinger (Advanced). 4. Vælg miljøvariabler (Environment Variables). 5. Herefter redigeres systemvariablen Path ved at indsætte stien til keytool.exe. Stien kan fx være C:\Programmer\Java\jdk_1.6.0_18\bin. CSC Scandihealth A/S Side 3 af 9
3. Eksport af certifikat Certifikatets offentlige nøgle skal nu eksporteres fra jeres keystore. 1. Åbn en kommandoprompt og naviger (med kommandoen cd) hen til biblioteket, hvor LUDUS Web er installeret. Dette kan f.eks. være C:\Programmer\CSC Scandihealth\LUDUS Web. Naviger hen til underbiblioteket keys. 2. I biblioteket keys ligger jeres keystore, hvori jeres certifikat er installeret. Dette er sandsynligvis en fil med endelsen jks. 3. Notér private key-alias. Alias findes med følgende kommando: Hvis keystore er i JKS-format: keytool list keystore <navn på keystore>.jks Hvis keystore er i PKCS12-format: keytool list keystore <navn på keystore>.pkcs12 storetype PKCS12 Der vil være en linje med teksten PrivateKeyEntry, i følgende format: <alias>, <dato>, PrivateKeyEntry Hvis der fx står: ludus, 05-03-2009, PrivateKeyEntry så er alias = ludus. 4. Udfør herefter følgende kommando: Hvis keystore er i JKS-format: keytool exportcert keystore <navn på keystore>.jks alias ludus file eksporteret_certifikat.cer Hvis keystore er i PKCS12-format: keytool exportcert keystore <navn på keystore>.jks alias ludus file eksporteret_certifikat.cer storetype PKCS12 Denne kommando eksporterer certifikatet til filen eksporteret_certifikat.cer. Figur 1 illustrerer de kommandoer der skal udføres for at eksportere certifikatet. CSC Scandihealth A/S Side 4 af 9
Figur 1 CSC Scandihealth A/S Side 5 af 9
4. Indsendelse af certifikat Nu er certifikatet eksporteret til filen eksporteret_certifikat.cer. Åbn en stifinder, og naviger hen til LUDUS Web-installationsmappen, og herefter til undermappen keys. Her bør certifikat-filen ligge. Dobbeltklik på filen, og skærmbilledet i figur 2 vises. I den øverste blå boks står nogle tal. I den nederste under Issued to: bør der stå URLen til jeres LUDUS Web-server, fx www.ludus.skole.dk. Figur 2 Hvis man vælger fanebladet Certification Path, så vises skærmbilledet i figur 3. Som nederste certifikat (i den blå boks) bør igen stå jeres URL til LUDUS Web-serveren. CSC Scandihealth A/S Side 6 af 9
Figur 3 Certifikatfilen kan herefter sendes til SU-styrelsen til installation i US2000s server, hvorefter LUDUS Web er klar til at kommunikere med US2000. Bemærk: SU-styrelsen har problemer med at modtage filer med endelsen.cer, så lav en kopi af certifikat-filen eksporteret_certifikat.cer og omdøb denne til eksporteret_certifikat.txt. Den omdøbte fil med endelsen.txt kan nu vedhæftes til mailen til SU-styrelsen. CSC Scandihealth A/S Side 7 af 9
5. Test af forbindelse til US2000 Når SU-styrelsen har meldt positivt tilbage, at jeres certifikat er installeret i US2000, er der i princippet gjort klar til, at I kan begynde at benytte LUDUS Web til at indberette uddannelsesdata til US2000. Forbindelsen kan nu testes i LUDUS Web. Dette gøres i skærmbilledet i figur 4: Figur 4 1. Først indtastes brugernavn og password, som er leveret af SU-styrelsen. 2. Tryk på Gem-knappen. 3. Nu kan forbindelsen testes via knappen Test forbindelse til US2000. Der bør herefter fremkomme dialogen, som vist i figur 5. Figur 5 Forbindelsen til US2000 skulle nu virke korrekt. CSC Scandihealth A/S Side 8 af 9
5.1 Ved problemer med at teste forbindelsen Hvis der ikke kan skabes korrekt forbindelse, og skærmbilledet i figur 6 vises, undersøg herefter om: 1. Certifikatet er korrekt eksporteret og indsendt til SU-styrelsen. 2. I har modtaget positiv tilbagemelding fra SU-styrelsen, om at de har modtaget certifikatet og installeret det i US2000. 3. URL til US2000s Webservice er korrekt indtastet. 4. Brugernavn er korrekt indtastet. 5. Password er korrekt indtastet. 6. Indstillingerne er gemt (tryk på Gem-knappen). Figur 6 Hvis alle ovenstående punkter er undersøgt, og ser ud til at være korrekte, forsøg da at teste forbindelsen igen. Hvis der stadig ikke kan skabes forbindelse, kontakt da SU-styrelsen. CSC Scandihealth A/S Side 9 af 9