Mina meddelanden Förmedling av elektronisk post för myndigheter i Sverige Teknisk översikt för brevlådeoperatörer 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... 5 4.1 ANSÖKA OM KONTO... 5 4.2 ANMÄLA AVSLUT AV KONTO... 6 4.3 STÄLLA IN MOTTAGNINGSREGLER... 7 4.4 TA EMOT SÄKER FÖRSÄNDELSE... 8 4.5 TA EMOT ENKEL FÖRSÄNDELSE... 9 5 DOKUMENTINFORMATION... 9 Figurförteckning FIGUR 1. MINA MEDDELANDEN... 1 FIGUR 2. AKTÖRER I MINA MEDDELANDEN... 2 FIGUR 3. SEKVENSDIAGRAM ANSÖKA OM KONTO... 5 FIGUR 4. SEKVENSDIAGRAM ANMÄLA AVSLUT AV KONTO... 6 FIGUR 5. SEKVENSDIAGRAM STÄLLA IN MOTTAGNINGSREGLER... 7 FIGUR 6. SEKVENSDIAGRAM TA EMOT SÄKER FÖRSÄNDELSE... 8 FIGUR 7. SEKVENSDIAGRAM TA EMOT ENKEL FÖRSÄNDELSE... 9
Mina meddelanden Version: 1.2 Sida 1 av 9 1 Inledning Här kan du ta del av hur lösningen för Mina meddelanden hänger samman ur en brevlådeoperatörs 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 (den anslutna myndigheten) är avsändare av meddelanden 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 vilka privatpersoner och företag som har ett konto hos Mina meddelanden samt information om hos vilken brevlådeoperatör brevlådeinnehavaren har sin säkra elektroniska brevlåda. Brevlådeoperatören tillhandahåller den säkra elektroniska brevlådan, som användaren får samtidigt som den öppnar ett konto hos Mina meddelanden. 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 öppna ett konto hos Mina meddelanden och en 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. Ett säkert meddelande kan innehålla känsliga uppgifter eller bilagor och skickas till brevlådeinnehavarens säkra elektroniska brevlåda. Ett enkelt meddelande innehåller icke
Mina meddelanden Version: 1.2 Sida 2 av 9 sekretessbelagda uppgifter och skickas till de kontaktuppgifter brevlådeinnehavaren har angett. Kontaktuppgifterna lagras hos brevlådeoperatören. En försändelse består av ett eller flera meddelanden, till en eller flera mottagare. Det anslutna offentliga organet paketerar ett eller flera meddelanden i en försändelse och lämnar in försändelsen till förmedlaren. Brevlådeoperatören tar emot försändelsen och distribuerar meddelandet eller meddelandena till brevlådeinnehavaren eller brevlådeinnehavarna. 3 Roller och aktörer Figur 2. Aktörer i Mina Meddelanden I Figur 2 visas de tjänster som brevlådeoperatör och FaR-ansvarig implementerar, 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 ansvarar för utifrån en brevlådeoperatörs perspektiv. 3.1 Avsändaransvar Det anslutna offentliga organet är avsändare av meddelanden och kan välja att agera förmedlare av försändelser själv eller låta en privat aktör (exempelvis en systemintegratör eller ett IT-tjänsteföretag) agera förmedlare. Den privata aktören agerar då under det anslutna offentliga organets ansvar. 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 förmedla enkla och säkra försändelser till brevlådeoperatören 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 9 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 konto hos Mina meddelanden. Det anslutna offentliga organet 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 3.3 Förmedlare En förmedlare kan vara en systemintegratör eller ett IT-tjänsteföretag som förmedlar e-tjänster på uppdrag av en myndighet. Förmedlaren tar emot försändelser från det anslutna offentliga organet och kontrollerar signering för säkra försändelser samt förseglar dem. Därefter förmedlas försändelsen vidare till brevlådeoperatören och mottagaren, 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 förseglar säkra försändelser förmedlar enkla och säkra försändelser till brevlådeoperatören 3.4 FaR-ansvarig Förmedlingsadressregistret är ett register som innehåller de privatpersoner och företag som har ett registrerat konto hos Mina meddelanden samt information om hos vilken brevlådeoperatör mottagaren har sin säkra elektroniska brevlåda. Här lagras även de inställningar en brevlådeinnehavare kan göra i sitt konto hos Mina meddelanden. Brevlådeoperatören anropar tjänsten Recipient hos FaR-ansvarig för att skapa och avsluta konto i FaR hämta mottagningsregler, om mottagaren har accepterat elektroniska utskick från den avsändande myndigheten Tjänsten Authority är implementerad av FaR-ansvarig och anropas av brevlådeoperatören för att kontrollera behörigheter, vilka konton hos Mina meddelanden en privatperson är behörig till, vilka tillhandahålls av FaR-ansvarig som kontrollerar firmateckningsregler hos Bolagsverket
Mina meddelanden Version: 1.2 Sida 4 av 9 En privatperson kan vara behörig till sitt privata konto hos Mina meddelanden och till ett eller flera konton för företag. Beroende på om privatpersonen hanterar sitt privata konto eller ett konto för företag har privatpersonen olika behörigheter. Som privatperson har man i sitt privata konto behörighet att öppna och avsluta konto ställa in mottagningsregler uppdatera kontaktuppgifter läsa, vidarebefordra och ta bort säkra elektroniska meddelanden i den säkra elektroniska brevlådan Som firmatecknare har man i kontot för företag behörighet att ställa in mottagningsregler uppdatera kontaktuppgifter läsa, vidarebefordra och ta bort säkra elektroniska meddelanden i företagets säkra elektroniska brevlåda men signering enligt firmateckningsreglerna krävs för att skapa och avsluta konto 3.5 Brevlådeoperatör För att kunna öppna ett konto hos Mina meddelanden och ta emot säkra elektroniska meddelanden behöver mottagaren välja brevlådeoperatör. Hos brevlådeoperatören anger brevlådeinnehavaren kontaktuppgifter och kan ställa in mottagningsregler. Brevlådeoperatören implementerar tjänsten Service, som anropas av det anslutna offentliga organet för att leverera säkra och enkla försändelser till mottagaren. Vid mottagande av en säker försändelse kontrolleras förseglingen och levereras till mottagarens säkra elektroniska brevlåda. En avisering skickas till mottagaren om att det finns ett nytt meddelande i den säkra elektroniska brevlådan. Enkla försändelser och aviseringar levereras till mottagaren via e-post eller sms. Brevlådeoperatören hanterar öppnande och avslut av konto hos Mina meddelanden på uppdrag av brevlådeinnehavaren, där konto skapas och avslutas i FaR hanterar mottagningsregler som brevlådeinnahavaren kan ställa in, vilka också lagras i FaR lagrar kontaktuppgifter som brevlådeinnehavaren anger kontrollerar behörighet, när en privatperson (brevlådeanvändare) loggar in och hämtar de konton den inloggade brevlådeanvändaren har behörighet till tar emot enkla och säkra försändelser och levererar dessa till mottagaren kontrollerar mottagarens mottagningsregler; att mottagaren accepterar elektroniska utskick från den avsändande myndigheten kontrollerar försegling av försändelse 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
Mina meddelanden Version: 1.2 Sida 5 av 9 4 Sekvensdiagram Sekvensdiagrammen som följer beskriver de operationer som brevlådeoperatören utför och vilka tjänster den anropar hos respektive system i Mina meddelanden. Tjänsterna och operationerna är specificerade i dokumentet Tekniska tjänstekontrakt API. 4.1 Ansöka om konto Sekvensdiagrammet i Figur 3 visar hur en privatperson eller ett företag hos vald brevlådeoperatör går tillväga för att ansöka om ett konto hos Mina meddelanden och skapa en tillhörande säker elektronisk brevlåda. Figur 3. Sekvensdiagram Ansöka om konto I ett första steg loggar användaren in med e-legitimation hos vald brevlådeoperatör och väljer att ansöka om ett konto hos Mina meddelanden. Om kontoansökan gäller en privatperson skapas en ny kontoansökan av brevlådeoperatören. Därefter begär brevlådeoperatören privatpersonen om en underskrift av kontoansökan. För att registrera den nya kontoansökan i FaR anropas tjänsten Recipient med operationen register. FaR-ansvarig kontrollerar att underskriften är gjord av samma användare som kontot avser. I samband med registreringen godkänner användaren avtalet kring förmedling av elektronisk post. Gäller kontoansökan ett företag kontrollerar brevlådeoperatören om det finns en pågående kontoansökan genom att anropa FaR-ansvarig och tjänsten Recipient med operationen getpendingaccountrequest. Finns en påbörjad kontoansökan hämtas den, annars skapas en ny kontoansökan av brevlådeoperatören. Här begär brevlådeoperatören inloggad firmatecknare om en underskrift av kontoansökan. En påbörjad kontoansökan kan bara finnas för ett företag där fler än en firmatecknare krävs enligt firmateckningsreglerna hos Bolagsverket. För att registrera komplettering av kontoansökan eller den nya kontoansökan i FaR anropas tjänsten Recipient med operationen register. FaR-ansvarig kontrollerar att underskriften är
Mina meddelanden Version: 1.2 Sida 6 av 9 gjord av samma användare som kontot avser samt att underskrifterna motsvarar den firmateckning som krävs. Firmateckningsreglerna kontrolleras mot Bolagsverket. Komplettering av en kontoansökan med fler underskrifter från firmatecknare kan göras vid separata tillfällen. I samband med registreringen godkänner användaren avtalet kring förmedling av elektronisk post. När svaret COMPLETE returneras av operationen register har ett konto hos Mina meddelanden skapats i FaR och brevlådeoperatören skapar och aktiverar den tillhörande säkra elektroniska brevlådan. FaR-ansvarig skickar en kvittens via e-post om att ett konto hos Mina meddelanden har registrerats enligt de kontaktuppgifter som brevlådeinnehavaren har angett i kontoansökan. 4.2 Anmäla avslut av konto För att anmäla avslut av ett konto hos Mina meddelanden följs i stort samma steg som för att ansöka om konto, se sekvensdiagram för avslut av konto i Figur 4. Figur 4. Sekvensdiagram Anmäla avslut av konto I ett första steg loggar brevlådeanvändaren in med e-legitimation och väljer att anmäla avslut av konto. Om kontoavslutet gäller en privatperson skapas ett kontoavslut av brevlådeoperatören. Därefter begär brevlådeoperatören att privatpersonen skriver under sin avanmälan. För att registrera kontoavslutet i FaR anropas tjänsten Recipient med operationen deregister. FaR-ansvarig kontrollerar att underskriften är gjord av samma användare som kontot avser. Gäller kontoavslutet ett företag kontrollerar brevlådeoperatören kontots status genom att anropa FaR-ansvarig och tjänsten Recipient med operationen getpendingaccountrequest. Finns ett påbörjat kontoavslut hämtas det, annars skapas ett kontoavslut av brevlådeoperatören. Här begär brevlådeoperatören att inloggad firmatecknare skriver under avanmälan. Ett påbörjat kontoavslut kan bara finnas för ett företag där fler än en firmatecknare krävs enligt firmateckningsreglerna hos Bolagsverket.
Mina meddelanden Version: 1.2 Sida 7 av 9 För att registrera komplettering av kontoavslut eller kontoavslut i FaR anropas tjänsten Recipient med operationen deregister. FaR-ansvarig kontrollerar att underskriften är gjord av samma användare som kontot avser samt att underskrifterna motsvarar den firmateckning som krävs. Firmateckningsreglerna kontrolleras mot Bolagsverket. Komplettering av kontoavslut med fler underskrifter från firmatecknare kan göras vid separata tillfällen. När svaret COMPLETE returneras av operationen deregister har kontot avslutats i FaR och brevlådeoperatören inaktiverar den tillhörande säkra elektroniska brevlådan. FaR-ansvarig skickar en kvittens via e-post om att kontot har avslutats enligt de kontaktuppgifter som brevlådeinnehavaren har angett i avslutet. 4.3 Ställa in mottagningsregler Sekvensdiagrammet i Figur 5 visar hur brevlådeanvändaren ställer in och uppdaterar sina mottagningsregler. Mottagningsregler innebär att brevlådeinnehavaren kan välja vilka avsändande myndigheter som får skicka elektroniska meddelanden. När brevlådeanvändaren har loggat in med e-legitimation och valt att hantera sina mottagningsregler hämtas nuvarande mottagningsregler som finns lagrade i FaR och nya kan ställas in. Figur 5. Sekvensdiagram Ställa in mottagningsregler För att hämta brevlådeinnehavarens mottagningsregler anropar brevlådeoperatören FaRansvarig och tjänsten Recipient med operationen getaccountpreferences. Brevlådeanvändaren kan nu hantera från vilka avsändande myndigheter denne accepterar elektronisk post och inte. Uppdateringen av mottagningsregler sparas i FaR genom att brevlådeoperatören anropar FaR-ansvarig och tjänsten Recipient med operationen storeaccountpreferences.
Mina meddelanden Version: 1.2 Sida 8 av 9 4.4 Ta emot säker försändelse Sekvensdiagrammet i Figur 6 visar vad som händer när en brevlådeoperatör tar emot en säker försändelse från förmedlaren. Figur 6. Sekvensdiagram Ta emot säker försändelse Förmedlaren levererar en säker elektronisk försändelse genom att anropa tjänsten Service hos brevlådeoperatören med operationen deliversecure. Brevlådeoperatören kontrollerar i FaR att förmedlaren är godkänd och lagrar därefter meddelandet i mottagarens säkra elektroniska brevlåda. Efter att mottagarens kontaktuppgifter kontrollerats aviseras mottagaren via e-post eller sms, till de kontaktuppgifter mottagaren har angett hos brevlådeoperatören.
Mina meddelanden Version: 1.2 Sida 9 av 9 4.5 Ta emot enkel försändelse För att ta emot en enkel elektronisk försändelse från förmedlaren följs i stort samma steg som för en säker elektronisk försändelse, se sekvensdiagram i Figur 7. Figur 7. Sekvensdiagram Ta emot enkel försändelse En enkel elektronisk försändelse levereras till brevlådeoperatören genom att förmedlaren anropar tjänsten Service med operationen notify. Brevlådeoperatören kontrollerar att förmedlaren är godkänd i FaR och kan välja om det enkla elektroniska meddelandet ska lagras i den säkra elektroniska brevlådan eller inte. Efter att mottagarens kontaktuppgifter kontrollerats skickas det enkla elektroniska meddelandet via e-post eller sms, till de kontaktuppgifter mottagaren har angett hos brevlådeoperatören. 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 2013-02-08 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-19 1.1 Begrepp uppdaterade utifrån Begreppsmodell Annika Melin Version 3.0. 2013-03-09 1.2 Medgivande borttaget. Annika Melin