Päivitetty 06.05.2022

Kapseli user guide

On this page you’ll find simple instructions for ordering Kapseli, using it and verifying the results.

Instructions for using the secure operating environment Kapseli

The user interface of Kapseli is very much in line with the desktop of your own computer, but the desktop of Kapseli is at the end of a remote connection. Due to security regulations, there are a few differences in use of Kapseli compared to the use of an ordinary desktop.

  • There is no Internet access from Kapseli. Although the browser is installed, it can only be used locally, such as for opening documents in the HTML format.
  • Copying data between the remote desktop and your own computer is blocked.
  • It’s not allowed to take any photo of Kapseli.
  • No data, images or other material can be transferred independently to Kapseli, instead all data is transferred through Findata’s audits. 
How to order Kapseli
  1. Log in to our e-service at:  https://asiointi.findata.fi/
  2. From the top menu select “Data catalogue”
  3. Scroll down and select “Order remote operating environment” from under Apply for new user rights and click on “Add to basket”.
  4. After this, click on “Apply”
  5. Complete the application form
    • Enter your own name in the applicant field
    • After this, using the “Invite a member” button add all the persons and email addresses that need user rights to Kapseli.
    • The invited persons will join using Suomi.fi e-Identification (not e.g. Haka identification)
    • Complete the rest of the form
    • Add the names of processors, their email addresses and IP addresses to the Additional information field in accordance the instructions for order (IP addresses must be public and fixed)
  6. Finally, select Send application from the “Functions” section.

Logging in Kapseli

Before logging in make sure your account has been registered and is ready to use. If you’re not sure whether your account is ready to use get in touch with Findata’s contact person.

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.

  1. Install Duo Mobile app (developer: Duo Security Inc.) to your phone and activate it. If you’ve already installed and activated the app go to point 2.
    • Installing: find Duo Mobile from your phones app store and install it.
    • Activating: the phone numbers reported when ordering Kapseli will get an automatic activating message for Duo Mobile. The app is activated by clicking the link in the activating message.
  2. Log in Kapseli at https://kapseli.findata.fi using your computers browser.
    • Choose the identification method from the list that you chose while registering.
  3. Choose the operating environment you’re going to use. If you have just one operating environment in use go to the next section.
    • After choosing the environment the system goes to the second phase of identification.
  4. The second phase of identification.
    • Log in the operating environment.
    • You’ll get a notification about logging in to Duo Mobile. To approve the log in choose ‘Approve’ in Duo Mobile.

Data transfer and folder structure of Kapseli

All software installations and data transfers in Kapseli take place through orders and audits. No data can be independently exported to or imported out of Kapseli.

The data permit specifies the data for which a processing permit has been granted. The data is collected, linked, pre-processed and, if necessary, pseudonymised or anonymised by the Data Permit Authority. Additional information needed for use of the data, such as publicly available statistical data, also requires an audit by the Data Permit Authority and a transfer of data to the Kapseli.

Folder structure:

  • Data (D:)
  • Backup (E:)
  • CRAN (N:)
  • Output (O:)
  • Work (W:)

The files specified in the data permit are available in the Data (D:) folder. The Data folder is write-protected. Other information supplied to Kapseli, such as any program codes, will also be moved to the Data folder after an audit. For the purposes of work, the system has the Work (W:) folder to which you should copy the files you use from the Data folder.

From the Output (O:) folder intended for data transfer, the data is transferred to the Data Permit Authority’s system to be audited. Note that the data to be transferred must be in anonymous format and that, with regard to program codes, you must also ensure that no personal data is included in the files to be transferred. The data that you want to back up is be exported to Backup (E:) folder. The CRAN (N:) folder contains the software packages required for using the R software.

Exiting the system

There are two ways to stop using the remote desktop.

  • Sign out is located behind the human figure at the bottom left. You should use this option when you have finished processing the data. When you exit from Sign out, you release the resources on the remote workstation.
  • Disconnect is located behind the Power button. Use this option if you need to leave analyses  running when you leave the workstation. The resources will then remain reserved.

After both options, you will see the options Reconnect and Logout. Select Logout when stopping the use of the system. Close your browser unless you want to log back in.

Software in Kapseli

All Kapseli packages include the software according to the table below as standard. We will expand the range of software as needed.

SoftwareVersionFurther information
7-Zip19
Adobe Acrobat Reader DCUp to date
Anaconda 32019/10, 2020.07
GeoDa1.16
Git2.28.0
Google ChromeUp to date
IBM SPSS Statistics27
LibreOffice6.1Base, Calc, Draw, Impress, Math, Writer
LyX2.3
MiKTeX20.6
Notepad++7
QGIS3.10
R4Includes CRAN library packages
RStudio1.2
SAS9.4
Stata16
WinPython3.8

Orders for additional software

If a user needs software other than that included in the basic package, it can be installed as a separate paid subscription. Contact kapseli@findata.fi to get more information about additional software’s installation. In the case of commercial software, the validity of the relevant licenses will be ensured during installation. For other software to be installed, ensuring data security and data protection is essential; if requested, the customer must provide a statement or certificate.

Transferring own files to Kapseli

Kapseli functions as the project’s desktop throughout the processing of the data. In principle, the processing of the data would take place in Kapseli, i.e. only the final analysis results would be brought outside the system. The same idea of producing code inside the system applies to the production of program code required for analysis. In practice, however, an earlier program code is often used as an analysis framework. Earlier program code and other own files (study protocol, descriptions of variables etc.) can be imported into Kapseli through an audit by Findata.

See the instructions for further details from https://findata.fi/en/data/data-transfers-to-findata/ .

Using the R program’s CRAN global repository

1.Deployment of the CRAN global repository

  1. Locate the .Renviron file in the root of the D: drive and copy it to your Documents folder.
  2. Start RStudio. Packages need not be installed, but are directly enabled with the library() command. For example, the dplyr package is enabled with the library(dplyr) command.

Please note that due to the large size of the CRAN repository, the Packages tab cannot be used. Starting RStudio takes a little longer than usual when the CRAN repository is enabled.

1.1.1Disabling the CRAN repository

Delete the .Renviron file in your Documents folder.

Result verification

All those who process personal data must provide the results of their analyses in an anonymous form that cannot be used to reveal any data or aspects concerning individual participants following the instructions given by the Data Permit Authority Findata. According to the Act on the Secondary Use of Health and Social Data, the Data Permit Authority must ensure anonymity. This applies to all materials that have been authorised under said Act.

Anonymisation refers to a process in which the material is processed in a way that

  • it cannot be used to identify any individual persons either directly or indirectly
  • it cannot be used to make any conclusions concerning a specific individual person
  • any information concerning a specific person cannot be linked to any other material
  1. Check the anonymity of the results to be publish in regard to our instructions that you can find on page Producing anonymous results.
  2. Transfer the results and the conclusion form to Findata via the Kapseli operating environments Output-drive,
    • Fill in the conclusion form (Pyyntö varmistaa tulosten anonymiteetti) and attach it.
    • Pack the results and the conclusion form in a zip file and name it accordingly:
      Tulokset_Diary_number_of_the_data_permit_Operating_environments_identity_code_Transfer_date (the dates should be ddmmyyyy, e.g. Tulokset_THL_1234_14.02.00_2020_a01_15032022)
    • Create an empty text file to the Output-drive and name it ZZZ_READY.txt, so the zip file will automatically transfer to Findata. Check carefully that the ZZZ_READY file is named correctly to make sure the transfer will succeed. The transfers are done on the hour and every 30 minutes. The transferred files are automatically removed from the Output drive after this.
    • If you want to you can notify Findata about the transfer (info@findata.fi). We’ll contact you if the transfer didn’t reach us. You won’t get a notification about a successful transfer.
  3. We’ll check the requests in 5 working days and deliver the results to the permit holder via transfer service Nextcloud. If we need more information we’ll contact you.
    • If the result files are very extensive the 5 days limit might not apply.

Frequently asked questions

Content incoming

See also

Standard terms of use

Users of the Kapseli agree to abide by the standard terms and conditions, which can be found here. Read more Standard terms of use

Producing anonymous results

On this page you’ll find instructions for producing anonymous results. Read more Producing anonymous results

Pricing

Read more about pricing. Read more Pricing