Dnr 2011/ FILFORMAT VERSION 1.2

Transkript

1 Dnr 2011/ FILFORMAT VERSION 1.2

2 Innehållsförteckning Innehållsförteckning Bakgrund... 3 Introduktion... 3 Tidpunkter för sändande av informationsfilerna... 3 Informationsfilernas format och tekniska utformning... 4 Informationsfilernas innehåll... 4 Kundfilen... 5 Kontofilen... 7 Kontofördelningsfilen... 8 Transaktionsfilen... 9 Dataformat Arkivering och komprimering Exempel Kryptering och signering Kryptering och signering (GPGSM) Kryptering och signering (OpenSSL) Uppladdning till Riksgälden endast på begäran Tekniska krav på institutets unika IP-adresser Krav på kryptografisk teknik Viktigt att tänka på angående kryptografi och PKI Referenser

3 Bakgrund Denna handledning är ett komplement till Riksgäldens föreskrifter om instituts skyldighet att lämna uppgifter om insättare och deras insättningar. Tanken är att handledningen ska kunna läsas oberoende av föreskrifterna. Handledningen innehåller, i tillägg till de krav som finns i föreskrifterna, även kompletterande information och vägledning om hur man rent praktiskt kan gå tillväga för att uppfylla kraven i föreskrifterna. Introduktion När insättningsgarantin träder in kommunicerar berört institut med Riksgälden med filuppladdning via HTTPS. Den sammanställda informationen som institutet skickar delas upp i fyra olika filer, en kundfil, en kontofil, en kontofördelningsfil och en transaktionsfil. Transaktionsfilen ska skickas vid två tidpunkter, enligt vad som anges i nästa avsnitt. Tidpunkter för sändande av informationsfilerna Ett institut ska i händelse av ett ersättningsfall sända informationsfilerna vid följande tidpunkter: 1. Kundfilen, kontofilen, kontofördelningsfilen och den första transaktionsfilen ska sändas senast den arbetsdag som inträffar närmast efter dag 1 (dagen för ersättningsrättens inträde, d.v.s. den då Riksgälden begär in informationsfilerna). 2. Den andra transaktionsfilen ska sändas senast den arbetsdag som inträffar närmast efter dag 4 (den arbetsdag som infaller tre arbetsdagar efter Dag 1). Definitionen av arbetsdag är dag som inte är allmän helgdag, lördag, midsommarafton, julafton eller nyårsafton. Om det finns särskilda skäl får Riksgälden medge att informationsfilerna sänds en arbetsdag senare än den dag som anges i 1 respektive 2 ovan. Riksgälden kan även begära in informationsfilerna vid annan tidpunkt än i samband med ett ersättningsfall. Dagen för Riksgäldens begäran räknas då som dag 1, om inte Riksgälden meddelar något annat. Syftet med en sådan begäran är att genomföra en leveranskontroll, d.v.s. att kontrollera att institutet kan sända filerna i ett korrekt format om inom de givna tidsramarna. Tidsramarna är alltså desamma vid leveranskontroller som vid ett ersättningsfall. 3

4 Informationsfilernas format och tekniska utformning Informationsfilerna som institutet skickar till Riksgälden har ett övergripande filformat som gäller för alla fyra filer. Informationsfilerna ska vara textfiler som skapas i ett flatfilsformat med uppsättningen Filnamnen ska vara kund.txt för kundfilen, konto.txt för kontofilen, kontofordelning.txt för kontofördelningsfilen samt transaktion.txt för transaktionsfilerna. I filerna ska varje rad separeras med radbrytning (CR-LF). Radbrytning får endast användas mellan varje rad. Radbrytning får inte användas efter den sista raden. Varje kolumn ska separeras med ett s.k. pipe- (, byte kod 0x7c). Pipe- får endast användas mellan varje kolumn. Pipe- får inte användas efter den sista kolumnen. Det ska alltid finnas ett pipe- som separerar varje kolumn, även när värdet i en viss kolumn är tomt. Första raden i filerna ska alltid innehålla namnen på respektive kolumn. Informationsfilernas innehåll 1. Kundfilen ska innehålla en förteckning över samtliga insättare i institutet. 2. Kontofilen ska innehålla en förteckning över samtliga konton som institutet tillhandahåller och som omfattas av insättningsgarantin. 3. Kontofördelningsfilen ska innehålla information om ägarförhållandet för samtliga konton som finns med i kontofilen. 4. Transaktionsfilerna ska innehålla information om transaktioner som berör de konton som finns i kontofilen. Informationen i kundfilen, kontofilen, kontofördelningsfilen och transaktionsfil 1 ska avse förhållandena vid slutet av dag 1. Informationen i transaktionsfil 2 ska avse förhållandena vid slutet av dag 4, för transaktioner som har påbörjats senast dag 1. Varje insättare i kund-filen ska kunna ha flera rader länkade till sig i kontofördelningsfilen och kontofördelningsfilen ska kunna koppla dessa rader till flera konton i konto-filen. På så sätt ska dessa tre filer spegla verkligheten där en insättare kan ha flera konton, och där vissa konton kan vara delade med andra insättare. Det betyder också att det möjliggör att ett konto teoretiskt kan ägas av obegränsat antal insättare. Transaktionsfilen innehåller alla transaktioner som berör konto-filen. 4

5 Kund 1 * Kontofördelning * 1 Konto 1 * Transaktion Figur 1. Bilden visar kardinaliteten mellan de olika filerna. En kundrad kan kopplas till många kontofördelningsrader. Många kontofördelningsrader kan kopplas till en kontorad. En kontorad kan kopplas till många transaktionsrader. Inga rader utan kopplingar får finnas i filerna. Det exakta innehållet i respektive informationsfil framgår av tabellerna nedan. Kundfilen Kundfilen ska innehålla en förteckning över samtliga insättare i institutet. Informationen ska avse förhållandena vid slutet av dag 1. Kolumnnamn Beskrivning Antal Dataformat Kundnummer Ett unikt nummer för insättaren. Maximalt 50 Alfanumeriska inom Namn Samtliga namn (för fysiska personer) eller fullständig firma (för juridiska personer) på insättaren. Namnen ska skiljas med mellanslag. Maximalt 150 Alfanumeriska inom PersonOrgNummer För insättare som är svenska privatpersoner ska fältet innehålla personnummer. För insättare som är svensk juridisk person ska organisationsnummer användas. Maximalt 50 För personnummer ska 12 numeriska användas, enligt ÅÅÅÅMMDDNNNN (t ex ). För organisationsnummer ska 10 numeriska användas, t ex För utländska insättare kan ett så kallat globalt referensnummer användas om sådant finns. För utländska insättare får anges ett globalt referensnummer. Detta ska börja med tecknen REF och kan sedan innehålla maximalt 47 alfanumeriska. Utländska insättare får ha ett tomt värde här om både person- /org.nummer och ett globalt referensnummer saknas. Utdelningsadress Utdelningsadressen till insättaren. Maximalt 250 Alfanumeriska inom Får vara tomt. 5

6 Postnummer Postnummer till insättaren. Maximalt 250 Alfanumeriska inom Får vara tomt. Ort Postort till insättaren. Maximalt 250 Alfanumeriska inom Får vara tomt. Postland Land till insättaren. Anges bara om annat land än Sverige. Maximalt 250 Alfanumeriska inom Får vara tomt. Landskod ISO-koden för landet som insättaren är registrerad i. 2 Landskod enligt ISO CONamn C/O-namn om sådant finns. Maximalt 250 Alfanumeriska inom Får vara tomt. TIN Tax Identification Number. Skatteregistreringsnummer för skattepliktiga i utlandet. Maximalt 100 Alfanumeriska inom Får vara tomt för skattepliktiga i Sverige. Exempel på kundfil: Kundnummer Namn PersonOrgNummer Utdelningsadress Postnummer Ort Postland Landskod CONamn TIN Adam Andersson Adamsvägen Stockholm Sverige SE Bertil Bengtsson Bertilsvägen Stockholm Sverige SE Charlie Chaplin Charlie New York USA US US

7 Kontofilen Kontofilen ska innehålla en förteckning över samtliga konton som institutet tillhandahåller och som omfattas av insättningsgarantin. Informationen i kontofilen ska avse förhållandena vid slutet av dag 1. Kolumnnamn Beskrivning Antal Dataformat Kontonummer Kontots nummer. Kontonumret ska vara unikt. Maximalt 50 Numeriska eller ickenumeriska. Om clearingnummer finns så ska det sitta ihop med kontonumret utan extra. Valuta Valutakod enligt ISO Treställig valutakod enligt ISO Kapital Det saldo som finns på kontot. Anges i den valuta som kontot är i. Ska inte innehålla upplupen ränta. Maximalt 26 Decimaltal med komma (,) som decimalavskiljare. Kan innehålla värden från -2^63 till 2^63 med en precision på 1/ UpplupenRänta Den upplupna räntan fram till den dag då ersättningsrätt inträder Maximalt 26 Decimaltal med komma (,) som decimalavskiljare. Kan innehålla värden från -2^63 till 2^63 med en precision på 1/ Pantsatt Ja om kontot är pantsatt, Nej om konton inte är pantsatt. Maximalt 3 Ja eller Nej. Spärrat Ja om kontot är spärrat för utbetalning till kontohavaren och Nej om konton inte är spärrat. Maximalt 3 Ja eller Nej. Exempel på kontofil: Kontonummer Valuta Kapital UpplupenRänta Pantsatt Spärrat SEK ,96 11,92 Nej Nej SEK ,3 Nej Nej USD Ja Nej 7

8 Kontofördelningsfilen Kontofördelningsfilen ska innehålla information om ägarförhållandet för samtliga konton som finns med i kontofilen. Samma kundnummer och kontonummer får förekomma flera gånger i kontofördelningsfilen, men kombinationer av kundnummer och kontonummer ska vara unika. Informationen i kontofördelningsfilen ska avse förhållandena vid slutet av dag 1. Kolumnnamn Beskrivning Antal Dataformat Kontonummer Används för koppling mellan konton och insättare. Maximalt 50 Ska matcha kontonummer i kontofilen. Kundnummer Används för koppling mellan insättare och konton. Maximalt 50 Ska matcha kundnummer i kundfilen. KundensAndel Andel i decimalform där 1 är högst och 0,0001 är lägst. Maximalt 6 Anges med fyra decimalers noggrannhet. Exempel på kontofördelning: Kontonummer Kundnummer KundensAndel , ,5 8

9 Transaktionsfilen Transaktionsfilen ska innehålla information om transaktioner som berör de konton som finns i kontofilen. Transaktionsfilen ska tas fram vid två tillfällen. Transaktionsfil 1 ska visa transaktioner som vid slutet av dag 1 är registrerade men inte bokförda på de konton som finns i kontofilen. Transaktionsfil 1skickas tillsammans med övriga tre informationsfiler. Transaktionsfil 2 ska visa de transaktioner som faktiskt bokförts på de konton som finns i kontofilen från och med dag 2 till och med dag 4, och som avser tiden fram till och med dag 1. Transaktionsfil 2 skickas enskilt. Kolumnnamn Beskrivning Antal Dataformat Kontonummer Transaktionsdatum Används för koppling mellan transaktioner och konto. Datum och tidpunkt för transaktionen. Maximalt 50 Maximalt 20 Ska matcha mot konton i kontofilen. Anges i formatet: ÅÅÅÅ-MM-DD TT:MM:SS. Bokföringsdatum Datumet för bokföringen. Maximalt 20 Anges i formatet: ÅÅÅÅ-MM-DD TT:MM:SS. Ska vara tomt i första filen. Får ej vara tomt i andra filen. Referens Belopp Vem som är transaktionens betalningsavsändare eller betalningsmottagare. Belopp för transaktionen. Maximalt 50 Maximalt 26 Alfanumeriska inom Får vara tomt. Ska vara i samma valuta som kontot avser. Decimaltal med komma (,) som decimalavskiljare. Kan innehålla värden från -2^63 till 2^63 med en precision på 1/ Exempel på transaktionsfil ( Dag 1 ): Kontonummer Transaktionsdatum Bokföringsdatum Referens Belopp :30:53 Testbolaget AB :30:53 Grejer och sånt AB Exempel på transaktionsfil ( Dag 4 ): Kontonummer Transaktionsdatum Bokföringsdatum Referens Belopp :30: :30:53 Testbolaget AB :30: :30:53 Grejer och sånt AB :00: :00:53 Plötsliga händelser AB -248,5 9

10 Dataformat Datat har nu ordnats i fyra stycken pipe-separerade textfiler med respektive innehåll: Kund Konto Kontofördelning Transaktion Dessa filer ska arkiveras nu till ett 7z-arkiv [1] samt Arkivering och komprimering De fyra textfilerna ska arkiveras och komprimeras till ett 7z-arkiv [1]. Filformat för 7z-arkiv finns specificerat i källkoden till 7-zip [3]. MIME-typen för 7z-arkiv är application/x-7zcompressed. Exempel Skapa de fyra textfilerna enligt filspecifikation i detta dokument. Skapa ett 7z-arkiv av dessa filer: # 7za a -t7z -m0=lzma -mx=9 -mfb=64 -md=32m -ms=on till_riksgalden.7z fil1.txt fil2.txt fil3.txt fil4.txt Obs! Om Windows-versionen av 7-Zip används heter kommandot 7z istället för 7za. Kryptering och signering Det 7z-arkiv som skapats ska nu krypteras och signeras så att den resulterande filen är en fil i Cryptographic Message Syntax (CMS [2] ) -format. Kryptering och signering kan göras med programvaran gpgsm [4], OpenSSL [5] eller annan programvara som är kompatibel med specifikationen för CMS. Godkända krypterings- och hashalgoritmer och nyckellängder måste väljas ur en av Riksgälden given lista som finns nedan i avsnittet Krav på kryptografisk teknik. De certifikat som ska användas för kryptering och signering levereras av VeriSign/Symantec och beställs från Riksgälden. Vid kryptering ska Riksgäldens publika certifikat användas. Det erhålls första gången från Riksgälden i samband med att ett institut ansöker om sitt certifikat. Därefter ansvarar Riksgälden för att skicka ut det publika certifikatet om det byts ut. 10

11 För signering ska det certifikat, som institutet erhållit från Riksgäldens certifikatutgivare VeriSign/Symantec, användas. Som framgår ovan beställs detta certifikat från Riksgälden, se Bilaga 1 Beställning av certifikat. Vid beställning ska beställningsformuläret ( Certificate enrollment request ) fyllas i och skickas in. Institutet ansvarar för att vid var tidpunkt ha ett giltigt certifikat. Senast tre månader före utgången av certifikatets giltighetsperiod ska ett nytt certifikat beställas. Krypteringen ska endast ske med av Riksgälden godkända krypteringsalgoritmer och nyckellängder (se avsnittet Krav på kryptografisk teknik ). Signeringen ska endast ske med hjälp av godkänd hashalgoritm och godkänd krypteringsalgoritm och nyckellängd (se avsnittet Krav på kryptografisk teknik ). Samtidigt som ett institut beställer sitt certifikat så ska man även till Riksgälden uppge en eller flera, dock maximalt fem, unika IP-adresser. Endast dessa adresser kan användas som avsändare när institutet sedan ska ladda upp informationsfilerna till Riksgälden, se avsnittet Uppladdning till Riksgälden. Nedan följer exempel på hur kryptering och signering kan göras med gpgsm respektive OpenSSL. Kryptering och signering (GPGSM) Kryptera och signera detta komprimerade arkiv med hjälp av gpgsm: # gpgsm -e --cipher-algo AES256 -r <filnamn_for_riksgaldens_publika_cert.crt> -o till_riksgalden.7z.krypterat till_riksgalden.7z # gpgsm -s --digest-algo SHA512 -u <filnamn_for_institutets_privata_cert.p12> -o till_riksgalden.7z.krypterat.signerat till_riksgalden.7z.krypterat Obs! I GPG4WIN ska nycklarna läggas in i nyckelringen (t ex med hjälp av Kleopatra) och dess thumbprint användas istället för filnamnen. C:\>gpgsm -e --cipher-algo AES256 -r <thumbprint för riksgäldens publika certifikat> -o till_riksgalden.7z.krypterat till_riksgalden.7z C:\>gpgsm -s --digest-algo SHA512 -u <thumbprint_för_institutets_privata_certifikat> -o till_riksgalden.7z.krypterat.signerat till_riksgalden.7z.krypterat För att komma åt ID för certifikaten kan kommandona nedan användas för de publika respektive privata certifikaten: C:\>gpgsm --list-keys 11

12 C:\>gpgsm --list-secret-keys Obs! Thumbprint för Root CA måste läggas in i trustlist.txt i nyckelringen för att signering och kryptering ska fungera. En rad likt nedan: A1:DB:63:93:91:6F:17:E4:18:55:09:40:04:15:C7:02:40:B0:AE:6B S relax måste läggas in i trustlist.txt som normalt sett är placerad på <användarens profilmapp>\appdata\roaming\gnupg (Platsen kan variera på olika versioner av Windows). Detta är ett fingeravtryck för den root CA hos VeriSign/Symantec som aktuella certifikat ligger under. Kontroll av revokeringslistor För att kontroll av revokeringslistor ska fungera måste certifikat läggas in i någon av följande mappar. Platsen kan variera för olika versioner av operativsystemet. För mer information se dokumentationen för GPG4WIN. C:\Application data\gnu\etc\dirmngr\trusted-certs\ C:\Documents and settings\all Users\Application data\gnu\etc\dirmngr\trusted-certs\ Certifikat med Thumbprints enligt nedan måste läggas i sin helhet i mappen. Formatet måste vara DER och filändelsen måste vara.der eller.crt. Rootcertifikaten kan begäras från Symantec/Verisign eller hämtas från deras webbplats i en zip med samtliga rootcertifikat. Certifikat med följande thumbprints måste placeras i mappen: A1:DB:63:93:91:6F:17:E4:18:55:09:40:04:15:C7:02:40:B0:AE:6B 4E:B6:D5:78:49:9B:1C:CF:5F:58:1E:AD:56:BE:3D:9B:67:44:A5:E5 Kryptering och signering (OpenSSL) Ett alternativ är att kryptera och signera det komprimerade 7z-arkivet med hjälp av OpenSSL [5]. Riksgälden har testat detta med version 1.0.0d. För att använda kommandon nedan måste eventuellt nycklarna konverteras till PEM format, om de nycklarna som mottagits är i DER format. Detta görs på följande sätt: När importen av certifikatet i Kleopatra är slutförd, högerklicka på certifikatet och välj "Export secret keys". Följ sedan instruktionerna för att göra om det exporterade p12 certifikatet till ett PEM certifikat. Kryptera och signera sedan det komprimerade arkivet med hjälp av OpenSSL: 12

13 # openssl pkcs12 -in <filnamn_for_institutets_privata_cert.p12> -out <filnamn_for_institutets_privata_cert.pem> # openssl x509 in <filnamn_for_riksgaldens_publika_cert.crt> inform DER out <filnamn_for_riksgaldens_publika_cert.pem> outform PEM Kryptera och signera det komprimerade arkivet med hjälp av OpenSSL: # openssl cms encrypt binary aes256 -in till_riksgalden.7z -out till_riksgalden.7z.krypterat -outform der <filnamn_for_riksgaldens_publika_cert.pem> # openssl cms -sign binary md SHA512 -in till_riksgalden.7z.krypterat -inform der -out till_riksgalden.7z.krypterat.signerat -outform der - nodetach -signer <filnamn_for_institutets_privata_cert.pem> Som nämnts ovan får även annan programvara användas för kryptering och signering om institutet kan garantera att programvaran som används följer CMS. Restriktioner gällande krypterings- och hashalgoritm och nyckellängd gäller som vanligt. Uppladdning till Riksgälden endast på begäran Den krypterade filen kan nu skickas till Riksgälden genom att starta en webbläsare och ange adressen Följ sedan de instruktioner som visas på webbsidan. Observera att detta endast ska göras på Riksgäldens begäran. Notera att uppladdning till Riksgälden endast kan göras från en av de unika IPadresser som institutet på förhand har angivit till Riksgälden. Obs! Det är viktigt att uppmärksamma eventuella säkerhetsvarningar då man besöker ig.riksgalden.se. Om webbläsaren varnar för problem med certifikat eller att webbplatsen på annat sätt inte är pålitlig, kontakta Riksgälden. Tekniska krav på institutets unika IP-adresser Den eller de IP-adresser som institutet uppger till Riksgäldskontoret ska vara adresser enligt formatet IPv4. Krav på kryptografisk teknik 1. Kryptering ska ske med krypteringsalgoritmen AES Signering ska ske med hashalgoritmen SHA

14 3. Meddelandeformatet ska följa CMS (RFC5652). 4. Anonyma metoder för nyckelutbyte får inte användas. 5. Minsta tillåtna längd på kryptografiska nycklar för asymmetriska algoritmer är 2048 bitar. 6. Väl kända och granskade implementeringar av kryptografiska programvaror ska användas. 7. Det kryptografiska systemet ska ha skydd mot angrepp såsom (i) att någon ställer sig som mellanhand mellan server och klient och på så sätt obehörigen tar del av information (s.k. man-in-the-middle), (ii) repetition, och (iii) fördröjnings attacker. Viktigt att tänka på angående kryptografi och PKI Det är mycket viktigt att: hantera privata nycklar på rätt sätt. verifiera att man verkligen kommunicerar med rätt part. förstå vad kryptografi skyddar mot och ej. Om den privata nyckel man använder på något sätt blir tillgänglig för en angripare så innebär detta kort och gott att all kryptografi baserad på denna nyckel är verkningslös. Data kan avlyssnas och modifieras eller förfalskas enligt en angriparens godtycke. Det är därför av yttersta vikt att man skyddar sin privata nyckel på alla sätt man kan; det absolut bästa, om än inte alltid praktiskt möjligt, är att inte ha den privata nyckeln online någonsin. En sökning på Google med söksträngen e%3aasc ger 88 unika resultat per Detta är alltså personer som gjort sina privata certifikat tillgängliga för alla genom att ha dem på sina webbsiter. Även om man inte delar ut sin privata nyckel på en webbplats så är det viktigt att komma ihåg att den dator man använder kan vara angripen och att även en privat nyckel som inte finns utdelad kan bli kopierad av en angripare. Därför vill vi påpeka igen att det bästa är att inte överhuvudtaget ha den privata nyckeln tillgänglig på en maskin som är online. 14

15 Referenser [1] [2] RFC Cryptographic Message Syntax [3] 7-Zip 9.20 kompilerad rekommenderas [4] (Windows gpg4win rekommenderas) (Unix) [5] 15