Til elleverandørerne Adgang til kundeportalen 3. april 2012 XSTJ/LRO Følgende dokument har til formål at orientere elleverandørerne om implementering og testning af den it-funktionalitet, som skal sikre opfyldelsen af de opgaver, som elleverandørerne har i forbindelse med kundeadgangen til DataHub en. 1. Krav til elleverandørerne... 1 2. Elleverandørens hjemmeside med data fra DataHub en... 2 2.1 Datahub iframe integration... 2 2.1.1 URL... 3 2.1.2 Parametre... 3 2.1.3 Custom HTML... 4 2.2 NemID integration... 4 2.3 Valg af implementeringsværktøjer... 6 2.3.1 Tilkøb af softwarepakke... 6 2.3.2 Tilkøb af hosted minimal hjemmeside... 6 2.3.3 Programmér selv fra specifikationerne... 6 3. Support af implementeringen... 7 4. Support efter idriftsættelse... 7 1. Krav til elleverandørerne Ved DataHub ens idriftsættelse bliver det obligatorisk for elleverandører med slutkunder i det danske elmarked at gøre kundernes data i DataHub en tilgængelige for kunden. Adgangen skal gives på elleverandørens hjemmeside, og være let og intuitivt tilgængelig for kunden. Kunden må ikke pålægges gebyr for adgang til webapplikationen. Adgangen kræver, at elleverandøren indbygger DataHub'ens webapplikation i sin hjemmeside efter Energinet.dk's anvisninger herunder ved anvendelse af NemID til brugerautentifikation. Dok. 24152/12, Sag 10/3365 1/7
Til sidst kræves det, at elleverandører formidler den webaccesskode, som kommer fra DataHub en som en del af stamdata, til kunderne. Denne formidling skal som minimum foretages ved tilflytninger og derefter minimum 1 gang årligt fx på regningen til kunden. 2. Elleverandørens hjemmeside med data fra Data- Hub en Kundeadgangen til DataHub en skal stilles til rådighed for kunderne via en iframe på elleverandørernes hjemmesider og login via NemID. NemID Token Datahub forbrugerapplikation DanID server: - NemID login - Validering af NemID Elleverandør server: - Hjemmeside/portal - DataHub forbrugerapplikation -NemID login & token generering DataHub server - Data til forbrugerapplikation - Brugerstyring Figur 1 Skitse af de elementer der indgår i kundernes adgang til data via elleverandørernes hjemmeside. DataHub'en sørger for, at den relevante information til den indloggede kunde bliver leveret til webapplikationen. Det betyder, at det er DataHub'ens brugerstyring, der håndterer sikkerheden for, at den enkelte kunde udelukkende ser egne data på tværs af elleverandører. Data vil blive sendt direkte til kundens browser udenom elleverandørens server. 2.1 Datahub iframe integration Visningen af kundens elforbrug skal implementeres som en iframe løsning, dvs. at det er muligt at indlejre en færdig applikation direkte på elleverandørens hjemmeside. Applikationen til fremvisning af forbrug er den samme for alle, og den er hostet centralt, hvilket betyder, at der ikke skal ligge applikationskode på elleverandørens egne servere. Dok. 24152/12, Sag 10/3365 2/7
Den fysiske iframe skal have en fast bredde og højde for at sikre ens brugeroplevelse på tværs af de forskellige hjemmesider. Det er besluttet at benytte en tilpasset løsning, hvilket betyder, at elleverandøren har mulighed for visuel integration på egen hjemmeside. Følgende beskriver de indstillinger, de enkelte elleverandører kan lave i forbindelse med iframe opsætningen: URL Parametre Custom HTML 2.1.1 URL Format for kald af iframe application: https://[url.to.iframe.server]/[lang]/ Eksempel: https://[url.to.iframe.server]/da-dk/ (for dansk) https://[url.to.iframe.server]/en/ (for engelsk) 2.1.2 Parametre Token Language CustomCss Stylesheet Token Det krypterede nemid token, der generes, når brugeren logger ind. Token bør lægges som en postparameter. Language Er det sprog, der bliver vist. Mulighederne er enten da-dk eller en (dvs. dansk eller engelsk). CustomCss Elleverandøren kan selv ændre dele af iframe stylingen for visuelt bedre at kunne indlejre applikationen i eget hjemmesideformat. Til det formål vil der være en række klasser til at styre styling af applikationen, der ligger inden for html iframe en. Der vil ved opstart forefindes et default stylesheet, der blot skal modificeres efter eget ønske. Det er selvfølgelig også muligt at vælge standardstylingen til løsningen. Hvis der i iframe applikationen skal bruges anden styling (farver, skrifttyper mm.) skal denne parameter bruges. Parameteren skal indeholde en fuld sti til en css fil, der kan ses eksternt. Den kan være placeret på elleverandørens egen server. Bemærk, at det skal være https som resten af løsningen for ikke at give en advarsel til brugeren. Stylesheet Elleverandørens styling kan foretages på følgende attributter: Dok. 24152/12, Sag 10/3365 3/7
Baggrundsfarve Felt og datagrid baggrundsfarve Borderfarve Fanebladsborderfarve Fontfarve Faneblad baggrundsfarve aktiv (bruges også til knapper) Faneblad baggrundsfarve inaktiv (bruges som farve når knappen aktiveres) Faneblad fontfarve aktiv (bruges også til knapper) Faneblad fontfarve inaktiv (bruges som farve når knappen aktiveres) Datatabeller Overskrift Font og baggrunds farve Datatabeller Kolonner Font og baggrunds farve Datatabeller Alt. kolonner Font og baggrunds farve Der er desuden følgende parameterstyret styling: Rounded border layout (Yes/No) Font family (size) o Arial (10) o Tahoma (10) o Sans Serif (10) o Times New Roman (11) o Georgia (10) 2.1.3 Custom HTML Nedenstående eksempel viser html og asp.net kode brugt ifm. kald af iframeapplikationen. Det er også muligt at benytte et Java-baseret framework ved iframe implementeringen. Title="Iframe with signed token" AutoEventWireup="true"%> <asp:content ID="content" runat="server" Visible="true" ContentPlaceHolderID="ContentPlaceHolder" > <h1>vores Elforsyning</h1> <p>her er oversigten over dit elforbrug</p> <iframe src="tokenposter.aspx" height="360px" width="700px"> </iframe> For uddybende beskrivelse af implementeringen henvises til de gældende dokumenter på Energinet.dk s hjemmeside. 2.2 NemID integration Nedenstående figur illustrerer, hvorledes kommunikationen mellem en privat kunde, elleverandør og DataHub flyder. 1. Kunden logger ind med NemID Dok. 24152/12, Sag 10/3365 4/7
2. Elleverandørens hjemmeside genererer en sessionstoken og redirigerer kunden med denne til DataHub iframe. 3. DataHub modtager sessionstoken, validerer denne, og uddrager brugeridentitet. 4. DataHub sender kundedata til iframen. Figur 2: Flow ved privatkundes login på elleverandørens hjemmeside For erhvervskunder anvendes også NemID til login. I så fald anvendes de medarbejdersignaturer, som virksomheden råder over. Hermed sikres, at kun autoriserede medarbejdere har adgang til virksomhedens data i DataHub en. Det er virksomhedens administrator, der via selvbetjeningsfunktionen for medarbejdersignaturer, tildeler rettigheder til de pågældende medarbejdere. Som anført ovenfor er det et krav, at elleverandørerne stiller login med NemID til rådighed for kunderne på deres hjemmeside. Elleverandørerne kan desuden vælge at understøtte andre digitale signaturløsninger, som deres kunder har. De relevante digitale signaturløsninger for henholdsvis private og erhvervskunder er: Privatkunder: NemID (krav) Digital signatur OCES1 (Med lokal nøgleopbevaring, de sidste udløber i 2013) NemID på hardware (Forventes påbegyndt ultimo 2012) Dok. 24152/12, Sag 10/3365 5/7
Erhvervskunder: NemID medarbejdersignatur (med lokal nøgleopbevaring, forventet sommer 2012) NemID medarbejdersignatur nøglekort (med central nøgleopbevaring, forventet sommer 2012) Digital signatur OCES1 (med lokal nøgleopbevaring, forventet levetid frem til 2015) Understøttelse af de forskellige signaturtyper skal implementeres i henhold til Nets DanIDs anbefalinger til interaktionsdesign for brugerdialogerne. 2.3 Valg af implementeringsværktøjer Elleverandørernes kan vælge mellem 3 strategier for implementeringen af Nem- ID løsningen: 1. Tilkøb af softwarepakke 2. Tilkøb af hostet hjemmeside 3. Programmér selv fra specifikationerne 2.3.1 Tilkøb af softwarepakke Elleverandøren kan vælge en systempartner til at udvikle en softwarepakke, som implementerer NemID logon, sessionstokens og håndtering af virksomhedssignatur. DataHub-projektet har samarbejdet med en systempartner, som har sammensat en standard softwarepakke, der findes til forskellige platforme og applikationsservere, herunder.net, Java, Websphere, Jboss og Weblogic. 2.3.2 Tilkøb af hosted minimal hjemmeside Har elleverandøren ikke en hjemmeside i forvejen, kan kravene om adgang for kunderne opfyldes ved at købe en hosted hjemmeside. Også her kan DataHubprojektets systempartner tilbyde en standardpakke til opfyldelse af kravene. Hvis elleverandøren benytter sig af denne mulighed, vil hjemmesiden inkludere elleverandørens logo, kontaktoplysninger samt sikre NemID login og iframe. Muligheden for at tilvælge denne ydelse afhænger af, om interessen er stor nok hos elleverandørerne. 2.3.3 Programmér selv fra specifikationerne De elleverandører som selv ønsker at forestå softwareprogrammeringen af NemID logon, dannelse af sessionstokens og håndtering af virksomhedssignatur kan tage udgangspunkt i de tekniske specifikationer, som stilles til rådighed af projektet på Energinet.dk s hjemmeside. De vigtigste kompetencer at have i huset til denne opgave er: Erfaring med implementering af NemID på hjemmesider Dannelse af SAML baserede tokens signeret med virksomhedssignatur Administration og elektronisk fornyelse af virksomhedssignaturer Såfremt elleverandøren vælger selv at programmere sin løsning, er det vigtigt, at tilmelde sig ét af de tidlige supportvinduer, således at et eventuelt øget sup- Dok. 24152/12, Sag 10/3365 6/7
portbehov ikke falder sidst i forløbet, hvor ressourcerne må forventes at være sværere tilgængelige. 3. Support af implementeringen Energinet.dk stiller support til udvikling og test til rådighed for elleverandørerne. Det er DataHub-projektets supportfunktion, der agerer 1st level support. DataHub Support kontaktes pr. mail på datahub@energinet.dk eller på telefon 70 22 28 10. Åbningstiden er hverdage kl. 8-16, fredag dog 8-15. Da der er et meget stort antal elleverandører, som skal integrere til Data- Hub en, er det vurderet nødvendigt, at elleverandørerne melder tilbage, hvornår de har behov for support fra d. 1/5 2012 til d. 1/10 2012. Der vil blive lavet 4 vinduer for support, som kan tilvælges (maj, juni, august, september). Denne tilbagemelding skal sikre, at ressourcerne udnyttes bedst muligt, således at belastningen fordeles så jævnt som muligt. I april 2012 udsendes sammen med den almindelige spørgeskemaundersøgelse tilmelding til supportvindue. Tildelingen foregår som udgangspunkt efter først til mølle princippet. Opdateret teknisk information, specifikationer, testcases og testdrejebog vil under hele forløbet være tilgængelig på Energinet.dk s hjemmeside; For elleverandører, der henvender sig med behov for support uden for den periode, som er meldt ind til Energinet.dk, må der påregnes et mindsket serviceniveau. www.energinet.dk/da/el/datahub/sider/forbrugeradgang-hoselleverandoererne.aspx. 4. Support efter idriftsættelse Efter DataHub ens idriftsættelse kan DataHub Support kontaktes pr. mail på datahub@energinet.dk eller på telefon 70 22 28 10. Åbningstiden er hverdage kl. 8-16, fredag dog 8-15. Derudover vil der på DataHub ens webportal blive mulighed for at indsende supporthenvendelser vha. en webformular. Der ydes ikke support til slutkunder. Dok. 24152/12, Sag 10/3365 7/7