filestore version 2.0 (user guide) 1. introduction filestore

14
Filestore version 2.0 (User Guide) 1. Introduction Filestore is a simple web application that should be used for transferring large volumes of data within Skanska or with Joint Venture partners and Suppliers. Currently Filestore is only written in English and in Czech and the maximum file size for uploading is 1024MB (1GB). To access the Filestore web application you will need to go to http://filestore.skanska.cz/ by clicking the link or by typing it in to your web browser. Depending on if you are a Skanska user or someone logging in from outside of Skanska, one of two differing pages will be displayed: Filestore as viewed from within Skanska

Upload: others

Post on 02-Apr-2022

7 views

Category:

Documents


0 download

TRANSCRIPT

Filestore version 2.0 (User Guide)

1. Introduction

Filestore is a simple web application that should be used for transferring large volumes of

data within Skanska or with Joint Venture partners and Suppliers.

Currently Filestore is only written in English and in Czech and the maximum file size for

uploading is 1024MB (1GB).

To access the Filestore web application you will need to go to http://filestore.skanska.cz/ by

clicking the link or by typing it in to your web browser.

Depending on if you are a Skanska user or someone logging in from outside of Skanska, one

of two differing pages will be displayed:

Filestore as viewed from within Skanska

Filestore as viewed from outside of Skanska

It is not possible to “Create deposit ticket” if you are accessing Filestore from outside of

Skanska.

2. Upload files from Skanska network to someone else

To upload files you need to click on “Deposit the package” and then enter your e-mail address

and PIN (optional)

Example: Skanska user Jamie Jeffery wants to upload some files. He has entered his e-mail

(so he will receive the email with the download link and information about the package) and

he has entered his PIN as well.

The PIN will help to eliminate the risk that someone who is not the intended recipient could

read the e-mail and download your file.

Do not forget to send the PIN to the file recipient in a different way, for example via mobile

phone.

By pushing the “Continue to files selection” button a new page will be opened. You can

cross-check the information you previously input and any potential mistakes will be marked.

If there are no errors it is possible to select up to five files. Total package size is limited to

1024MB (1GB).

Once you are happy that you have the 5 files selected click on the upload button.

You can see the progress of the uploading on the Progress bar:

After uploading, the files will be scheduled for process and the final page will be displayed:

Your files are now stored as a package on the Filestore server. Each file is stored separately,

identified, It’s hash counted up and encrypted. Depending on the package size and the size of

the queue it may last from a few seconds to tens of minutes. When the process has finished,

you will receive an e-mail to the entered e-mail address. The email contains information

about the stored package and the download link for collecting the package from Filestore.

Example of the download link contained within the email:

http://filestore.skanska.cz/collect.jsp?0yEQYUZuDAwgsF73bGhpFLfbO8Ot4Fva

You can copy this download link and forward to the people who need to download the files.

Please note that Filestore can not be used as a permanent place to store files as packages will

be deleted automatically if no one downloads them.

3. Upload files from Internet

Uploading files from the Internet (outside of Skanska) is similar to uploading files from

within the Skanska network. However there are a few differences. The main difference is that

from the Internet you get “Deposit ticket”, this is to prevent access to uploading to Filestore

by anybody from outside of Skanska.

The deposit of the package is divided into two separate steps:

1. Creation of Deposit ticket

2. Deposition of the package by using Deposit ticket

3.1. Creation of Deposit ticket

Creation of Deposit ticket is only possible from within the Skanska network.

To create a download link for people outside of the Skanska network click on the "Create

deposit ticket for external subject" link on the home page.

You will get a simple form. There you enter your e-mail address.

Example: Skanska user Jamie Jeffery creates a ticket to get some files to someone outside of

the Skanska network. He has entered his e-mail. The entered e-mail will be associated with an

appropriate ticket and will automatically be used as the address to receive all emails relating

to this ticket.

By clinking the link “Create and send ticket” you get a final report with information about the

ticket:

You will receive an email to the entered email address. The email contains the Ticket

Number with a link for uploading files to someone outside of the Skanska network.

Example of link:

http://filestore.skanska.cz/store.jsp?45cdad3a8e068c1e

You can provide this link to people outside of the Skanska network who need to send you

files. The Ticket number (and it’s link) is possible to use repeatedly by different people to

send you some files. The ticket and all associated files and packages will be deleted

automatically, when nobody uses it for a few weeks.

3.2. Upload files by using ticket link

Uploading files from outside of the Skanska network is similar to uploading files from within

the Skanska network. The only difference is that you have to fill in the ticket number rather

than an email address:

The next steps are the same as in Chapter 2 (Page 3)

4. Collect package

To collect a package you need to click on the "Collect package" link from the home page or

click on the download link in the email

You have to enter the Ticket Number (if you use the download link from the e-mail, the

Ticket Number is already completed). Next you need to enter the PIN if one was set (the

creator of the package will be able to tell you what this is set to).

If you entered a valid ticket number and PIN, when you click “Collect package”, the content

of the package will display on screen.

In the example below there is package from Jamie Jeffery for someone outside of the Skanska

network:

It’s possible to download each file by clicking on the filename. You see the following

download notification:

It is recommended you use “save” file instead of “run” file.

5. Security and technical details

5.1. Encryption

All stored files are encrypted by symmetrical code CAST5. The Data encryption code is part

of the package ID and is unique for each package. The code is not stored on the Filestore

server. The PIN is also a part of Data encryption code. It is virtually impossible to obtain

the content of a package without the ID of the package and the PIN, including by the

system administrator.

5.2. Type of file

The type of files are displayed in a list by file type. They are displayed real the real file type.

This means that the system ignores suffix of files, but associate them according to real content

of file IE if you change the file suffix from .exe to .pdf, the file will be always displayed as a

.exe (executable file). Filestore does not scan content of archive (e.g. .zip file).

5.3. Checksum MD5

Checksum can be used to do a quick integrity check or identification of file by uploader or

downloader. A standard user would not use it.

5.4. SW platform and tools

Debian GNU/Linux

Jetty - web Server (Java container)

PostgreSQL - database server

Java and Perl – programming languages

Jiří Svoboda, author of filestore and original of this User Guide (in Czech language)

Emil Reiter, first English translation

Jamie Jeffery, UK assistance (English corrections, new screenshots)

created 24.4.2008, last release 23.6.2011.

Edited for the UK 17.01.2012