In Rapporteket/rapbase: Base Functions and Resources for Rapporteket

dbName <- rapbase::getConfig()[[params$registryName]]$name

Eksport av `r params$registryName`-databasen

Her kan statistikere som jobber med Rapporteket laste ned hele databasen. Formatet som benyttes gjør det enkelt å sette opp en egen database for analyse- og utviklingsformål. Nedlastet fil er kryptert og innholdet er utilgjengelig for alle andre enn definert mottaker. Filen slik den lastes ned kan derfor trygt transporteres og eksponeres offentlig uten fare for at innholdet (registerdata) blir tilgjengelig for andre.

Veiledning

Under følger en kort veiledning for trygg og riktig bruk av eksportfunksjonen.

Nøkkelpar

Mottaker av eksporterte data må være eier av et RSA-type nøkkelpar der den offentlige delen av nøkkelparet er lagt ut på mottakeren sin github-konto. For å ivareta tilstrekkelig sikkerhet bør nøkkellengden være lik eller større enn 2048 bits. Ved behov kan et nytt nøkkelpar lages i R ved bruk av R-pakken sship:

sship::keygen()

Det er viktig at den private delen av nøkkelparet aldri deles med andre og at den kun er tilgjengelig for eieren av nøkkelparet.

Last ned fila

Velg mottaker fra lista til venstre og deretter den nøkkelen som skal benyttes i krypteringen av innholdet. Det er en forutsetning at mottakeren har brukerkonto på GitHub og har lagt ut minst én offentlig RSA-nøkkel der. Valgbare mottakere er bare personer med utvidet tilgang til registerets prosjekt i organisasjonen Rapporteket på GitHub. Det er mulig å angi at fila skal komprimeres før eksport noe som ofte er lurt, særlig hvis registeret inneholder mye data. Trykk deretter Last ned!

Dekryptering av innholdet i fila

Fila slik den er lastet ned er sikret mot innsyn fra andre enn valgt mottaker. Etter dekryptering finnes det ingen slik sikring og det er derfor viktig at dekryptering kun skjer i et område som har en tilstrekkelig ytre sikring, eksempelvis en datamaskin og et filområde på et registerkontor der helse- og personopplysninger kan håndteres med tilstrekkelig lav risiko. R-pakken sship kan benyttes til dekryptering, eksempelvis:

sship::dec("noreg0123456789ab.sql.gz__YYYYMMDD_TTMMSS.tar.gz")

Det finnes andre måter å dekryptere fila på, også utenfor R. Mer om dette og øvrige detaljer finnes i dokumentasjonen av sship.

Dekomprimering av fila (valgfritt)

Hvis man i forbindelse med nedlasting spesifiserte at fila skulle komprimeres så må fila dekomprimeres etter at dekryptering er foretatt. Det finnes mange verktøy for slikt, eksempelvis 7-Zip. Hvis man bruker RStudio kan dette gjøres med en enkel kommando i "Terminal":

gunzip noreg0123456789ab.sql.gz

I eksempelet som er brukt her vil man da ende opp med filen noreg0123456789ab.sql som da kan importeres.

Import av databasen

Eksportfila er etablert ved bruk av mysqldump og kan importeres til en MySQL database. SKDE sitt utviklingsmiljø for Rapporteket er på forhånd satt opp med MySQL og importen kan kjøres med en enkel kommando fra RStudio sin "Terminal":

mysql -h X -u Y -p < noreg0123456789ab.sql

der X og Y er MySQL serverens adresse og et brukernavn for pålogging, henholdsvis. Når denne kommandoen kjøres vil man også bli spurt om passordet til angitt bruker. Verdier for passord, X og Y er definert i oppsettet av utviklingsmiljøet.

Sikkerhet

Sikringen av data slik de lastes ned her er ivaretatt av R-pakken sship i kombinasjon med mottakers egne nøkler og samhandlingsverktøyet Rapporteket på GitHub. Ytterligere detaljer finnes i dokumentasjonen av sship.