Vejledning: Kontaktbarhed med SEPO (Produktionsmiljøet)

Transkript

1 Vejledning: Kontaktbarhed med SEPO (Produktionsmiljøet) I denne vejledning vil vi at guide myndigheder med et udvidet kontakthierarki (dvs. flere postkasser) der benytter snitfladen s/mime der skal integrere til SEPO sikker -løsning og kunne modtage og sende meddelelser gennem opsætning og etablering af kontaktbarhed og derved realisering af følgende edag3-usecases: 1. Borger skriver til myndighed og myndighed kan læse henvendelse 2. Myndighed besvarer henvendelse fra Borger 3. Borger svarer tilbage på svar fra myndighed 4. Myndighed initierer besked til borger Ad 1. Borger skriver til myndighed og myndighed kan læse henvendelse Myndigheder der vil have et mere omfattende kontakthieraki kan vælge enten at (A) oprette det selv eller (B) importere KLs kontakthieraki. A. Opret egen postkassestruktur i administrationsportalen (rolle: administrator): Log på administrationsportalen som administrator ( Klik på fanebladet Kontaktmuligheder Klik på under fanebladet Postkasser Klik på Opret postkasser Giv postkassen et navn Giv en beskrivelse af postkassen Opret mapper, hvis dine postkasser skal grupperes bruges kun til at skabe overblik i slutbrugergrænsefladen Vælg aktiveringsdato. Postkassen er synlig i slutbrugergrænsefladen fra den dato der står i feltet Under indstillinger skal følgende sættes: Tryk Næste Postkassen skal være synlig for slutbrugerne Tryk Opret ny adresse eller Benyt allerede oprettet o Upload myndighedens certifikat (Base64-kodet se vejledning på Administrationsportalen) o Indtast myndighedens sikre -adresse 1

2 o Tryk ok Under indstillinger skal følgende sættes: Tryk Næste Indsæt automatisk dialogtråd i beskeden Indtast navn på et emne og tryk opret. Hvis myndighed skal kunne svare på henvendelser fra borgere, skal der være et emne på postkassen. Sæt flueben i Slutbrugeren skal vælge et af ovenstående emner ved henvendelse til denne postkasse Tryk Næste Vælg det oprettede emne Tryk Næste Tryk Godkend Gentag processen for hver postkasse der skal oprettes. B. Importer KLs kontakthieraki Tryk på kontaktmuligheder Tryk på linket importer postkassestruktur Jeg accepterer vilkårene for import af den fælleskommunale postkassestruktur Tryk OK Vælg KL skabelon til kommuner Tryk næste Vælg de postkasser, der skal importeres Opret leveringsadresse ved at vælge ny eller nyt afhentningssystem Vælg ESDH system som der skal integreres til Tryk næste Tryk godkend Når postkassehierakiet er oprettet skal postkasse id er og postkasseemne id er overføres til SEPO's tillægskomponent Send Digitalt, hvis Send Digitalt anvendes til Digital post kommunikation. Det gøres således: Klik på Kontaktmuligheder Klik på postkasser gem liste Gem listen i tekstfil-format 2

3 Åbn en browser og gå ind på konverteringssiden Bemærk, at siden anvender et SSL servercertifikat, som er udstedt af Tieto, hvilket kan give en advarsel i browseren. Ved klik på "fortsæt" kommer selve konverteringssiden frem. Gem den konverterede fil under navnet Postkasser.xml Filen Postkasser.xml kan anvendes direkte i Send Digitalt. Vejledning i opsætning af Send Digitalt kan hentes på C. Klargør system der modtager henvendelser Det en myndighed modtager fra e-boks med adressen indgaaende@prod.e-boks.dk er signeret med certifikatet Digital Signatur for Prod Indgaaende DKAL.cer (kan downloades på forsiden af administrationsportalen) og krypteret med de certifikater, der blev uploaded på de sikre -adresser der blevet oprettet på administrationsportalen. Det betyder, at vil man læse beskeder fra borger (indgaaende@prod.e-boks.dk) skal det system, der modtager beskeder i myndigheden, kende de to certifikater, som derfor skal opsættes i systemet. Myndigheder med en inhouse SEPO skal udføre nedenstående punkter: Download og udpak certifikatpakken (Certifikater_Test_Produktion.zip) Åbn SEPA (SEPO Administration) Vælg menuen Postkasser og åbn listen med sikre postkasser Kontrollér, at den sikre postkasse, der skal modtage henvendelserne, er i listen Vælg menuen Certifikater og tryk på Tilføj Tilføj e-boks produktionscertifikatet (filen"digital Signatur for Prod Indgaaende DKAL.cer") Tilføj e-boks demo-certifikatet (filen"digital Signatur for Demo Indgaaende DKAL.cer") Tryk på Genstart (af SEPO) Myndigheder med en hosted SEPO skal ikke foretage sig noget under dette punkt. D. Test usecasen borger skriver til myndighed : I produktionsmiljøet logges på som Borger med Digital signatur Borger skriver til myndighed via f.eks. at vælge myndigheden via adressebogen Myndighed kontrollerer at henvendelse er modtaget, og den kan læses Ad 2. Myndighed besvarer henvendelse fra Borger Hvis en myndighed vil besvare en henvendelse fra en borger kræver det, at det system myndigheden vil svare fra, er et kendt afsendersystem, og at der er et materiale besvarelsen er relateret til. Det vil sige, at der i administrationsportalen skal oprettes et afsendersystem, et materiale og en tilmeldingsgruppe. Opsætningen af de tre elementer skal gennemføres i den beskrevne rækkefølge og er forklaret nedenfor: 3

4 A. Opret afsendersystem (rolle: administrator): Tryk på fanebladet Tilmeldingsmuligheder Tryk på underfanebladet Afsendersystem Tryk på tilslut eget afsendersystem Giv afsendersystemet et navn, fx SEPO Tryk på opret leverandør Skriv Tieto og tryk ok Angiv EAN-nr. der skal faktureres for oprettelse af afsendersystemet Upload certifikat Følgende indstillinger for afsendersystemet skal anvendes: Angiv kontaktperson, dennes -adresse og telefonnr. Tryk ok Aflæs afsendersystemets id i listen over afsendersystemer. Id'et skal anvendes senere. B. Opret materiale (rolle: systemadministrator): Materialet er ikke synlig for slutbrugere Tryk på fanebladet Tilmeldingsmuligheder Tryk på underfanebladet Materialer Klik på Opret materiale Giv materialet et navn, f.eks. Meddelelser fra digital post Vælg meddelelser som materialetype 4

5 Giv evt. en intern beskrivelse vises ikke for slutbruger Tryk på næste Vælg systemleverandør i nedtrækslisten og tryk på næste Vælg det oprettede afsendersystem der er oprettet i punkt A. Tryk på næste Tryk på vælg emne Vælg svarpostkasseemne og tryk næste Tryk godkend og bliv på denne side på administrationsportalen Aflæs materialets id i listen over materialer. Id'et skal anvendes senere. Gå videre til punkt C nedenfor C. Opret tilmeldingsgruppe (rolle: systemadministrator): Tilmeldinsgruppen er synlig for slutbruger Tryk på linket Tilknyt dette materiale til en tilmeldingsgruppe Hop til feltet Opret en ny tilmeldingsgruppe Giv tilmeldingsgruppen et navn, f.eks. Besked fra <myndighed> (synlig for slutbrugeren) Giv en beskrivelse af tilmeldingsgruppen (også synlig for slutbrugeren). Beskrivelsen kunne være ved tilmelding til denne tilmeldingsgruppe giver du <myndighed> mulighed for at besvare dine henvendelser Angiv om det er private borgere eller virksomheder der skal kunne skrive. Hvis begge målgrupper skal kunne henvende sig til myndigheden oprettes en tilmeldingsgruppe til hver Kryds IKKE af i feltet Denne tilmeldingsgruppe skal være obligatorisk og vilkår for anvendelse accepteres Angiv Aktiveringsdato tilmeldingsgruppen vil være synlig i brugergrænsefladen fra den dato der angives. Tryk Opret tilmeldingsgruppe Vælg tilmeldingsgruppen i nedtrækslisten øverst i skærmbilledet Tryk næste Tryk ok D. Rediger afsendersystem (rolle: systemadministrator): Tryk på fanebladet Tilmeldingsmuligheder Tryk på underfanebladet afsendersystemer Tryk på SEPO 5

6 Under indstillinger, vælg meddelelser fra myndighed som standardmateriale i nedtrækslisten E. Klargør system der skal svare på henvendelser Det en myndighed sender til e-boks, dvs. indgaaende@prod.e-boks.dk, skal signeres med myndighedens certifikat som angivet i administrationsportalen og skal krypteres med Digital Signatur for Prod Indgaaende DKAL.cer (kan downloades på forsiden af administrationsportalen). Dette skal sættes op i myndighedens afsendersystem. Myndigheder med en inhouse SEPO skal udføre nedenstående punkter (se et eksempel i skærmbilledet nedenfor): Åbn SEPA (SEPO Administration) Vælg menuen Egenskaber og vælg Digital post og Generelt Aktivér Digital post integration Indtast standard afsendersystem id Indtast standard materiale id Vælg standard afsender-postkasse Indtast de tre oplysninger i feltet "AfsendersystemId <> Postkasser" på formen <SysID>:<mailadresse>:<MaterialeID> fx "123:sikkerpost@myndighed.dk:456789" Hvis SEPO skal integrere flere afsendersystemer (udover standard afsendersystemet), så skal de også indtastes i feltet "AfsendersystemId <> Postkasser" på formen <SysID2>:<mailadresse2>:<MaterialeID2>,<SysID3>:<mailadresse3>:<MaterialeID3>;... fx "123:sikkerpost@myndighed.dk:456789" Tryk på OK og tryk på Genstart (af SEPO) Myndigheder med en hosted SEPO skal sende oplysninger om afsendersystem id, materiale id og afsender-postkasse til support@sepo.dk, hvorefter Tieto klargør systemet. 6

7 Test af integrationen kan foretages mod e-boks demosystem ved at erstatte S/MIME- og REST-adresserne i ovenstående skærmbillede med hhv. indgaende@demo.e-boks.dk og Husk i så fald også at skifte afsendersystem id og materiale id, hvis de er anderledes i demo-miljøet end i produktionsmiljøet. F. Test usecasen: Myndighed besvarer henvendelse fra borger": Test ved hjælp af SEPO tillægskomponenten Send Digitalt: Myndighed åbner henvendelse fra borger i Outlook Myndighed trykker på Svar Digitalt Myndighed skriver besvarelse Myndighed trykker på Send Digitalt og ændrer evt. svarpostkasse og emne Myndighed sender Borger logger på og tjekker at besvarelsen kan læses husk at kontrollere i forskellige browsere Test uden Send Digitalt: Myndighed åbner henvendelse fra borger i myndighedens system Myndighed trykker på besvar Myndighed skriver besvarelse Myndighed sender Borger logger på og tjekker at besvarelsen kan læses husk at kontrollere i forskellige browsere Ad 3. Borger svarer tilbage på svar fra myndighed Med denne simple model kræver usecasen Borger svarer tilbage på svar fra myndighed ikke yderligere opsætning. A. Test usecasen Borger svarer tilbage på svar fra myndighed : Log på som borger Besvar svaret fra myndigheden Myndighed kontrollerer, at henvendelse er modtaget, og den kan læses Ad 4. Myndighed initierer besked til borger Hvis myndigheden skal kunne initiere korrespondance med en borger kræver det som udgangspunkt ikke yderligere opsætning, men det kræver, at myndighedsmedarbejderen kan konstruere en mail, der opfylder følgende minimumsbetingelser: Mailens modtager skal være adressen indgaaende@prod.e-boks.dk 7

8 Mailens tekst skal indeholde linien ##DKALCPR=xxxxxxxxxx##, hvor x'erne erstattes med modtagers personnummer Mailens tekst kan valgfrit tilføjes linierne ##DKALIndholdstype=xx## og/eller ##DKALSysId=xx##, hvis standard materialetype og/eller standard afsendersystem ønskes erstattet med en anden materialetype og/eller et andet afsendersystem Alternativt til den ovenfor beskrevne manuelle procedure kan myndigheden indgå en aftale med Tieto om anvendelse af SEPO tillægskomponenten Send Digitalt, som på en interaktiv måde understøtter medarbejderen i afsendelse af henvendelser til Digital post, uden at medarbejderen manuelt skal angive diverse metadata (modtager, systemoplysninger og svarpostkasse og -emne). B. Test usecasen Myndighed initierer besked til borger : Test ved hjælp af SEPO tillægskomponenten Send Digitalt: Myndighed opretter henvendelse til borger i Outlook og trykker på Send Digitalt Myndighed skriver modtagers CPR-nummer i CPR-/CVR-feltet og trykker på TAB Myndighed kontrollerer, at modtager accepterer henvendelsen i sin Digitale postkasse Myndighed ændrer evt. svarpostkasse og emne Myndighed sender Borger logger på og tjekker at henvendelsen er modtaget og kan læses Kontroller at beskeden kan besvares Log på som myndighedsmedarbejder og kontroller at svar fra borger modtages og kan læses Test uden Send Digitalt: Myndighed opretter henvendelse til borger i myndighedens system Myndighed angiver modtager "indgaaende@prod.e-boks.dk" Myndighed indsætter CPR-nummer-linien øverst i mailen: ##DKALCPR= ## Myndighed sender Borger logger på og tjekker at henvendelsen er modtaget og kan læses Kontroller at beskeden kan besvares Log på som myndighedsmedarbejder og kontroller at svar fra borger modtages og kan læses Med SEPO tillægskomponenten Send Digitalt kan myndigheden styre valget af svarpostkasse og svaremne både på myndighedsinitierede henvendelser og på besvarelser og dermed føre dialog med borgere inden for alle emner i det udvidede kontakthierarki. 8