Kansallisarkisto. SÄHKE2-siirtotiedoston testauspalvelu

Transkriptio

1 Kansallisarkisto SÄHKE2-siirtotiedoston testauspalvelu Kansallisarkisto Rauhankatu 1 PL 258, 0011 Helsinki Puh. Tel. (09) kansallisarkisto@narc.fi Riksarkivet Fredsgatan 1 PB 258, 0011 Helsingfors Fax (09)

2 2 (8) Sisällysluettelo 1. JOHDANTO 3 2. AINEISTON SIIRROSTA ARKISTOLAITOKSEEN 3 3. SIIRTOTESTAUSPALVELU Testauspalvelun käytön edellytykset Palvelun laajuus 3.3. Palvelun kustannukset 3.. Palvelun tulos 3.5. Tilaaminen 3.. Testauspalveluun liittyvien tehtävien suorittaminen Aineiston siirtäjä / palvelun tilaaja Arkistolaitos / testauspalvelun tarjoaja Testaamiselle asetetut tekniset rajoitukset Testien uusiminen 5. AINEISTOLLE TEHTÄVÄT AUTOMAATTISET TESTIT 5.1. Virustarkistus 5.2. Siirtokokonaisuuden sähköisen allekirjoituksen varmistaminen.2.1. Testin tarkoitus.2.2. Allekirjoittajan todentaminen.2.3. Allekirjoitetun kokonaisuuden eheyden toteaminen.3. XML-rakenteiden tarkistaminen.3.1. XML-syntaksin tarkistus.3.2. SÄHKE2-skeeman mukaisuus.3.3. Sisällön viittausten looginen eheys.. Asiakirjatiedostojen formaattien tarkistaminen..1. Pitkäaikaissäilytettävät muodot..2. Muut tiedostomuodot 5. AINEISTOLLE TEHTÄVÄT MANUAALISET TARKISTUKSET 5.1. Metatiedot 5.2. Tiedostokonversiot 8. LISÄTIETOJA 8. LIITTEET 8 LIITTEET

3 3 (8) 1. JOHDANTO SÄHKE2-siirtotiedoston testauspalvelun avulla voidaan varmistua siirtotiedoston sekä teknisestä että sisällöllisestä määritystenmukaisuudesta. Palvelun avulla toimivaksi todennettu siirtotoiminnallisuus on edellytys sähköisen säilyttämisen luvalle. Palvelun avulla varmistetaan automaattisesti siirtotiedoston metatietorakenteen SÄH- KE2-mukaisuuden, asiakirjakonversioiden formaatit sekä tuotettujen eheystarkisteiden toimivuus. Lisäksi tehdään manuaalisesti aineiston sisällöllinen SÄHKE2- vastaavuuden toteaminen ja asiakirjakonversioiden käytettävyyden toteaminen. Tässä palvelukuvauksessa kuvataan testauspalvelun käytön edellytykset sekä käyttötapa. Ennen tähän palvelukuvaukseen tutustumista, on syytä olla lukenut arkistolaitoksen laatima erillinen siirto-ohje, jonka määrittelyihin useat tässä käytetyt termit ja toiminnot viittaavat AINEISTON SIIRROSTA ARKISTOLAITOKSEEN Organisaation, joka siirtää aineistoa arkistolaitoksen VAPA-järjestelmään, vastuulla on tuottaa SÄHKE2-määräyksen mukainen siirtokokonaisuus ja huolehtia mahdollisten siirtopakettiin liittyvien virheiden korjaamisesta. Testausta varten tulee testaajan tuottaa testiaineisto, joka edustaa kattavasti niitä rakenteita jotka ovat normaalissa tuotantokäytössä tyypillisiä. Tässä ohjeessa on kuvattu manuaalista testausta varten tuotettavat testitapaukset. Siirtovaiheessa testi aineisto poimitaan siirto-ohjeessa kuvatulla tavalla ja valmistellaan SÄHKE-määräyksen edellyttämään muotoon ja siirretään VAPAtestijärjestelmään. Siirron jälkeen VAPA testijärjestelmä tarkistaa automaattisesi siirron onnistuminen ja raportoi havaituista virheistä. Mikäli aineiston vastaanotossa havaitaan virheitä, informoidaan niistä siirtävää tahoa. Virheet johtavat aina koko siirtopaketin hylkäämiseen, ja se on muodostettava ja lähetettävä uudestaan korjattuna. Uudelleenlähettäminen koskee siirtokokonaisuuden kaikkia osia. Siirtoon liittyvät yksityiskohdat ja vaiheet on kuvattu yksityiskohtaisemmin siirtoohjeessa 3. SIIRTOTESTAUSPALVELU 3.1. Testauspalvelun käytön edellytykset Palvelun käyttö edellyttää Palvelun tilaamista tilauslomakkeella Palvelun tilauksen yhteydessä tehtyjen palomuuriavausten tilaamista ja toimivuuden todentamista testipalvelun hyödyntäjän toimesta. Aineiston allekirjoittajan yksilöintiä tilauslomakkeella Organisaatiolta tietojärjestelmää, jossa on SÄHKE2-määräyksen mukaiset siirtotiedoston laatimistoiminnot 1 Ohje SÄHKE -aineistojen siirtämiseksi arkistolaitoksen VAPA-järjestelmään

4 (8) Organisaation itse tuottamaa testiaineistoa Sovellusta tai järjestelmää, jonka avulla siirtokokonaisuus voidaan siirtää testijärjestelmään Palvelun laajuus Testauspalvelun peruspaketti kattaa seuraavat tehtäväkokonaisuudet VAPA-järjestelmään tehtävät määräaikaiset palomuuriavaukset Yhden siirtotunnuksen VAPA-testijärjestelmään Yhden VAPA-järjestelmään luotavan allekirjoittajan tunnuksen luomisen ja varmenteen liittämisen (1 kpl) Yhden VAPA-järjestelmän raportointitunnuksen luomisen automaattisesti toimitettavat testiraportit raportointiliittymän käytön testauksen aikana manuaalitarkistukset kahdesta testipaketista, joista tarkistetaan yhteensä 10 tehtävää ja 10 konvertoitua asiakirjaa Palvelun kustannukset Siirtotiedoston testauspalvelun peruspaketin hinta sisältyy sähköisen säilyttämisen lupahakemuksen hintaan. Mahdollisista asiakkaan erikseen tilaamista lisäselvitystöistä liittyen esim. siirtotiedoston muodostamiseen liittyvien yksityiskohtien konsultointiin, veloitetaan erillisen konsultointipalkkion mukainen tuntihinta (120e/tunti). 3.. Palvelun tulos Siirtotiedoston testauspalvelua hyödyntänyt organisaatio saa testauksen jälkeen arkistolaitokselta todistuksen hyväksytysti suoritetusta testisiirrosta. Hyväksytyn testituloksen saaminen edellyttää, että teknisiä virheitä ei löydy, siirretty aineisto on manuaalisissa testeissä todettu riittävän laajaksi ja sisällöllisesti SÄHKE2- määräyksen mukaiseksi Tilaaminen Siirtotiedoston testauspalvelu tilataan liitteenä olevalla lomakkeella. Tilauslomakkeen yhteydessä olevalla palomuuriavauslomakkeella tulee tilata tarvittavat palomuuriavaukset testattavasta järjestelmästä VAPA-järjestelmän testijärjestelmään. Palomuuriavaukset ovat voimassa testipalvelun voimassaolon ajan, oletusarvoisesti kaksi (2) kuukautta. 3.. Testauspalveluun liittyvien tehtävien suorittaminen Aineiston siirtäjä / palvelun tilaaja Aineistoa siirtävän tahon vastuulla on varmistua siitä, että testauksessa käytettävä aineisto ei sisällä todellista käyttörajoitettua asiakirjallista tietoa (asiakirjat ja metatiedot). tehdä korjaukset aineistoon ja/tai siirtävään järjestelmään havaittujen virheiden pohjalta

5 5 (8) huolehtia siitä, että VAPA-palvelun testaamiseen käytettävät tunnukset säilyvät vain testiin osallistuvien tahojen käytössä Arkistolaitos / testauspalvelun tarjoaja vastaa siitä, että testaamiseen käytettävä VAPA-testijärjestelmä on testaajan käytettävissä testiin sovitun ajan. virheisiin liittyvän tulkinta ja opastus palvelun tarjoamisesta virheiden selvittämiseksi manuaalisten testien suorittamisesta ja raportoinnista siten kuin tässä palvelukuvauksessa on esitetty 3.. Testaamiselle asetetut tekniset rajoitukset Vastaanottoliittymä käsittelee organisaatiokohtaisessa työjonossaan yhden siirtopaketin kerrallaan. Tämän vuoksi uusi testiaineisto voidaan lähettää testijärjestelmään vasta sen jälkeen kun edellisen testin tulos on valmistunut. Testipalvelu ei erikseen rajoita suoritettavien testien lukumäärää. Kerrallaan siirrettävän testiaineiston koko ei saa ylittää seuraavia arvoja: Tehtävien (asia) lukumäärä enintään 100, asiakirjatiedostojen määrä enintään 1000, yhteenlaskettu siirtotiedoston koko 2GB Testien uusiminen Testien määrää ei ole rajoitettu. Organisaatio voi hyödyntää automaattista testauspalvelua myös myöhemmin, esim. siinä tapauksessa että järjestelmään tehdään merkittäviä versiomuutoksia ja halutaan varmistaa siirron onnistuminen. Uusintatestit suoritetaan samoilla tunnuksilla kuin ensimmäiset testit. Koska palomuuriavaukset ovat määräaikaisia, tulee ennen testien suorittamista ottaa yhteyttä testipalveluun ja sopia avausten suorittamisesta.. AINEISTOLLE TEHTÄVÄT AUTOMAATTISET TESTIT Automaattisten testien tulos on aina joko hyväksytty tai hylätty. Hylätyn testin tulokseen liittyy VAPA-järjestelmän tuottama kuvaus havaituista virheistä sekä arkistolaitoksen siirtotestauspalvelun tuottama tukiraportti, jossa on selvennetty virheitä ja annettu mahdollinen suositus virheen korjaamisen toteuttamisesta. Organisaatio voi toistaa hyväksytyn ja/tai hylätyn testin..1. Virustarkistus Siirretty aineisto tarkistetaan sekä mahdollisesti aineiston mukana tulevien haittaohjelmien että aineistossa itsessään olevien virusten, kuten mm. makrovirukset osalta. Virustarkistus tehdään ennen varsinaisia aineiston sisältöön kohdistuvia tarkistuksia ja siinä tapauksessa jos yhdestäkään aineistoon liittyvästä tiedostosta löytyy virus, koko siirto keskeytetään eikä muita testejä suoriteta. Todellisten virusten tai haittaohjelmien välittäminen palvelun testaamiseksi ei ole sallittua. Mikäli kuitenkin aineiston siirtäjän tavoitteena on testata oman siirtoprosessin

6 (8) toimivuutta näissä tapauksissa, on mahdollista välittää ns. testivirus 2, joka on todellisuudessa harmiton tiedosto, mutta joka kuitenkin tulkitaan virustarkistuksessa virukseksi..2. Siirtokokonaisuuden sähköisen allekirjoituksen varmistaminen.2.1. Testin tarkoitus Siirretyn aineiston autenttisuuden varmistamiseksi vastaanoton yhteydessä tarkistetaan, että aineisto on ehyt ja muuttumaton kokonaisuus joka koostuu asiakirjatiedostoista sekä metatiedoista. Allekirjoituksen avulla voidaan varmistua siitä, että siirtopaketin on tuottanut oikea taho ja että siirron aikana kokonaisuus ei ole muuttunut. Testauspalvelun tarkoitus on todentaa se, että siirtopaketin yhteyteen liitetty ns. varmiste.sig -tiedosto, joka sisältää eheys ja allekirjoitustiedot, on oikein laadittu ja että sen avulla voidaan sekä eheys että siirtäjä varmistaa Allekirjoittajan todentaminen Aineiston siirtäjän tulee toimittaa aineiston allekirjoittajan tiedot testauspalvelun tilauslomakkeella. Mikäli allekirjoituksessa käytetään vrk:n myöntämää sertifikaattia, on tämä yksilöitävä lomakkeessa. Siinä tapauksessa, että allekirjoittamisessa käytetään jotain muuta menettelytapaa, on tämä kuvattava sekä toimitettava sertifikaattiin liittyvä julkinen avain. Testin tulos on joko hyväksytty tai hylätty. Hylätyn testin tulokseen liittyy kuvaus havaituista virheistä Allekirjoitetun kokonaisuuden eheyden toteaminen Siirretyistä testiaineistoista todennetaan että metatietotiedostoista tuotetut eheystarkisteet on tuotettu siirto-ohjeen mukaisella tavalla ja ne kyetään ohjelmallisesti validoimaan. Siirrettyjen asiakirjojen eheys varmistetaan vertaamalla metatietotiedostoihin tallennettuja tiedostokohtaisia eheystarkisteita. Testin tulos on joko hyväksytty tai hylätty. Hylätyn testin tulokseen liittyy kuvaus havaituista virheistä..3. XML-rakenteiden tarkistaminen.3.1. XML-syntaksin tarkistus Metatiedot täytyy tallentaa XML-syntaksin mukaiseen rakenteeseen. XML:n tulee olla tämän mukaisesti well-formed. Tämän tarkistamisessa käytetään XMLsyntaksivalidointia. Testin tulos on joko hyväksytty tai hylätty. Hylätyn testin tulokseen liittyy yksilöity kuvaus havaituista virheistä XML-rakenteessa SÄHKE2-skeeman mukaisuus Metatiedot täytyy tallentaa SÄHKE2-skeeman mukaiseen rakenteeseen. XML:n tulee olla tämän mukaisesti valid. Validoinnin yhteydessä tarkistetaan skeemassa määritel- 2

7 (8) lyt pakolliset rakenteet sekä määriteltyjen arvojoukkojen mukaisuus. Tämän tarkistamisessa käytetään XML-validaattoria. Testin tulos on joko hyväksytty tai hylätty. Hylätyn testin tulokseen liittyy yksilöity kuvaus havaituista virheistä XML-rakenteessa Sisällön viittausten looginen eheys Siirretylle testiaineistolle tehdään seuraavat metatietoihin sekä viittauksiin liittyvät testit: Tarkistetaan, että kaikki siirron metatiedoissa mainitut tiedostot ovat siirrossa mukana Viittaukset siirtotiedoston sisällä asiakirjojen ja tehtävien välillä ovat eheät.. Asiakirjatiedostojen formaattien tarkistaminen..1. Pitkäaikaissäilytettävät muodot Vastaanoton yhteydessä tarkistetaan, että ne siirretyt asiakirjatiedostot, jotka ovat tyypiltään Arkisto (ks. siirto-ohje) on arkistolaitoksen hyväksymässä muodossa. Tämä tarkistaminen tehdään käyttäen hyväksi DROID/JHOVE välineitä, jotka tarkistavat formaatin oikeellisuuden tiedoston ominaisuuksista...2. Muut tiedostomuodot Siirron mukana on mahdollista toimittaa myös aktiivikäyttöä tukevia asiakirjatiedostoja, joiden säilytysmuoto on pitkäaikaissäilytysmuodosta poikkeava. Näiden tiedostojen lisäksi on oltava aina myös pitkäaikaissäilytysmuoto liitettynä. Vastaanoton yhteydessä näiden tiedostojen formaatteja ei tarkisteta. 5. AINEISTOLLE TEHTÄVÄT MANUAALISET TARKISTUKSET Manuaalisten testien tulos voi olla joko hyväksytty, hylätty tai korjaussuositus. Raportti tuotetaan arkistolaitoksen siirtotestauspalvelun toimesta niistä testiaineistoista, jotka testipalvelun käyttäjä osoittaa manuaalisesti testattavaksi. Tämä tulee ilmoittaa ottamalla yhteyttä siirtotestauspalveluun ja yksilöimällä se siirtopaketti, joka halutaan manuaalisesti testattavaksi. Organisaatio voi toistaa hyväksytyn ja/tai hylätyn testin. Testien määrää ei ole rajoitettu Metatiedot Siirrettyyn aineistoon liittyvistä metatiedoista tarkistetaan mm. seuraavat elementit. Numerointi viittaa SÄHKE2-metatietomallin kohtiin. Julkisuusluokka (2..1): julkisuusluokan arvon tulee perustua skeemassa määriteltyyn arvojoukkoon. Salassapitoaika (2..2): salassapitoajan tulee olla numeerinen kokonaisluku Salassapitoperuste salassa pidettäville (2..): Mikäli salassapitoaika on määritelty, tulee myös peruste olla olemassa. Perusteen sisältö tarkistetaan manuaalisen testin yhteydessä

8 8 (8) Turvallisuusluokka salassa pidettävälle (2..): Tulee perustua skeemassa määriteltyyn arvojoukkoon. Henkilötietoja (2..): arvon tulee perustua skeemassa määriteltyyn arvojoukkoon. Säilytysajan pituus (2.11.1): Koska VAPA ottaa vastaan vain pysyvästi säilytettäviä aineistoja, tulee säilytysajan olla SP, eli pysyvä. Säilytysajan peruste (2.11.2): Peruste tulee olla annettu ja sen sisältö tarkistetaan manuaalisen testin yhteydessä Säilytysajan päättymisperuste määräajan säilytettäville (2.11.3): Hävitettyjen aineistojen yhteydessä tulee olla peruste ilmoitettu Tila (2.12): Tilan arvo tulee olla annettu. Tehtävä (2.13): Tulee olla annettu Tyyppi (2.15): Tulee olla annettu 5.2. Tiedostokonversiot Asiakirjojen konvertoinnin tuloksen onnistuminen pitkäaikaissäilytysmuotoihin tarkistetaan kohdan..1 lisäksi myös silmämääräisesti, jotta voidaan havaita mahdolliset käytettävyyteen tai konversioasetuksiin liittyvät ongelmat. Konversioiden onnistumisen varmistaminen edellyttää, että tiedostoista on myös natiivimuodot siirretty. Testin yhteydessä tarkistetaan manuaalisesti mm. seuraavat Merkitykselliset värit eivät ole kadonneet Mahdolliset kuvat ovat säilyttäneet käytettävyytensä Asiakirjassa olevat automaattiset päiväykset ym. makrot eivät ole muuttaneet tiedoston sisältöä. konversiossa ei ole tapahtunut muita havaittavia virheitä Kattavien testien varmistamiseksi organisaation tulee sisällyttää testiaineistoon asiakirjoja, jotka On tuotettu kaikilla niillä mahdollisilla tiedostokonverttereilla, joita organisaatiolla on käytössä Konversion lähteenä on käytetty kaikkia tiedostomuotoja, joita organisaatiolla on käytössä Asiakirja sisältää kuvia sekä kaavioita siinä laajuudessa ja muodossa kuin organisaatiossa yleisesti käytetään. LISÄTIETOJA VAPA-palvelusta: Aineiston siirtämisestä VAPA-järjestelmään: LIITTEET Tilauslomake