Skip to content

Certifikathantering ​

Certifikat nyttjas för att säkra upp anslutningar mellan klient och server eller mellan två servrar och möjliggör validering av identiteten av motparten.

I en standardinstallation där Microsoft IIS nyttjas som webbserver nyttjar IIS Microsoft Windows Certificate Store som källa för HTTPS-certifikat.

flexiteCLIENT och flexiteProcessEngine nyttjar Microsoft Windows Certificate Store för att verifiera certifikat medan flexiteWEB och flexiteAdmin nyttjar Javas keystore belägen i Tomcat-paketet.

I det fall systemet ansluter till exempelvis en e-postserver över krypterat protokoll så måste rotcertifikatet för den Certificate Authority som utfärdat det certifikat som e-postservern nyttjar finnas installerat i både Windows Certificate Store och Javas keystore.

Certifikat för flexiteCLIENT och flexiteProcessEngine ​

flexiteCLIENT har behov av att verifiera certifikat vid krypterad kommunikation med exempelvis databasserver och SMTP-server.

flexiteProcessEngine har behov av att verifiera certifikat vid krypterad kommunikation med exempelvis databasserver, SMTP-server samt integrationer med externa system.

Både flexiteCLIENT och flexiteProcessEngine nyttjar Microsoft Windows Certificate Store (Local Computer) för att verifiera dessa certifikat.

För certifikat utfärdade av stora publika aktörer innebär detta sällan någon extra administration eftersom rotcertifikat för dessa utfärdare tillhandahålls och uppdateras av Microsoft. Uppdatering av dessa certifikat hanteras som standard utav Windows Update.

För certifikat utfärdade av en privat Certificate Authority (CA) kan certifikatet eller certifikatkedjan för denna CA behöva importeras manuellt i Trusted Root Certification Authorities i Windows Certificate Store för Local Computer.

Importera CA-certifikat i Windows Certificate Store ​

För information om installation av rotcertifikat, se dokumentation från Microsoft:

https://learn.microsoft.com/en-us/windows-hardware/drivers/install/trusted-root-certification-authorities-certificate-store

Certifikat för flexiteWEB och flexiteAdmin ​

flexiteWEB och flexiteAdmin har behov av att verifiera certifikat vid krypterad kommunikation med exempelvis databasserver, SMTP-server samt LDAP-server.

flexiteWEB och flexiteAdmin nyttjar Javas keystore cacerts, belägen i Tomcat-paketet, för att verifiera certifikat som nyttjas av extern server för att kryptera anslutningar. Sökvägen för denna keystore ser ut på följande vis i en standardinstallation:

C:\tomcat\jdk\lib\security\cacerts

I likhet med Windows Certificate Store innehåller denna Java keystore som standard certifikat för de stora publika aktörerna, varpå ett publikt utfärdat certifikat sällan kräver någon extra administration. Till skillnad från Windows Certificate Store, som uppdateras via Windows Update, uppdateras dessa Java keystores enbart manuellt vid uppdatering/installation av ny Java.

För certifikat utfärdade av en privat Certificate Authority (CA) måste certifikatet, alternativt certifikatkedjan, för denna CA manuellt importeras i Javas keystore.

Undantag ​

Certifikat för Identity Provider för SAML installeras i en separat keystore. För information om SAML, se kapitel Single Sign-On — SAML.

Importera CA-certifikat i Java keystore ​

För att importera certifikat i Java keystore använder vi oss av verktyget keytool som levereras med JDK. Information om detta verktyg finns att läsa hos Oracle:

https://docs.oracle.com/en/java/javase/11/tools/keytool.html

Bra att veta

I CMD och Powershell nyttjas mellanslag som ett skiljetecken mellan kommandon. Filer och sökvägar som innehåller mellanslag måste därmed inneslutas i citationstecken.

Visa befintliga certifikat ​

Det är möjligt att exportera information om befintliga certifikat i aktuell Java keystore.

  1. Öppna en kommandotolk och navigera till C:\tomcat\jdk\bin.

  2. Kör följande kommando:

    cmd
    keytool.exe -list -v -cacerts -storepass changeit > cacerts.txt

    Detta exporterar detaljerad information om samtliga certifikat i installerad Java keystore cacerts till den lokala filen cacerts.txt.

    • list — Kommando för att visa information om innehåll i angiven keystore.
    • v — Tilläggskommando till list för att visa detaljerad information.
    • cacerts — Alias för aktuell, installerad, Java keystore cacerts.
    • storepass {lösenord} — Lösenordet för aktuell keystore. Standard för keystore cacerts är changeit.
    • > {filnamn} — CMD-kommando för att ange att resultatet av föregående kommando ska skrivas till fil istället för konsol. Filnamn anges med fullständig sökväg. I detta exempel har vi valt att skriva till en fil i den lokala katalogen; cacerts.txt.
Exempel ​

Exempel på information som visas för varje certifikat med keytool.exe -list -v:

Alias name: certificate_name
Creation date: 14 maj 2024
Entry type: trustedCertEntry
Owner: CN=ca.company.com
Issuer: CN=ca.company.com
Serial number: 0123456789abcdef
Valid from: Tue Apr 04 02:00:00 CEST 2023 until: Mon Apr 04 02:00:00 CEST 2033
Certificate fingerprints:
         SHA1: 00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33
         SHA256: 00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF
Signature algorithm name: SHA256withRSA
Subject Public Key Algorithm: 2048-bit RSA key
Version: 3

Importera certifikat ​

  1. Erhåll rotcertifikat, alternativt certifikatkedja, från Certificate Authority.

  2. Öppna en kommandotolk och navigera till C:\tomcat\jdk\bin.

  3. För att importera ett certifikat till aktuell Java keystore cacerts, kör följande kommando:

    cmd
    keytool.exe -importcert -cacerts -storepass changeit -alias flexite_MyCACert -file "C:\temp\mycacert.cer"
    • importcert — Kommando för att importera certifikat i angiven keystore.
    • cacerts — Alias för aktuell, installerad, Java keystore cacerts.
    • storepass {lösenord} — Lösenordet för aktuell keystore.
      Standard för keystore cacerts är changeit.
    • alias {namn} — Unikt namn som representerar certifikatet. Används för att identifiera certifikatet i keystore. I detta exempel: flexite_MyCACert
      Det är rekommenderat att följa samma namngivningsschema för samtliga certifikat som importeras för att underlätta framtida administration. Exempelvis flexite_smtp, flexite_sql.
    • file {sökväg} — Fullständig sökväg till det certifikat som ska importeras. I detta exempel: C:\temp\mycacert.cer
  4. För att verifiera att ett certifikat importerats, kör följande kommando:

    cmd
    keytool.exe -list -v -cacerts -storepass changeit -alias flexite_MyCACert

    Detta skriver ut detaljerad information om certifikatet med angivet alias till konsolen.

    • list — Kommando för att visa information om innehåll i angiven keystore.
    • v — Tilläggskommando till list för att visa detaljerad information.
    • cacerts — Alias för aktuell, installerad, Java keystore cacerts.
    • storepass {lösenord} — Lösenordet för aktuell keystore.
      Standard för keystore cacerts är changeit.
    • alias {namn} — Det alias som angavs för certifikatet vid import. I detta exempel: flexite_MyCACert

Certifikat för flexitePortal ​

flexitePortal har behov av att verifiera certifikat vid krypterad kommunikation med flexiteWEB.

flexitePortal nyttjar, i likhet med flexiteWEB och flexiteAdmin, Javas keystore cacerts, belägen i Tomcat-paketet, för att verifiera certifikat som nyttjas av extern server för att kryptera anslutningar. Sökvägen för denna keystore ser ut på följande vis i en standardinstallation:

C:\tomcat\jdk\lib\security\cacerts

För information om hantering av certifikat i cacerts, se Certifikat för flexiteWEB och flexiteAdmin.

Undantag ​

Certifikat för Identity Provider för SAML installeras i en separat keystore. För information om SAML, se kapitel Single Sign-On — SAML.

Uppgradering av Apache Tomcat/Java ​

Java keystore är inkluderat i installationspaketet för Apache Tomcat och Java och ersätts därmed som standard vid uppgradering. Eventuella certifikat som installerats manuellt måste därmed vid uppgradering importeras i den nya Java keystore. Det är således kritiskt att vid uppgradering av Java alltid kontrollera förekomsten av manuellt installerade certifikat i keystore cacerts innan uppgradering genomförs.

Det är även tekniskt möjligt att ersätta den nya Java keystore med den gamla efter uppgradering, men detta är inte rekommenderat då det medför en risk att standardcertifikat inte erhåller nödvändiga uppdateringar.

Exportera certifikat från befintlig Java keystore ​

I det fall de certifikat som är installerade i Java keystore inte finns tillgängliga från annan källa kan de exporteras från befintlig keystore.

För att exportera korrekt certifikat är det kritiskt att veta vilka alias som tilldelats certifikaten när de importerats.

Identifiera manuellt installerade certifikat ​

Känd namngivning ​

I det fall ett särskilt namngivningsschema följts är det möjligt att nyttja CMD-kommandot findstr för att filtrera innehållet i en keystore och enbart lista de certifikat vars alias innehåller en specifik fras:

cmd
keytool.exe -list -cacerts -storepass changeit | findstr {sökfras}
  • list — Kommando för att visa information om innehåll i angiven keystore.
  • cacerts — Alias för aktuell, installerad, Java keystore cacerts.
  • storepass {lösenord} — Lösenordet för aktuell keystore.
    Standard för keystore cacerts är changeit.
  • | findstr {sökfras} — CMD-kommando för att ange att från resultatet av föregående kommando ska enbart rader som innehåller angiven sökfras visas.
Exempel ​

I detta exempel har vi filtrerat innehållet i vår installerade cacerts keystore på frasen flexite vilket resulterat i två sökträffar med alias flexite_smtp respektive flexite_sql.

keytool.exe -list -cacerts -storepass changeit | findstr flexite
flexite_smtp, 1 juni 2023, trustedCertEntry,
flexite_sql, 1 juni 2023, trustedCertEntry,

Den information som visas för varje certifikat är:

  • Alias name — Certifikatets alias i Java keystore.
  • Creation date — Datum då certifikatet importerades i Java keystore.
  • Entry type — Anger typ av objekt. För betrodda certifikat är typen trustedCertEntry.
Okänd namngivning ​

Om namngivningen av alias för importerade certifikat är okänd är det möjligt att utesluta ordinarie inkluderade certifikat genom att manuellt jämföra befintlig, installerad, keystore med den som levererades i installationspaketet för befintlig version.

Standard Java keystore ​

Export av en komprimerad lista över samtliga certifikat i installerad Java keystore cacerts kan utföras med följande kommando:

cmd
keytool.exe -list -cacerts -storepass changeit > cacerts.txt

Detta exporterar kortfattad information om samtliga certifikat i installerad Java keystore cacerts till den lokala filen cacerts.txt.

  • list — Kommando för att visa information om certifikat från angiven keystore.
  • cacerts — Alias för aktuell, installerad, Java keystore cacerts.
  • storepass {lösenord} — Lösenordet för aktuell keystore.
    Standard för keystore cacerts är changeit.
  • > {filnamn} — CMD-kommando för att ange att resultatet av föregående kommando ska skrivas till fil istället för konsol. Filnamn anges med fullständig sökväg. I detta exempel har vi valt att skriva till en fil i den lokala katalogen; cacerts.txt.
Manuellt angiven Java keystore ​

Export av en komprimerad lista över samtliga certifikat i en manuellt angiven Java keystore till en lokal fil kan utföras med följande kommando:

cmd
keytool.exe -list -keystore "C:\temp\tomcat\jdk\lib\security\cacerts" -storepass changeit > cacerts.txt

Detta exporterar kortfattad information om samtliga certifikat i en manuellt angiven Java keystore till den lokala filen cacerts.txt.

  • list — Kommando för att visa information om innehåll i angiven keystore.
  • keystore — Fullständig sökväg till Java keystore. I detta exempel: C:\temp\tomcat\jdk\lib\security\cacerts
  • storepass {lösenord} — Lösenordet för aktuell keystore.
    Standard för keystore cacerts är changeit.
  • > {filnamn} — CMD-kommando för att ange att resultatet av föregående kommando ska skrivas till fil istället för konsol. Filnamn anges med fullständig sökväg. I detta exempel har vi valt att skriva till en fil i den lokala katalogen; cacerts.txt.

Exportera certifikat ​

Med certifikatens alias identifierade är det möjligt att exportera certifikaten till fil i förberedelse för import i den nya Java keystore.

För att exportera ett certifikat från Java keystore cacerts, kör följande kommando:

cmd
keytool.exe -exportcert -cacerts -storepass changeit -alias flexite_MyCACert -file "C:\temp\mycacert.cer"
  • exportcert — Kommando för att exportera angivna certifikat från angiven keystore.
  • cacerts — Alias för aktuell, installerad, Java keystore cacerts.
  • storepass {lösenord} — Lösenordet för aktuell keystore.
    Standard för keystore cacerts är changeit.
  • alias {namn} — Det alias som är angivet för certifikatet som ska exporteras. I detta exempel: flexite_MyCACert.
  • file {sökväg} — Fullständig sökväg till den fil dit certifikatet ska exporteras. I detta exempel: C:\temp\mycacert.cer.

Importera certifikat ​

Med certifikaten exporterade från befintlig Java keystore är det dags att importera dem i den nya Java keystore. För information om import av certifikat, se avsnitt Importera CA-certifikat i Java keystore.

Migrering ​

Vid migrering av en flexite-installation från en server till en annan måste även eventuella manuellt installerade certifikat migreras. Det är således kritiskt att vid migrering alltid kontrollera förekomsten av manuellt installerade certifikat innan migrering genomförs.

Certifikat för flexiteCLIENT och flexiteProcessEngine ​

I det fall de certifikat som är manuellt installerade i Windows Certificate Store inte finns tillgängliga från annan källa kan de exporteras från befintlig certificate store.

Certifikat som nyttjas av flexite, och Microsoft IIS, för att identifiera lokal server återfinns som standard under Personal i Windows Certificate Store för Local Computer.

Certifikat som nyttjas för att verifiera certifikat hos en fjärrserver återfinns som standard under Trusted Root Certification Authorities i Windows Certificate Store för Local Computer.

Certifikat för flexiteWEB och flexiteAdmin ​

I det fall samma version av Apache Tomcat och Java ska köras på den nya servern är det rekommenderade förfarandet att kopiera befintlig Java keystore cacerts från den gamla servern till den nya.

Sökväg för Java keystore cacerts i en standardinstallation är: C:\tomcat\jdk\lib\security\cacerts.

I det fall en uppgradering av Apache Tomcat och Java utförs i samband med migrering är förfarandet detsamma som vid en normal uppgradering; Uppgradering av Apache Tomcat/Java.