NORSK BRUKERVEILEDNING

NORSK BRUKERVEILEDNING for implementering av SMTP Versjon: 1.0 Revisjon: C Dato: 20. februar 2006 Systemstøtte for Ediel / Norsk Ediel Ekspertgruppe Side: 1

INNHOLDSFORTEGNELSE 1 BAKGRUNN... 3 2 REFERANSER... 4 3 PLANLAGTE ENDRINGER... 4 4 KORREKSJON FRA TIDLIGERE VERSJONER... 4 5 BRUK AV SMTP... 5 5.1 GENERELT OM SPESIFIKASJONENE... 5 6 SMTP PROTOKOLLEN... 5 6.1 MELDINGSFORMAT... 5 6.2 ADRESSERING... 5 7 BEGREP OG DEFINISJONER... 6 7.1 FORKORTELSER... 6 7.2 BEGREPER... 6 Vedlegg A Bruk av UNB-segmentet... 7 Vedlegg B Eksempel på MIME header... 9 Systemstøtte for Ediel / Norsk Ediel Ekspertgruppe Side: 2

1 BAKGRUNN På initiativ i fra bransjen innføres SMTP (e-post) som skal erstatte kommunikasjonsprotokoll X.400. Informasjonsmengden i bransjen øker og det stilles nye krav til fleksibilitet og det fokuseres stadig på ressursbesparende tiltak. Pr i dag er det kun en aktør som tilbyr X.400, og det har medført relativt høye kostnader for meldingsutveksling i bransjen. Norsk brukerveiledning for implementering av SMTP Dette dokumentet beskriver hvordan SMTP skal benyttes som kommunikasjonsprotokoll for elektronisk meldingsutveksling i Norge. Dokumentet baserer seg bl.a. på krav og forskrifter fra NVE, Statnett SF og bransjen selv). Dokumentet er skrevet av Systemstøtte for Ediel. Dokumentet vil bli oppdatert ved behov. Systemstøtte for Ediel er ansvarlig for oppdateringen. Nye versjoner vil bli lagt ut på www.ediel.no. Målgruppen til Ediel brukerveiledning for SMTP Brukerveiledningen retter seg mot systemleverandører og foretak som utvikler egne system og løsninger for Ediel i Norge. Dokumentet er teknisk orientert.. For virksomhetsmessige regler og rutiner henvises det til NVEs forskrifter. Leseren forventes å ha god kjennskap til datakommunikasjon. Tilbakemelding fra brukere Aktørene kan henvende seg til Systemstøtte for Ediel dersom det skulle oppstå uklarheter, forslag til forbedringer, generelle spørsmål eller lignende (ediel@statnett.no). Testprosedyrer Det kreves godkjennelse via sertifiseringssystemet til Systemstøtte for Ediel for å kunne utveksle Ediel meldinger i henhold til [2] Forskrift om måling, avregning m.v. fra NVE. De enkelte aktører må selv ta ansvaret for å gjennomføre tester for å verifisere at løsningen har tilstrekkelig funksjonalitet. For nærmere informasjon, se www.ediel.no. Oppdaterte aktørprofiler i Ediel adresseregister Alle aktører er ansvarlige for at navn, adresse, organisasjonsnummer, kommunikasjonsadresser (SMTP), osv. til enhver tid er oppdatert i Ediel Adresseregister. Systemstøtte for Ediel / Norsk Ediel Ekspertgruppe Side: 3

2 REFERANSER [1] Message handbook for Ediel, Functional description, siste versjon, www.ediel.org. [2] Forskrift om måling, avregning og samordnet opptreden ved kraftomsetning og fakturering av nettjenester av 11. mars 1999 med til en hver tid siste endring, NVE, www.nve.no. [3] MIME Encapsulation of EDI Objects, RFC 1767, Mars 1995. http://www.faqs.org/rfcs/rfc1767.html [4] Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies, RFC 2045, November 1996. http://www.faqs.org/rfcs/rfc2045.html [5] Multipurpose Internet Mail Extensions (MIME) Part Two :Media Types", RFC 2046, November 1996. http://www.faqs.org/rfcs/rfc2046.html 3 PLANLAGTE ENDRINGER Dette er første versjon og det er derfor ingen planlagte endringer utover at denne brukerveiledning trår i kraft. 4 KORREKSJON FRA TIDLIGERE VERSJONER 17.2.2006 Presisering av navngiving av vedlegg, kap. 6.1 20.2.2006 Presisering av antall vedlegg og behandling av innhold i body, kap. 6.1 Systemstøtte for Ediel / Norsk Ediel Ekspertgruppe Side: 4

5 BRUK AV SMTP 5.1 Generelt om spesifikasjonene. Den norske kraftbransjen anvender i dag X.400-kommunikasjon som protokoll for å utveksle Ediel-meldinger. Innen 1.7.2006 skal samtlige aktører utveksle elektroniske meldinger via SMTP. Det er ikke lovmessige forutsetninger eller rammebetingelser som krever kryptering av meldinger. Derfor foreligger ingen plan om innføring av kryptering av meldinger innen samme tidsrom. Denne spesifikasjonen definerer formatet på SMTP som kommunikasjonsprotokoll slik det skal anvendes for Ediel-meldingsutveksling i Norge. Leseren forutsettes å ha kjennskap til eller gjøre seg kjent med de dokumenter som denne spesifikasjonen refererer til. 6 SMTP PROTOKOLLEN 6.1 Meldingsformat Ediel-meldinger over SMTP skal sendes i klartekst. Klartekstmeldinger sendes ved hjelp av e- postformatet MIME [3] definert på følgende format: Mime-Version: 1.0 Content-Type: application/edifact; Content-Transfer-Encoding: base64 Content-Disposition: attachment; Selve Ediel-meldingen ligger i e-posten som et vedlegg. Legg merke til at både vedlegget (Edielmeldingen) og selve SMTP-konvolutten skal sende på overforstående format. For videre informasjon, se referansene [3] [4] [5]. Emnefeltet (e-postens subject ) skal inneholde følgende informasjon for å lette sporing av meldingen: <Navn på meldingen><mellomrom><unb-feltet> Eksempel: PRODAT UNB+UNOB:2+102962986633:82:PRODAT+102979709625:82:PRODAT +051229:0827+EDI012345' Bruk av multipart [3] tillates ikke. Det skal bare sendes én Ediel-melding (ett vedlegg) (UNB) pr SMTP-melding, og det som eventuelt står i body skal ignoreres. Ediel-meldingen skal være en vanlig ASCII-fil (Content-Transfer-Encoding: base64) og filnavnet må følge MIME-standarden [3] [4] [5] (dvs. ikke inneholde spesialtegn som komma, spørsmålstegn, prosent, stjerne etc.). Utover det står man fritt til å velge filnavn. 6.2 Adressering SMTP-adresser som skal benyttes, tilsvarer dagens X.400-adresser. Det vil si at én aktør kan ha flere SMTP-adresser. Begrensningen ligger på meldingsnivå: Det tillates kun én subadresse og således kun én SMTP-adresse pr meldingsnivå. Tredjepart kan benytte én enkelt SMTP-adresse for å håndtere all trafikk for aktører som de representerer. Aktørene står fritt til å velge sine egne SMTP-adresser. Disse adressene må registreres på Ediel Portalen (www.ediel.no). Adressene anbefales å følge en liknende struktur som X.400-adressene. Systemstøtte for Ediel / Norsk Ediel Ekspertgruppe Side: 5

7 BEGREP OG DEFINISJONER Under er det beskrevet gitt en del sentrale begrep og uttrykk som benyttes i forbindelse med elektronisk kommunikasjon. Ikke alle er gjengitt i dette dokumentet. 7.1 Forkortelser ISP Internet Service Provider. Tilbyder at Internettforbindelse til firmaer og privatpersoner. Eksempler på ISP'er er: Telenor, Tele2, Bluecom, Nextgentel osv. MAPI Messaging Application Program Interface. Muliggjør sending av e-post fra et Windowsprogram og sending av dokumenter/filer i e-posten. MIME Multipurpose Internet Mail Extensions. Standard for hvordan meldinger skal formatteres for at de skal kunne utveksles mellom ulike e-postsystemer. NEE Norsk Ediel Ekspertgruppe. PKI Public Key Infrastructure. Offisielt nettverk av organisasjoner/foretak som fordeler/holder kontroll på krypteringsnøkler. (www.pki-page.org). POP3 Post Office Protocol, versjon 3. Standard protokoll for mottak av e-post og hvordan en mailserver oppbevarer e-post for en klient. RFC Request for Comments. En samling tekniske og organisasjonsmessige dokumenter om Internett. Omfatter standarder, protokoller, retningslinjer osv. (www.rfc-editor.org) S/MIME Secure Multipurpose Internet Mail Extensions (se MIME). SMTP Simple Mail Transfer Protocol. Standard kommunikasjonsprotokoll for utveksling av e- post. 7.2 Begreper Base 64 Metode for koding av data. E-postklient Dataprogram som kobler seg opp mot en e-postserver for å motta og sende e-post. E-postserver Datamaskin som står som mottaker og avsender av e-postmeldinger via internett eller andre dataoverføringslinjer. Kryptering sikrer innholdets lesbarhet slik at det ikke kan tolkes av andre enn den/de som innehar gyldig krypteringsnøkkel. Sertifikat - Elektronisk dokument som viser at innehaver av krypteringsnøkkel er autorisert av autorisert sertifikatutsteder i nettverket. Signatur sikrer at innhold ikke er endret fra avsender til mottaker. X.400 er en kommunikasjonsprotokoll. Systemstøtte for Ediel / Norsk Ediel Ekspertgruppe Side: 6

Vedlegg A Bruk av UNB-segmentet UNB-segmentet skal, etterfølgende navn på meldingsfunksjon, gjengis i emnefeltet til SMTPmeldingen. Nedenfor er UNB segmentet beskrevet slik det skal benyttes i Norge. Ved internasjonal bruk kan avvik forekomme, se [1] Message handbook for Ediel, Functional description. Følgende endringer er gjort for Norge: Det er åpnet for mulighet til å benytte EDIFACT syntaks versjon 3 og tegnesett UNOC. Bruk må avtales bilateralt. Kodeverket i dataelement S002 0007 og S003 0007 er noe begrenset. UNB Utvekslings hode Funksjon: Å starte, identifisere og spesifisere en utveksling. Klassifikasjon: Mandatory (M1). Kommentar: Hver part skal fritt kunne velge sin egen adresse. Eksempel: UNB+UNOB:2+102123456789:82+10001:ZZ:BAS+ 961204:1434+2345' Ref. Navn Kl. Form. Beskrivelse S001 SYNTAX IDENTIFIER M 0001 Syntax identifier M a4 Kode: UNOB (Må kunne håndteres av alle) UNOC (Kan avtales bilateralt) 0002 Syntax version number M n1 Kode: 2 Versjon 2 of ISO 9735 (EDIFACT syntaks) 3 Versjon 3 of EDIFACT syntaks Skal benyttes dersom Syntax Identifier er UNOC S002 INTERCHANGE SENDER M 0004 Sender identification M an..35 Defineres av sender av utvekslingen. Bruk en av følgende: EAN Lokasjonsnr., (14) «102»+Organisasjonsnummer. fra Foretaks-/Enhetsregisteret, (82) «101»+Firma Id. fra Statens Teleforvaltning (STF), (82) 0007 Partner identification code qualifier R an..4 Kode: 14 EAN (European Article Numbering Association) 82 Statens Teleforvaltning 0008 Address for reverse routing X an..14 Bruk en av følgende: PRODAT TIMER STANDER AVREGNING SLDAVR SLDGRL SLDOPG Systemstøtte for Ediel / Norsk Ediel Ekspertgruppe Side: 7

S003 INTERCHANGE M RECIPIENT 0010 Recipient Identification M an..35 Defineres av mottager av utvekslingen. Bruk en av følgende: EAN Lokasjonsnr., (14) «102»+Organisasjonsnummer. fra Foretaks-/Enhetsregisteret, (82) «101»+Firma Id. fra Statens Teleforvaltning (STF), (82) 0007 Partner identification code qualifier R an..4 Kode: 14 EAN (European Article Numbering Association) 82 Statens Teleforvaltning 0014 Routing address O an..14 Bruk en av følgende: PRODAT TIMER STANDER AVREGNING SLDAVR SLDGRL SLDOPG S004 DATE/TIME OF M PREPARATION 0017 Date M n6 Dato for generering av utvekslingen (ÅÅMMDD) 0019 Time M n4 Tid for for generering av utvekslingen (TTmm) 0020 INTERCHANGE CONTROL REFERENCE S005 RECIPIENTS REFERENCE, PASSWORD 0022 Recipient's reference/ password 0025 Recipient's reference/ password qualifier 0026 APPLICATION REFERENCE 0029 PROCESSING PRIORITY CODE 0031 ACKNOWLEDGEMENT REQUEST M an..14 Unik referanse generert av avsender. X X X an..14 an2 O an..14 Kan avtales bilateralt X a1 O n1 Kode: 1 hvis avsender ønsker en EDIFACT CONTRL melding, i retur. X an..35 0032 COMMUNICATIONS AGREEMENT 0035 TEST INDICATOR D n1 Kode: 1 Skal benyttes ved test. Systemstøtte for Ediel / Norsk Ediel Ekspertgruppe Side: 8

Vedlegg B Eksempel på MIME header To: smtp@ediel.se Subject: APERAK UNB+UNOB:2+102111111112:82:PRODAT+102877530442:82:PRODAT+051011:1208+8AAVV++++1 From: smtp@kraftuttak.no MIME-Version: 1.0 Content-Type: application/edifact Content-Transfer-Encoding: base64 Content-Disposition: attachment Systemstøtte for Ediel / Norsk Ediel Ekspertgruppe Side: 9