...

Introduktion

Underskriftstjänsten - Webb och API tillhandahåller funktioner för säker och standardiserad elektronisk underskrift i enlighet med Digitaliseringsmyndighetens (DIGGs) Tekniskt ramverk för Sweden connect.
Tjänsten  stödjer undertecknande med SITHS e-legitimation  antingen med SITHS-kort i dator eller mobilt med Mobilt SITHS. Tjänsten stödjer även undertecknande med flertalet av DIGG godkända e-legitimationer. För en komplett lista av e-legitimationer, se www.inera.se/underskriftstjansten

Denna guide har som syfte att stötta organisationer som avser att ansluta till antingen Underskriftstjänsten - API eller Underskriftstjänsten - Webb. Guiden innehåller teknisk information om hur man fyller i förstudien för denna typ av anslutningar. För mera information om tjänsten  se huvudsidan för Underskriftstjänsten för en översiktlig beskrivning av tjänsten. För olika anslutningsmönster, se Olika integrationsmönster för Underskriftstjänsten. Om du avser att nyttja Underskriftstjänsten - Bas, använd Anslutningsguide till Underskriftstjänst - Bas

Teknisk översikt

Underskriftstjänsten - Webb

Underskriftstjänsten - Webb levereras som ett webbgränssnitt, utan krav på eller möjlighet att göra några externa integrationer.

...

Validering av dokumentet sker i samband med signering och dokumenteras i en valideringsrapport av tjänsten som en del av utförd signering.

Tekniska förutsättningar

Underskriftstjänsten - Webb

Alla Administratörer måste ha SITHS e-legitimation och SITHS eID-klienter (appar) på Windows eller Mobiltelefon.

...

Signatärer och administratörer notiferas om signeringsuppdragen via email, avsändaren är noreply@inera.se.

Underskriftstjänsten - API

Verksamhetssystem som vill integrera med och anropa Underskriftstjänsten API måste anropa Underskriftstjänsten API med dubbelriktad TLS/Mutual TLS (mTLS). Detta kräver att verksamhetssystemet anropar Underskriftstjänsten API med ett SITHS funktionscertifikat (klientcertifikat) utgivet av SITHS. 

...

Observera att verksamhetssystemet ges fulla rättigheter för den aktör (organisationsnummer) som anges i den tekniska anslutningen. Verksamhetssystemet  måste därför ha en egen behörighetsmodell som styr åtkomsten till specifika signeringsuppdrag.

 Teknisk anslutning

Underskriftstjänsten - Webb

Följande information inkluderas vid den Tekniska anslutningen till Underskriftstjänsten  i en förstudie:

...

Efter godkänd förstudie får din organisation tillgång till Underskriftstjänsten - Webb. Se Handboken för hur webbgränssnittet fungerar.

Underskriftstjänsten - API - Klientcertifikat

Följande information inkluderas vid den Tekniska anslutningen till Underskriftstjänsten  i en förstudie:

...

Den publika nyckeln hämtas ut från klientcertifikatet (funktionscertifikatet) och skickas in samtidigt med förstudien. Certifikatsinformation skall vara exporteras i X.509 format och sparat i PEM Base64 format (Privacy Enhanced Mail)  med en filändelse av .pem eller .crt. Kontrollera att innehållet i den exporterade filen startar med "BEGIN CERTIFICATE".

Miljö

Underskriftstjänsten - Webb  och API 

Underskriftstjänsten är driftsatt i tre publika miljöer kopplade mot motsvarande IdP-miljöer och centrala underskriftstjänster.

...

² "*" ersätts med specifikt nummer för vald Idp ex. BankID samma enhet, BankID annan enhet etc.

Checklista

Underskriftstjänsten - Webb 

• Är organisationens juridiska ansvar analyserat, utifrån den tänkta lösningen?
• Är det klart hur användardialoger och arbetsflöden i verksamhetssystemen ska se ut vid förberedelse av dokument för elektronisk underskrift?
• Är det beslutat hur arkivering av underskrivna dokument skall gå till?
• Är SITHS eID-klienter distribuerade till användarna, eller finns det en plan för distribution?
• Om du har krav på att signaturen ska innehålla organisationsnummer, läs denna artikel först.

Underskriftstjänsten - API

• Har varje verksamhetssystem som skall integrera till Underskriftstjänstens API ett eget SITHS funktionscertifikat?
• Har verksamhetssystemet infört en egen behörighetsmodell som styr åtkomsten till specifika signeringsuppdrag?
• Är den publika nyckeln från klientcertifikatet (funktionscertifikatet) exporterat enligt PEM formatet?

...