Tältä sivulta löydät yksityiskohtaiset ohjeet Kapselin tilaamiseen, käyttämiseen ja tulosten julkaisemiseen Kapselista.
Sisällys
Näin tilaat Kapselin Tietoturvallisen Kapseli-käyttöympäristön käyttö Kapseliin kirjautuminen Tietojen siirto ja kansiorakenne Poistuminen järjestelmästä Kapselin ohjelmistot Omien ohjelmistojen tuonti Kapseliin Omien tiedostojen siirto Kapseliin R-ohjelman CRAN-yleisrepositorion käyttö Tulosten anonymiteetin varmistusNäin tilaat Kapselin
- Kirjaudu asiointipalveluumme: asiointi.findata.fi
- Valitse ylävalikosta ”Jätä hakemus”
- Selaa alaspäin ja valitse ”Valitse alta uusi hakemuslomake” -otsikon alta ”Kapseli-käyttöympäristön tai aineiston säilytyspalvelun tilaus tai päivitys” ja paina sen kohdalla ”Täytä hakemus”
- Täytä hakemuslomake
- Kirjoita Hakija-kenttään oma nimesi
- Lisää sen jälkeen ”Kutsu jäsen…” -painikkeen avulla kaikki ne henkilöt ja sähköpostiosoitteet, jotka tarvitsevat käyttöoikeuden Kapseliin
- Kutsutut henkilöt liittyvät käyttäjiksi käyttäen vahvaa tunnistautumista
- Täytä loput lomakkeesta
- Huom! R-Toolsia ei asenneta automaattisesti Kapseliin. Jos tarvitset R-Toolsia, ilmoita tämä lomakkeen lisätiedoissa
- Valitse lopuksi oikean laidan ”Toiminnot” kohdasta ”Lähetä hakemus”
Tietoturvallisen Kapseli-käyttöympäristön käyttö
Tietoturvallinen Kapseli-käyttöympäristö vastaa hyvin pitkälti oman koneen työpöytää, mutta Kapseli-ympäristön työpöytä on etäyhteyden päässä.
Tietoturvamääräysten takia Kapselin käytössä on muutamia eroja verrattuna tavallisen työpöydän käyttöön:
- Kapseli-käyttöympäristöstä ei ole pääsyä internetiin. Vaikka selain on asennettu, voit käyttää sitä vain paikallisesti esimerkiksi html-muotoisten dokumenttien avaamiseen.
- Tietojen kopioiminen etätyöpöydän ja oman tietokoneen välillä on estetty.
- Kapselin näkymästä ei saa ottaa kuvaa.
- Et voi siirtää mitään tietoja tai kuvia tai muuta materiaalia Kapseliin itsenäisesti, vaan kaikki tietojen siirto tapahtuu Findatan kautta.
Kapselin kanssa käytettävän IP-osoitteen on oltava staattinen eli yleisimmin organisaation IP-osoite. Yleensä etätyössä oman organisaation IP-osoite voidaan saada käyttöön etäyhteyden esim. VPN-yhteyden kautta. Mikäli organisaation yhteyksissä on vaihtuvuutta, kannattaa kysyä oman organisaation IT-tuesta IP-osoitteiden koko osoiteavaruutta, jotta vaihtuvuus ei haittaa Kapselin käyttöä. Kapselia ei voi käyttää yksityisten IP-osoitteiden kautta.
Kapseliin kirjautuminen
Varmista ennen kirjautumista, että käyttäjätunnuksesi on rekisteröity ja käyttövalmis. Jos et ole varma tunnuksesi käyttövalmiudesta, ole yhteydessä Findatan yhteyshenkilöön.
- Asenna Duo Mobile (duo.com) -sovellus matkapuhelimeesi ja aktivoi se (kehittäjä: Duo Security Inc.). Jos olet jo asentanut ja aktivoinut sovelluksen, siirry kohtaan 2.
- Asennus: hae Duo Mobile -sovellus matkapuhelimesi sovelluskaupasta ja asenna se.
- Aktivointi: Kapseli-tilauksen yhteydessä ilmoitettuihin matkapuhelinnumeroihin lähetetään automaattisesti aktivointiviesti Duo Mobilen käyttöä varten. Sovellus aktivoidaan käyttöön klikkaamalla aktivointiviestissä olevaa linkkiä. Jos puhelin vaihtuu, tarvitaan uusi aktivointikoodi.
- Kirjaudu Kapseliin käyttäen tietokoneen verkkoselainta.
- Valitse kirjautumissivulla olevasta listasta se tunnistautumistapa, joka on ilmoitettu rekisteröitymisessäsi. Kirjaudu tunnistautumisen vaatimien välivaiheiden kautta.
- Valitse käytettävissä olevista käyttäjäympäristöistä se, jota aiot käyttää. Jos käytössäsi on vain yksi käyttäjäympäristö, siirry seuraavaan kohtaan.
- Valinnan jälkeen järjestelmä siirtyy tunnistautumisen toiseen vaiheeseen.
- Kaksivaiheisen tunnistautumisen toinen vaihe.
- Kirjaudu käyttäjäympäristöön.
- Saat Duo Mobileen ilmoituksen kirjautumisyrityksestä. Tekemäsi kirjautuminen hyväksytään Duo Mobilen kautta valitsemalla ”Approve”.
Tietojen siirto ja kansiorakenne
Kapseli-käyttöympäristön kaikki ohjelmistoasennukset ja tietojen siirrot tapahtuvat tilausten ja tarkastusten kautta. Et voi viedä tietoja itsenäisesti Kapseliin tai tuoda tietoja ulos Kapselista.
Tietoluvassa määritellään ne tiedot, joiden käsittelyyn lupa on myönnetty. Kokoamme, yhdistelemme, esikäsittelemme ja tarvittaessa pseudonymisoimme ja anonymisoimme tiedot. Tietojen käytössä tarvittava lisätieto, esimerkiksi julkisesti saatavilla oleva tilastotieto, vaatii myös Findatan tarkastuksen ja tietojen siirron Kapseliin.
Kapseli-käyttöympäristöstä löytyy seuraava kansiorakenne:
- Data (D:)
- Backup (E:)
- CRAN (N:)
- Output (O:)
- Work (W:)
Tietoluvassa määritellyt tiedostot ovat saatavilla Data (D:) -asemalta. Data-asema on kirjoitussuojattu. Myös muut Kapseliin toimitettavat tiedostot, kuten mahdolliset ohjelmakoodit, siirtyvät Data-asemalle tarkastuksen jälkeen.
Työskentelyä varten on käytettävissä Work (W:) –kansio, jonne käytettävät tiedostot kannattaa kopioida Data-asemalta.
Tietojen siirtoon tarkoitetusta Output (O:) -kansiosta tiedot siirretään tarvittaessa Findatalle. Sovi Output-aseman käytöstä etukäteen Findatan kanssa. Älä siirrä tuloksia tätä kautta.
Vie varmuuskopioitavat tiedot Backup (E:) -kansioon.
CRAN (N:) -kansio sisältää R-ohjelmiston käyttämiseen tarvittavia ohjelmistopaketteja.
Poistuminen Kapselista
Voit lopettaa etätyöpöydän käytön kahdella eri tavalla käyttötilanteesta riippuen.
- Sign out + Log out (suositeltu tapa)
- Sign out löytyy vasemmassa alareunassa olevan ihmishahmo‑kuvakkeen takaa. Käytä tätä vaihtoehtoa, kun olet lopettanut tietojen käsittelyn etkä jätä ajoja pyörimään.
- Kun valitset Sign out ja sen jälkeen Log out, vapautat Kapselin resurssit muiden käyttäjien käyttöön.
- Huom! Kun painat Sign out, voi kestää useita minuutteja ennen kuin Log out ‑vaihtoehto tulee näkyviin. Tämä johtuu Windowsin tavasta käyttää resursseja ja kesto riippu käynnissä olevista prosesseista.
- Disconnect
- Disconnect löytyy Power‑painikkeen takaa.. Käytä tätä vaihtoehtoa, jos jokin ajo pitää jättää pyörimään, kun poistut työasemalta. Resurssit jäävät tällöin varatuksi.
Molempien vaihtoehtojen jälkeen näet vaihtoehdot Reconnect ja Logout. Valitse uloskirjautuessa vaihtoehto Logout. Sulje selain, jos et halua kirjautua takaisin.
Kapselin ohjelmistot
Kaikkiin uusiin Kapseleihin asennetaan vakiona alla olevasta taulukosta löytyvät ohjelmistot. Laajennamme ohjelmistovalikoimaa tarvittaessa.
Pidätämme oikeuden muuttaa Kapseliin sisältyviä vakio-ohjelmistoja. Ilmoitamme tilaajille muutoksista kirjallisesti vähintään kuukautta (1) aiemmin.
Ohjelmistot päivittyvät tietoturvaan liittyvissä päivityksissä kaikkiin konepaketteihin tarpeen mukaan.
Kapselin ohjelmistopäivitykset ovat automatisoituja
- Jokaisessa Kapselissa on käytettävissä vain yksi versio kustakin ohjelmistosta.
- Oletuksena asennetaan uusin tuettu versio, joka ei välttämättä ole sama kuin verkosta saatavilla oleva uusin versio.
- Ohjelmistojen versiot päivitetään automaattisesti kaikkiin Kapseleihin vuosittain tai jos havaitaan tunnettuja tietoturvauhkia.
- Vanhempia versioita voi yhä käyttää, mutta niiden ylläpito ja tuki aiheuttavat lisäkustannuksia.
Jos tarvitset käyttöösi vanhemman version, ota yhteyttä osoitteeseen kapseli@findata.fi.
Linux-käyttöjärjestelmä (Ubuntu)
| Ohjelmisto | Versio | Lisätietoja |
| Chromium | Ajantasainen | |
| Emacs | Ajantasainen | |
| Firefox | Ajantasainen | |
| Gnome System Monitor | Ajantasainen | |
| Golang | Ajantasainen | |
| Josm | Ajantasainen | |
| LibreOffice | Ajantasainen | Base, Calc, Draw, Impress, Math, Writer |
| Pigz | Ajantasainen | |
| Python | 3.12 | Sisältää seuraavat paketit: tensorflow nltk spacy scikit-learn seaborn plotly bokeh pydot xgboost lightgbm catboost eli5 torch keras gensim scrapy beautifulsoup4 numpy scipy pandas statsmodels matplotlib trio httpx qrcode |
| R + R studio | 4.2.1 | Käytössä CRAN-kirjaston paketit. R:n saa käynnistettyä terminaalin kautta komennolla: start-rdesktop. |
| VS Code | Ajantasainen |
Windows-käyttöjärjestelmä (Windows Server 2016 Standard)
| Ohjelmisto | Versio | Lisätietoja |
| 7-Zip | Ajantasainen | |
| Adobe Acrobat Reader DC | Ajantasainen | |
| Anaconda 3 | 2024.06-1 | Käyttää Python Wheeliä 3.12 |
| GeoDa | 1.22 | |
| Git | 2.46.1 | |
| Google Chrome | Ajantasainen | |
| IBM SPSS Statistics | 29 | Lisenssi aktivoidaan pyynnöstä. |
| LibreOffice | Ajantasainen | Base, Calc, Draw, Impress, Math, Writer |
| LyX | 2.4.1.1 | |
| MiKTeX | 24.1 | |
| Notepad++ | Ajantasainen | |
| QGIS | 3.34.11 | |
| R | 4.4.1 | Sisältää itse asennettavat CRAN-kirjaston paketit, asennusohjeet Kapselin käyttöohjeissa. Huom! R-Toolsia ei asenneta automaattisesti Kapseliin. Jos tarvitset R-Toolsia, ilmoita siitä tilauslomakkeen lisätiedoissa. |
| RStudio | 2024.09.0-375 | |
| Stata | 19 | Lisenssi aktivoidaan pyynnöstä. |
| WinPython | 3.12 | Kysy tarvittaessa lisätiedot paketeista asiakaspalvelustamme: kapseli@findata.fi |
Lisäohjelmistojen tilaus
Jos tarvitset muita kuin peruspakettiin kuuluvia ohjelmistoja tai tilasto-ohjelmien paketteja, voimme asentaa niitä erillisenä maksullisena tilauksena. Kysy lisäohjelmistojen asennuksesta lähettämällä viesti osoitteeseen kapseli@findata.fi.
Kaupallisten ohjelmistojen osalta asennuksen yhteydessä varmistetaan asianmukaisten lisenssien voimassaolo. Muiden asennettavien ohjelmistojen osalta tietoturvan ja tietosuojan varmistaminen on keskeistä ja pyydettäessä sinun tulee toimittaa selvitys tai sertifikaatti.
Veloitamme omien työkalujen ja ohjelmistojen asennuksesta Kapseliin työmäärän mukaisesti. Myös mahdolliset päivitystoimet ovat maksullisia. Katso ajantasaiset hinnat Hinnastosta.
Huomioithan, että Findata ei voi taata käyttäjän omien ohjelmistojen toimivuutta etäkäyttöympäristössä. Veloitamme asennuksesta koituvat kulut siinäkin tapauksessa, että ohjelmistoa ei voi käyttää asiakkaan suunnittelemalla tavalla Kapselissa.
Omien tiedostojen siirto Kapseliin
Kapseli toimii projektin työpöytänä koko aineiston käsittelyn ajan. Lähtökohtaisesti aineistojen käsittely tapahtuu Kapselissa, eli vain valmiit analyysitulokset tuodaan järjestelmän ulkopuolelle. Myös analyysiin tarvittava ohjelmakoodi tuotetaan lähtökohtaisesti Kapselissa.
Käytännössä kuitenkin monesti analyysirunkona toimii jokin aiempi ohjelmakoodi. Aiempien koodien ja muiden omien tiedostojen, kuten tutkimusprotokollan ja muuttujien kuvausten tuominen Kapseliin on mahdollista Findatan kautta. Huomaathan, että ohjelmistoja tai tilasto-ohjelmien paketteja ei voi tuoda itse Kapseliin.
Veloitamme omien tiedostojen tuomisesta Kapseliin työmäärän mukaisesti. Katso ajantasaiset hinnat Hinnastosta.
Näin toimitat tiedostot Kapseliin
Ilmoita aineistoistasi Findatalle
Lähetä omista aineistoistasi Findatalle ilmoitus osoitteeseen data@findata.fi. Kerro viestissäsi
- tietoluvan diaarinumero,
- Kapseli-käyttöympäristön tunnus (esim. a01),
- Siirtopalvelu Tunnelin tunnuksesi, jos sinulle on jo avattu Nextcloud- tai Tunneli-yhteys. Jos sinulla ei ole vielä Tunneli-tunnusta, siirry seuraavaan kohtaan.
Löydät Tunneli-tunnukset seuraavalla tavalla:
- Kirjaudu Tunneli-tilillesi.
- Paina oikeassa yläreunassa olevaa profiilikuvaketta.
- Valitse Asetukset. Tunnuksesi on FINDATA.local -loppuinen.
Tilaa Tunneli-tunnus
Jos sinulle on jo avattu Tunneli-yhteys, siirry seuraavaan kohtaan.
- Selvitä ensin, mikä on organisaatiosi julkinen IP-osoite sille verkolle, josta aineisto siirretään. Ole tarvittaessa yhteydessä oman organisaatiosi IT-tukeen. Seuraavat osoitteet eivät ole julkisia, eivätkä ne siten kelpaa aineiston siirtoon:
- Osoitteet, jotka alkavat
- 10.
- 192.168.
- Osoitteet, jotka ovat väliltä
- 172.16.0.0–172.31.255.255
- 224.0.–239.255.
- Osoitteet, jotka alkavat
- Siirry Findatan asiointipalveluun osoitteessa asiointi.findata.fi ja täytä siellä oleva lomake ”Uuden Tunneli-tunnuksen tilaus”.
- Lähetä lomake.
- Ilmoita sähköpostitse osoitteeseen data@findata.fi, että olet tehnyt tilauksen Tunneli-tunnuksista. Jos rekisteröitymistä varten tarvitaan lisätietoja, Findatan asiantuntija on yhteydessä sinuun sähköpostitse.
- Kun saat Findatalta ilmoituksen, että yhteys on avattu, siirry seuraavan kohtaan.
Täytä Kapseliin toimitettavat tiedostot -lomake
- Täytä alla oleva lomake ja toimita se Findataan Tunneli-siirtopalvelun kautta Findatalle samassa siirtokansiossa kuin omat tiedostosi.
- Jos olet toimittamassa aineistoja, toimita samassa siirtokansiossa myös siihen liittyvä aineistokuvaus.
Lataa Kapseliin toimitettavat tiedostot -lomake (Word-tiedosto, 30,2 kt)
Salaa aineistosi ja siirrä se Tunneliin
- Kirjaudu Tunneli-siirtopalveluun osoitteessa siirto.findata.fi.
- Käytä samaa tunnistautumistapaa, kuin muissa Findatan järjestelmissä.
- Varmista, että diaarinumero on oikein.
- Etsi etusivulta kansio, jonka otsikkona on tietolupapäätöksen diaarinumero. Tarkista, että diaarinumero on oikein.
- Avaa kansio ja tarkista, että siellä olevan tiedoston journal_number.txt sisältämä diaarinumero on myös oikea.
- Luo koneellesi uusi kansio. Varmista, että kansioon ei ole käyttöoikeutta muilla kuin aineiston käsittelyyn oikeutetuilla henkilöillä.
- Lataa Tunnelista seuraavat tiedostot kansioon:
- Findata Encryption Tool: Tämä tiedosto löytyy Salaustyökalut-kansiosta. (Huom. Joissakin organisaatioissa lataus saattaa edellyttää IT-tuen hyväksyntää.)
- csc.pub: Tämä tiedosto löytyy myös Salaustyökalut-kansiosta.
- journal_number.txt: Lataa tämä tiedosto klikkaamalla kolmea pistettä tiedoston perässä ja valitsemalla ”Lataa”.
- Pakkaa kaikki siirrettävät aineistot yhdeksi zip-tiedostoksi ja siirrä se aiemmin luomaasi kansioon.
- Pakkaa mukaan myös aineistokuvaukset.
- Varmista, että zip-tiedoston koko ei ylitä 4 GB:aa.
- Varmista, että tiedosto on aineiston toimituspyynnössä määritellyssä muodossa.
- Varmista, että tiedoston nimessä ei ole välilyöntejä tai erikoismerkkejä (/,?+)[). Sallittuja erikoismerkkejä ovat piste, tavuviiva sekä alaviiva (.-_).
- Avaa kansiosta Findata Encryption Tool.
- Valitse salattava tiedosto, eli kohdassa 4 tekemäsi zip-tiedosto painamalla ”Select File” -painiketta.
- Käynnistä salausprosessi painamalla ”Start Encryption”.
- Koneella olevaan kansioosi pitäisi nyt tulla näkyviin kaksi uutta tiedostoa:
- .c4gh-päätteinen tiedosto
- .json-päätteinen tiedosto
- Avaa projektin diaarinumeroa vastaava kansio Tunnelissa.
- Lataa molemmat kohdassa 8 luomasi tiedostot kyseiseen Tunneli-kansioon.
- Tunneli-kansiossasi pitäisi nyt olla seuraavat kolme tiedostoa:
- journal_number.txt
- c4gh-päätteinen tiedosto
- .json-päätteinen tiedosto
- Kirjaudu ulos järjestelmästä ja ilmoita Findatan käsittelijälle, että aineisto on siirretty.
- Kun Findatan käsittelijä on vahvistanut sinulle aineiston siirron onnistuneen, poista kaikki henkilötietoaineistot omalle koneellesi luomastasi poimintakansiosta.
- Tyhjennä tietokoneen roskakori.
R-ohjelman CRAN-yleisrepositorion käyttö
Cran-yleisrepositorio löytyy osoitteesta: https://cran.findata.local/
- Poista .Renviron -tiedosto Documents -kansiosta tai Projekti -kansiosta (WORK). Voit vaihtoehtoisesti muokata tiedostoa ja poistaa seuraavia rivejä:
- RSTUDIO_DISABLE_PACKAGES=TRUE
- R_LIBS_USER=N:/
- Luo .Rprofile-tiedosto Documents -kansioon alla olevilla tiedolla:
local({
r ←getOption(”repos”)
r[”CRAN”] <-”https://cran.findata.local/”
options(repos = r)
})- Voit myös kopioida .Rprofile-tiedoston D:\-asemalta (DATA)
- Käynnistä RStudio uudelleen.
- Voit asentaa R-paketteja install.packages(”PACKAGE”)-komennolla.
- Jos haluat mieluummin käyttää graafista käyttöliittymää pakettien asentamiseen, löydät sen RStudiosta kohdasta Tools -> Install Package. Kun paketti on asennettu, lataa paketti library()-toiminnolla.
Pakettien asennus on myös mahdollista tilata palveluntarjoajalta, jolloin siitä veloitetaan hinnaston mukaiset työaikakustannukset: Hinnasto
Tulosten anonymiteetin varmistus
Kapselista ulos tuotavat tulokset tulee olla anonyymeja. Findata varmistaa tulosten anonymiteetin riskiperusteisen arvioinnin perusteella, joka tehdään Kapselin Portti-työkalun avulla.
Katso ohje: Anonyymien tulosten tuottaminen
Aineistojen siirto ulos Kapselista
Aineistoja ei saa siirtää ulos sellaisenaan käyttöympäristöstä. Jos aineistojen käsittely-ympäristö vaihtuu tai aineistoa tarvitaan jatkopoimintoja varten, voit toimittaa aineistot Findatalle Kapselin Output-aseman kautta.
Ota Findataan yhteyttä ennen siirtoa: kapseli@findata.fi.
