Mina meddelanden Förmedling av elektronisk post för myndigheter i Sverige Teknisk översikt för myndigheter och förmedlare Version 1.2 Mina meddelanden är en myndighetsgemensam e-posttjänst förvaltad av Skatteverket och utvecklad tillsammans med Bolagsverket och Tillväxtverket.
Innehållsförteckning 1 INLEDNING... 1 2 MINA MEDDELANDEN... 1 3 ROLLER OCH AKTÖRER... 2 3.1 AVSÄNDARANSVAR... 2 3.2 ANSLUTET OFFENTLIGT ORGAN... 3 3.3 FÖRMEDLARE... 3 3.4 FAR-ANSVARIG... 3 3.5 BREVLÅDEOPERATÖR... 4 4 SEKVENSDIAGRAM... 4 4.1 SKAPA OCH LÄMNA IN SÄKER FÖRSÄNDELSE... 4 4.2 SKAPA OCH LÄMNA IN ENKEL FÖRSÄNDELSE... 5 4.3 FÖRMEDLA SÄKER FÖRSÄNDELSE... 6 4.4 FÖRMEDLA ENKEL FÖRSÄNDELSE... 7 5 DOKUMENTINFORMATION... 7 Figurförteckning FIGUR 1. MINA MEDDELANDEN... 1 FIGUR 2. AKTÖRER I MINA MEDDELANDEN... 2 FIGUR 3. SEKVENSDIAGRAM SKAPA OCH LÄMNA IN SÄKER FÖRSÄNDELSE... 4 FIGUR 4. SEKVENSDIAGRAM SKAPA OCH LÄMNA IN ENKEL FÖRSÄNDELSE... 5 FIGUR 5. SEKVENSDIAGRAM FÖRMEDLA SÄKER FÖRSÄNDELSE... 6 FIGUR 6. SEKVENSDIAGRAM FÖRMEDLA ENKEL FÖRSÄNDELSE... 7
Mina meddelanden Version: 1.2 Sida 1 av 7 1 Inledning Här kan du ta del av hur lösningen för Mina meddelanden hänger samman ur en anslutande myndighets och förmedlares perspektiv och vad de olika rollerna och systemen syftar till och gör. Du kommer att få en översikt av de tjänster och operationer de olika rollerna har implementerat eller kan behöva implementera. De är specificerade i dokumentet Tekniska tjänstekontrakt API. 2 Mina meddelanden Mina meddelanden syftar till att låta anslutna myndigheter skicka post elektroniskt istället för traditionellt på papper till privatpersoner och företag. De roller som verkar i Mina meddelanden är: anslutet offentligt organ, förmedlare, brevlådeoperatör, FaRansvarig och brevlådeinnehavare, se Figur 1. Figur 1. Mina meddelanden Det anslutna offentliga organet är avsändare av försändelser och kan välja att agera förmedlare av försändelser själv eller låta en privat aktör agera förmedlare. En förmedlare kan t.ex. vara ett IT-tjänsteföretag som förmedlar e-tjänster på uppdrag av en myndighet. Förmedlingsadressregistret, FaR, är ett register som sköts av FaR-ansvarig, idag Skatteverket. Registret lagrar de som har ett Mina meddelanden konto och information om hos vilken brevlådeoperatör brevlådeinnehavaren har sin säkra elektroniska brevlåda. Brevlådeoperatören tillhandahåller den elektroniska säkra brevlådan, som du får när du skapar ett Mina meddelanden konto. Skatteverket agerar just nu som enda brevlådeoperatör. Snart kommer det att finnas fler brevlådeoperatörer att välja bland. Brevlådeinnehavaren kan vara en privatperson eller ett företag. Privatpersonen eller företagsrepresentanten måste ha e-legitimation för att skaffa ett Mina meddelanden konto med tillhörande säker elektronisk brevlåda. Säker inloggning används senare för att kunna logga in och för att kunna läsa de säkra elektroniska meddelandena. En säker försändelse kan innehålla känsliga uppgifter eller bilagor och skickas till brevlådeinnehavarens säkra elektroniska brevlåda. En enkel försändelse innehåller icke sekretessbelagda uppgifter och skickas till de kontaktuppgifter brevlådeinnehavaren har angett. Kontaktuppgifterna lagras hos brevlådeoperatören.
Mina meddelanden Version: 1.2 Sida 2 av 7 3 Roller och aktörer I Figur 2 visas de tjänster som förmedlare, FaR-ansvarig och brevlådeoperatör har implementerat eller kan behöva implementera, samt vilka tjänster som anropas av vem. Namnen på tjänsterna framgår i de turkosa rutorna, medan de vita rutorna listar vad de olika rollerna gör utifrån en anslutande myndighets och förmedlares perspektiv. Figur 2. Aktörer i Mina meddelanden 3.1 Avsändaransvar Det anslutna offentliga organet är avsändare av försändelser och kan välja att agera förmedlare av försändelser själv eller låta en privat aktör agera förmedlare, den privata aktören agerar då under det anslutna offentliga organets ansvar. Väljer det anslutna offentliga organet en lösning där det anslutna offentliga organet skickar en printfil till förmedlaren, behöver förmedlaren både signera och försegla de säkra försändelserna, då brevlådeoperatören endast accepterar förseglade försändelser. I avsändaransvaret ingår att skapa enkla och säkra försändelser signera och försegla säkra försändelser, då brevlådeoperatören endast accepterar förseglade försändelser kontrollera tillgänglighet, mottagningsregler och brevlådeuppgifter hos FaR; om det finns ett registrerat Mina meddelanden konto, om mottagaren accepterar elektroniska utskick från den avsändande myndigheten och till vilken brevlådeoperatör försändelsen ska förmedlas förmedla enkla och säkra försändelser till brevlådeoperatör och mottagare Rollerna anslutet offentligt organ och förmedlare är beskrivna utifrån Skatteverkets lösning. Gränssnittet mellan anslutet offentligt organ och förmedlare kan variera beroende på hur det anslutna offentliga organet väljer att implementera sin lösning.
Mina meddelanden Version: 1.2 Sida 3 av 7 3.2 Anslutet offentligt organ Det anslutna offentliga organet skapar försändelsen, signerar försändelsen om det är en säker försändelse och lämnar in den till förmedlaren, efter att ha kontrollerat i FaR att mottagaren har ett Mina meddelanden konto samt accepterar att ta emot elektronisk post från den avsändande myndigheten. Kontrollen mot FaR behöver inte göras av det anslutna offentliga organet, utan kan lämnas till förmedlaren att utföra. Det anslutna offentliga organet kontrollerar eventuellt tillgängligheten, mottagningsregler och brevlådeuppgifter; om mottagaren har ett registrerat Mina meddelanden konto, om mottagaren accepterar elektroniska utskick från den avsändande myndigheten och hos vilken brevlådeoperatör mottagaren har sin säkra elektroniska brevlåda skapar enkla och säkra försändelser signerar säkra försändelser lämnar in enkla och säkra försändelser till förmedlaren kontrollerar status av inlämnad försändelse hos förmedlaren; kontrollerar om försändelsen har levererats till mottagaren 3.3 Förmedlare Förmedlaren tar emot försändelser från det anslutna offentliga organet och kontrollerar signering för de säkra försändelserna samt förseglar dem. Därefter förmedlas försändelsen till brevlådeoperatören och brevlådeinnehavaren, och statusinformation sparas kring leveransen. Tjänsterna Message och Notification implementeras av förmedlaren för att hantera säkra respektive enkla elektroniska försändelser. Förmedlaren tar emot enkla och säkra försändelser från det anslutna offentliga organet förseglar säkra försändelser kontrollerar tillgängligheten, mottagningsregler och brevlådeuppgifter: om mottagaren har ett registrerat Mina meddelanden konto, om mottagaren accepterar elektroniska utskick från den avsändande myndigheten och hos vilken brevlådeoperatör mottagaren har sin säkra elektroniska brevlåda förmedlar enkla och säkra försändelser till brevlådeoperatören och mottagaren lagrar status kring om försändelsen har förmedlats till mottagaren 3.4 FaR-ansvarig Förmedlingsadressregistret är ett register som innehåller de privatpersoner och företag som har ett registrerat Mina meddelanden konto samt information om hos vilken brevlådeoperatör brevlådeinnehavaren har sin säkra elektroniska brevlåda. Här lagras även de inställningar en brevlådeinnehavare kan göra för sitt konto. FaR har implementerat tjänsten Recipient vilken anropas av det anslutna offentliga organet och förmedlaren för att kontrollera mottagarens tillgänglighetsinformation, om mottagaren har ett Mina meddelanden konto mottagningsregler, om mottagaren har accepterat elektroniska utskick från den avsändande myndigheten brevlådeuppgifter, hos vilken brevlådeoperatör mottagaren har sin säkra elektroniska brevlåda
Mina meddelanden Version: 1.2 Sida 4 av 7 3.5 Brevlådeoperatör För att kunna ta emot säkra elektroniska meddelanden behöver mottagaren förutom ett Mina meddelanden konto även en säker elektronisk brevlåda hos vald brevlådeoperatör. Brevlådeoperatören implementerar tjänsten Service, som anropas av förmedlaren för att leverera säkra och enkla försändelser till mottagaren. Brevlådeoperatören tar emot enkla och säkra försändelser och levererar dessa till mottagaren aviserar mottagare för säkra försändelser; meddelar mottagaren via e-post eller sms, enligt de kontaktuppgifter mottagaren har angett, att ett säkert meddelande finns i den säkra elektroniska brevlådan 4 Sekvensdiagram Sekvensdiagrammen som följer beskriver de operationer som det anslutna offentliga organet och förmedlaren utför och vilka tjänster de anropar hos respektive system i Mina meddelanden. Tjänsterna och operationerna är specificerade i dokumentet Tekniska tjänstekontrakt API. 4.1 Skapa och lämna in säker försändelse Sekvensdiagrammet, Figur 3, visar hur det anslutna offentliga organet går tillväga för att skapa och lämna in en säker försändelse till förmedlaren. Figur 3. Sekvensdiagram Skapa och lämna in säker försändelse
Mina meddelanden Version: 1.2 Sida 5 av 7 För att kontrollera om mottagaren har ett registrerat Mina meddelanden konto samt accepterar elektroniska utskick från den avsändande myndigheten anropas FaR och tjänsten Recipient med operationen isreachable. Om mottagaren har ett registrerat konto och accepterar elektroniska utskick från den avsändande myndigheten skapas en försändelse innehållande ett eller flera meddelanden och eventuella bilagor. När försändelsen är skapad signeras den av det anslutna offentliga organet. Genom operationen distributesecure, som anropar tjänsten Message hos förmedlaren, lämnar det anslutna offentliga organet in den signerade försändelsen till förmedlaren. Den säkra försändelsens signatur kontrolleras av förmedlaren; att försändelsen är intakt och att det anslutna offentliga organet är den som den utger sig för att vara. Därefter distribuerar förmedlaren försändelsen till brevlådeoperatören och mottagaren. Det är det anslutna offentliga organets ansvar att följa upp att försändelsen har levererats av förmedlaren till mottagarens säkra elektroniska brevlåda. Detta görs genom operationen checkdistributionstatus, som anropar tjänsten Message hos förmedlaren. 4.2 Skapa och lämna in enkel försändelse För att skapa och lämna in en enkel elektronisk försändelse från det anslutna offentliga organet till förmedlaren följs i stort samma steg som för en elektronisk säker försändelse, se sekvensdiagram för enkel försändelse i Figur 4. Figur 4. Sekvensdiagram Skapa och lämna in enkel försändelse Ett undantag är att försändelsen inte behöver signeras av det anslutna offentliga organet innan den lämnas till förmedlaren. Även formatet är annorlunda då en enkel försändelse förmedlas till en vanlig e-post eller till en mobiltelefon i sms-format. Operationen distribute anropar tjänsten Notification hos förmedlaren för att lämna in den enkla elektroniska försändelsen,
Mina meddelanden Version: 1.2 Sida 6 av 7 som vidareförmedlas till brevlådeoperatören och mottagaren. Det anslutna offentliga organet följer upp om försändelsen har förmedlats till mottagaren genom operationen checkdistributionstatus, som anropar tjänsten Notification hos förmedlaren. 4.3 Förmedla säker försändelse Sekvensdiagrammet i Figur 5 visar hur förmedlaren tar emot och förmedlar en säker elektronisk försändelse till brevlådeoperatören. Figur 5. Sekvensdiagram Förmedla säker försändelse Förmedlaren tar emot försändelsen från det anslutna offentliga organet genom operationen distributesecure som anropar tjänsten Message. Därefter kontrollerar förmedlaren att det är en godkänd avsändare hos FaR-ansvarig och den säkra försändelsens signatur; att försändelsen är intakt och att det anslutna offentliga organet är den som den utger sig för att vara. När signeringen är godkänd stämplas och signeras, här kallad förseglas, den och ställs i kö för utdelning. Även förmedlaren, precis som det anslutna offentliga organet, kontrollerar i FaR att mottagaren har ett registrerat Mina meddelanden konto samt har accepterat att ta emot försändelser elektroniskt från den avsändande myndigheten. Detta genom att anropa tjänsten Recipient hos FaR med operationen isreachable. Denna kontroll genomförs en andra gång eftersom mottagaren kan ha hunnit avsluta sitt konto eller uppdatera sina mottagningsregler. Operationen deliversecure anropar tjänsten Service hos brevlådeoperatören där mottagaren har sin säkra elektroniska brevlåda, och förmedlar därigenom försändelsen. Förmedlaren lagrar status kring försändelsens leverans som det anslutna offentliga organet kontrollerar.
Mina meddelanden Version: 1.2 Sida 7 av 7 4.4 Förmedla enkel försändelse För att förmedla en enkel försändelse från förmedlaren till brevlådeoperatören följs i stort samma steg som för en säker försändelse, se sekvensdiagram för enkel försändelse i Figur 6. Figur 6. Sekvensdiagram Förmedla enkel försändelse Förmedlaren tar emot försändelsen från det anslutna offentliga organet genom operationen distribute som anropar tjänsten Notification. Då en enkel försändelse inte har någon signatur behöver den inte kontrolleras. Förmedlaren behöver heller inte försegla försändelsen. Operationen notify anropar tjänsten Service hos brevlådeoperatören för att förmedla den enkla försändelsen till brevlådeoperatören och mottagaren. 5 Dokumentinformation Information till detta dokument har inhämtats från intervjuer med Toni Thomsson, arkitekt i projektet Mina meddelanden på Skatteverket, och dokumentet Tekniska tjänstekontrakt API. Ansvarig för detta dokument är projektet Mina meddelanden på Skatteverket. Versionshistorik följer nedan. Datum Version Beskrivning Signatur 2012-12-11 1.0 Översiktlig teknisk beskrivning av Mina Annika Melin meddelanden, de roller och aktörer som där verkar och sekvensdiagram med beskrivning av tjänster och operationer. Utifrån Skatteverkets lösning Version 3.3. 2013-02-08 1.1 Uppdaterad rollöversikt, nu med Avsändaransvar. Annika Melin 2013-02-19 1.2 Begrepp uppdaterade utifrån Begreppsmodell Version 3.0. Annika Melin