Samtliga paket nedan stödjer följande funktioner i själva SITHS eID-appen:

• Legitimering och underskrift med fristående underskriftstjänst med hjälp av autentiseringslösningen out-of-band i SITHS eID-appen
• Upplåsning med puk-kod i SITHS eID-appen
• Upplåsning med Mobilt SITHS eller vid fysiskt möte med id-administratör i SITHS eID-appen (endast kort utgivna från SITHS eID Portal)

Certifikatinläsning för MD-paketering

För optimal hantering av autentiseringslösningar baserade på Dubbelriktad TLS/Mutual TLS (mTLS) ska Microsofts egen certifikatpropageringstjänst stängas av. OM den inte stängs av kan användare uppleva problem med att tidigare användares certifikat dyker upp som valbara på datorer som delas med andra användare. Dessa certifikat kan dock inte användas även om de kan väljas eftersom det privata nyckelmaterialet ligger på ett SITHS-kort som inte finns kvar i en kortläsare ansluten till datorn. Orsaken är att Windows egen tjänst bara lägger till certifikat, men inte har någon logik för att raderas dem när kortet avlägssnas från kortläsaren.

Avstängning av denna tjänst görs med fördel med hjälp av Microsoft grupp principer (GPO). 

Grupp-principen hittas här: Computer Configuration\Administrative templates\Windows Components\Smartcard

Följande inställningar ska inaktiveras:

• Activate certificate propagation from smartcard
• Activate root certificate propagation from smartcard

Även Microsofttjänsten CertPropSvc inaktiveras

Installationsparameterar

Installationspaketet för appen levereras endast som en .exe fil. Detta beror på att att denna installation i sin tur består av ett antal MSI-paket från Ineras olika leverantörer. Installationspaketet stödjer ett antal flaggor som kan användas om installationen ska köras via en kommandotolk eller som en oövervakad installation. 

OBS. I programmet som används för att göra installationspaketen finns för närvarande en bug. Den gör att man INTE kan skriva /? för att få fram hjälpen, tex

C:\Temp\siths\SITHS_eID_for_Windows-MD-ENV-Setup-2.2.9121.18428 /?

Tillgängliga parametrar

Oövervakad/Tyst installation

Kan genomföras genom installationsflaggorna /quiet eller /passive

Använd alltid installationsflaggan /norestart för att undvika oönskad omstart av datorn.

Notera att felmeddelanden inte visas vid tyst installation. Det är rekommenderat att använda /log för att se information vid installationsfel. 

Tex.

C:\Temp\siths\SITHS_eID_for_Windows-MD-ENV-Setup-2.2.9121.18428 /quiet /norestart /log C:\Temp\siths\logs\quiet\install.log

Installera tillit till Thales kodsigneringscertifikat

För att kunna genomföra en oövervakad installation av behöver Thales kodsigneringscertifikat vara betrott på de datorer där SITHS eID i MD-paketering ska installeras. Thales kodsigneringscertifikat publiceras som en del av releasen och återfinns.

OBS! Säkerställ att installation av tillit sker i datorns certifikatslagring och INTE i användarens certifikatlagring. Certifikatet behöver installeras i datorns certifikatlagring under "Betrodda utgivare/Trusted publishers".

Här kan du Ladda ner Thales kodsigneringscertifikat

Tillit till dessa certifikat kan med fördel installeras med Microsoft grupp principer (GPO).

Firefox

Vid tyst installation på klientdatorer med webbläsaren Firefox får man två olika beteenden för Autentiseringslösningar baserade på mTLS beroende på om webbläsaren är öppen när den tysta installationen körs:

• Firefox öppen:
  • certifikatval hanteras av Firefox.
  • pin-dialog hanteras av Windows. 
• Firefox stängd
  • certifikatval hanteras av Firefox.
  • pin-dialog hanteras av Firefox.

Dessa olika beteenden beror på att SAC PKCS#11 inte kan installeras om Firefox är öppen när den tysta installationen körs.

Avinstallation

Vid tyst avinstallation gäller det att tänka på att användarens dator måste startas om innan appen installeras på nytt.

Detta beror på att avinstallationen tar bort viktiga filer från datorn vid nästa omstart. Har man då redan installerat appen på nytt kommer viktiga filer att tas bort vid omstart och göra att appen inte kommer gå att använda.

Aktivera "PIN-SSO"

Vid installation kommer användarens pin-kod för legitimering att "cachas" av SAC minidriver för att användaren inte ska behöva ange sin pin-kod upprepade gånger.

Följande konfiguration i Windowsregistret styr denna timeout och är som standard konfigurerad till att PIN-SSO är Aktiv:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\SafeNet\Authentication\SAC\GENERAL

DWORD: SingleLogon value=2

PIN-SSO nollställs automatiskt när:

• Den timeout som kan definieras enligt rubriken nedan uppnås, se Hantera timeout för SSO
• Datorn startas om
• När användaren drar ut sitt SITHS-kort ur kortläsaren

För att stänga av detta beteende justeras registervärdet enligt nedan

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\SafeNet\Authentication\SAC\GENERAL

DWORD: SingleLogon value=0 (SSO AVSTÄNGD)

Möjliga värden för denna inställning är:

• 0 - SAC begär pin när det behövs
• 1 - SAC använder PIN-SSO för applikationer som använder Microsoft CAPI/CAPI2
• 2 - SAC använder PIN-SSO för applikationer som använder Microsoft CAPI/CAPI2 och PKCS#11

Hantera timeout för PIN-SSO 

Vid installation kommer cachningen av användarens pin-kod att upphöra efter en given tid

Följande konfiguration i Windowsregistret styr denna timeout och är som standard konfigurerad till en timeout om 4h:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\SafeNet\Authentication\SAC\GENERAL

DWORD: SingleLogonTimeout value=14400 (timeout i sekunder --> dvs 4h)

För att ändra detta beteende justeras registervärdet enligt nedan:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\SafeNet\Authentication\SAC\GENERAL

DWORD: SingleLogonTimeout value=<ange timeout i sekunder>

Utöver denna timeout nollställs pin-SSO när:

• Datorn startas om
• När användaren drar ut sitt SITHS-kort ur kortläsaren

Aktivera loggning för Dubbelriktad TLS/Mutual TLS (mTLS) - SAC minidriver

1. Töm mappen C:\Windows\Temp\eToken.log på eventuella gamla loggfiler
2. Skapa en registernyckel vid namn Log
3. På följande plats i Windows-registret: HKEY_LOCAL_MACHINE\SOFTWARE\SafeNet\Authentication\SAC
4. Under registernyckeln Log skapas följande registervärden som 32-bitars värde (DWORD)
   1. Enabled = 1
      1. 0 - Loggning avstängd
      2. 1 - Loggning startad
5. Starta om datorn för att börja fånga loggar
6. Återskapa felet
7. Stäng av loggning igen genom att sätta Enabled= 0
8. Starta om datorn
9. Loggfilerna samlas i mappen C:\Windows\Temp\eToken.log på datorn
10. Spara mappen eToken.log som en zip-fil och bifoga den till ärendet
    1. Om filen blir stor kan vi behöva be Thales skapa en länk för uppladdning av filen. Denna kommer då att skickas direkt till den kontaktperson som skapade ärendet hos Inera support.

Övriga registervärden för logginställningar:

1. När loggning aktiverats kommer följande även följande defaultvärden användas.  Dessa kan justeras via egna 32-bitars värden (DWORD), men vi rekommenderar att ni låter dem vara kvar på default.
   1. Days = 1
      1. Antal dagar som loggen skapas
   2. MaxFileSize = 2000000 (2Mb)
      1. Maxstorlek för respektive loggfil i mappen eToken.log
2. Registervärdet TotalMaxSize = 20000000 (20 miljoner = 20Mb) kan skapas för att styra den totala maxstorleken på hela mappen eToken.log. Observera dock att denna inställning kan medföra att äldre loggar som behövs vid felsökning kan komma att skrivas över av nyare loggar.
   1. Maximal filstolek på hela mappen eToken.log

Loggning för Dubbelriktad TLS/Mutual TLS (mTLS) med SAC minidriver i Windows loggbok (event viewer)

1. Skapa värdet EnableLogEvents som ett 32-bitars värde (DWORD)
2. På följande plats i Windows-registret HKEY_LOCAL_MACHINE\SOFTWARE\SafeNet\Authentication\SAC\General
3. Dessa syns sedan i Windows Event Viewer i loggen Application med Source=SAC

För organisationer som inte använder AD-inloggning med SITHS eID på kort

OM ni inte använder AD-inloggning kan denna funktionalitet stängas av via följande registerinställningar

Inaktivera upplåsning med PUK (Lås upp PIN) vid Windows inloggningsskärm

Skapa ett REG_DWORD i underföljande registernyckel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\Credential Providers\{673FACBC-6DF0-425b-B558-48DF53E95EC3}

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\Credential Providers\{673FACBC-6DF0-425b-B558-48DF53E95EC3}
DWORD: Disabled value=1 (Döljer valet att låsa upp ett blockerat kort med PUK-koden. Menyvalet vid namn "Lås upp PIN")

Möjliga värden för denna inställning är:

• 1 = Valet att låsa upp med puk är dolt
• 0 = Valet att låsa upp med puk syns

Inaktivera valet för användaren att logga in med smartkort vid Windows inloggningsskärm

Skapa ett REG_DWORD i underföljande registernyckel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\Credential Providers\{8FD7E19C-3BF7-489B-A72C-846AB3678C96}

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\Credential Providers\{8FD7E19C-3BF7-489B-A72C-846AB3678C96}
DWORD: Disabled value=1 (Döljer valet för smartkort)

Möjliga värden för denna inställning är:

• 1 = Valet att logga in med smartkort är dolt
• 0 = Valet att logga in med smartkort syns

Vid installation av ENV-paketen kan miljöbytesfunktionaliteten inaktiveras och appen styras mot en specifik miljö via Windowsregistret.

För att göra detta behöver:

• Nedan 2st registervärden justeras
• Appen startas om eller refreshas genom tangentbordsknappen F5 efter att värdena har ändrats

Stäng av miljöbyte

Möjliga värden:

• True - Tillåter miljöbyte
• False - Tillåter inte miljöbyte

Exempel för hur man stänger av miljöbytesfunktionaliteten genom att ändra följande strängvärde under HKLM.

HKEY_LOCAL_MACHINE\SOFTWARE\Inera\AuthenticationClient\LocalConfiguration
String: AllowConfigurationChange value=False

Styr standardmiljö

Möjliga värden:

• Test
• QA
• Produktion

Exempel för hur man styr appen att alltid gå mot Produktionsmiljön genom att ändra följande strängvärde under HKLM.

HKEY_LOCAL_MACHINE\SOFTWARE\Inera\AuthenticationClient\LocalConfiguration
String: LocalConfiguration value=Produktion

Problem efter installation och avinstallation av senaste eID-appen

Om du har version 2.2.8824 eller äldre och försöker göra en uppdatering till version 2.3.x. kommer du få detta felmeddelande. Bild nr 2 är vad som kommer visas i loggen.

Felmeddelande vid ej urtaget SITHS-kort

Om du gör en uppgradering och inte har tagit ur ditt SITHS-kort ut kortläsaren kommer du få detta meddelande. Det rekommenderas att du startar om datorn i det här fallet.

Vid tyst installation i kommandotolken kommer inte felmeddelandet att visas. Använd parametern /norestart för att undvika att datorn startar om automatiskt efter uppgradering.

Om du upplever problem efter att ha avinstallerat och sedan installerat den senaste versionen av vår eID-app, vänligen följ dessa steg:

1. Avinstallera eID-appen helt
   • Starta om datorn efter avinstallationen.
   • Rensa gamla inställningar och filer:
     • Kontrollera att det inte finns några nycklar med namnet "SafeNet" i följande registerplatser:
       • HKLM\Software\
       • HKEY_CURRENT_USER\Software\
       • HKLM\SOFTWARE\POLICIES\
       • HKEY_CURRENT_USER\SOFTWARE\POLICIES\
     • Kontrollera att följande filer inte finns kvar i C:\Windows\System32\ och C:\Windows\SysWOW64\:
       • SACSISMD.dll
       • SACSISP15.dll
       • SafenetMD.dll
       • SafenetMD_x64.dll
       • axaltocm.dll
       • axaltocm_x64.dll
       • IDPrimePKCS11.dll
       • eTPKCS11.dll
       • eToken.dll
       • eTokenMD.dll
       • eTCoreInst.dll
       • SNSCKSP.dll
       • eTCAPI.dll
     • Kontrollera att mappen "SafeNet" inte finns kvar under C:\Program Files\.
2. Installera den senaste versionen av eID-appen
   • Starta om datorn efter installationen.
3. Verifiera funktionaliteten

• • Testa SITHS eID-appen via vår testsida: https://test.idp.inera.se/

Problem mTLS autentisering efter avinstallation av Net iD

Det är viktigt att säkerställa att Net iD är helt avinstallerat och att alla tillhörande registernycklar har tagits bort.

Följ stegen nedan för att verifiera detta:

1. Kontrollera att Net iD är avinstallerat.
2. Granska registret och säkerställ att inga Net iD-mappar eller nycklar finns kvar under följande sökväg:
   • Dator\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\Calais\SmartCards
3. Viktigt: Radera endast mappar som börjar med "Net iD".

Exempel på nycklar som kan finnas och bör raderas:

📒 ABC Net iD - IDPrime 940 0
📒 ABC Net iD - IDPrime 940 1
📒 ABC Net iD - IDPrime 940 SIS 0
📒 ABC Net iD - IDPrime 940 SIS 1
📒 Net iD - IDPrime 940 SIS 2

Starta om datorn när detta är kontrollerat.