etrustex Web access Java Script version User Guide for existing Users

Transcription

1 European Commission DIRECTORATE GENERAL DIGIT etrustex Web access Java Script version User Guide for existing Users Date: 08/06/2018 Version: Authors: Anamaria BATRINU (DIGIT-EXT) Reviewers: Bruno POSSEMIERS (DIGIT-EXT) Ilyasse SETTI (DIGIT-EXT) Agota SIMON (DIGIT-EXT)

2 Contents Introduction... 1 Accessing the beta version... 1 Compatible browsers and versions... 2 Visualizing a message what changed... 3 List of files section... 3 Decrypting the files... 6 Sending a new message what changed... 7 Signing the message... 8 Signature Section... 8 Certificate Validation... 9 List of files section Adding files to upload Uploading the files... 12

3 Introduction This user guide is meant to cover the changes introduced in the Java Script version of the application at the level of the interface and the interaction with the user and it is intended for users who are already familiar with the application (e.g. users who have already used the Java Web Start version). The screen captures included in this user guide were taken using Google Chrome version 66. Certain fonts, components, alignments and popups might look different if you are using another browser or a different version of Google Chrome. The popups included in this user guide that fall under this category are followed by an indication. Accessing the beta version The application will display the old version by default. In order to access the beta version you need to click on the link "Take me to the new version (beta)" in the top right corner as shown below: If your browser is compatible with the beta version, you will be redirected to the new version. The landing page looks the same way, but the link in the top right corner becomes "Take me to the previous version" giving you the possibility to return to the old version of the application. 1

4 The application is using cookies in order to remember the previous selected version the next time you log in. You will still see the old version by default if you open the application for the first time in a different browser. You can switch between the two versions from any page. You will be redirected to the Inbox view of the version you choose and you will lose any unsaved information (e.g. a new message that has not yet been saved as draft or sent). Compatible browsers and versions Once you click on the link "Take me to the new version (beta)", if the browser you are using is not compatible with the beta version of the application, you will be redirected to a page showing you the compatible versions. You can return to the old version by clicking on the link "Take me to the previous version". Click to go to the old version Compatible browsers and versions Additional information that might be useful or actions required 2

5 Visualizing a message what changed List of files section The list of file section has been redesigned: Tick to reduce the list to only the files that have not yet been downloaded or for which the download failed Select/unselect all files at once Launches the download of the selected files Number of files successfully downloaded from the total number of files Total size of files in the list (no matter if they are selected/hidden or not) Select the files you want to download. You can select/deselect all the files at once by ticking/unticking the Select all check-box. Click on button. A popup window will inform you about the progress of the download: 3

6 The files are archived in archives 1 of maximum 512 MiB in size. If the total size of the files is more than 512 MiB then a new archive will be created each time this limit is reached. The archives are named following the below rules: The archive name starts with the sending date and time followed by the subject of the message the following characters are replaced by underscores: o white spaces (wherever there are more than one white spaces in a row, they will be replaced by a single underscore) o special characters (e.g. " * / : < >? \ etc.) if more than one archive is created the archive names will end in _1-of-n, _2-of-n etc. where n is the total number of archives to be downloaded The location where the archives are placed as well as the fact that they can be immediately opened after the download completes is browser specific. E.g. Depending on the browser the archives could be immediately opened, or they can be saved in the user's Download folder or the download location configured by the user in the browser. When the download is finished the status of each file is updated, as well as the number of successfully updated files: Updated areas You can download the files as many times as you want. If you click when no files are selected you will see the following popup message: 1 Archive - a compressed file containing multiple files and/or folders, created by a file archiving utility in zip format, which is a standard archive format supported by several archiving utilities (e.g.7-zip, WinZip, WinRAR etc.). 4

7 If there is an error with one of the files, the download will continue (this file will not be included in any of the archives) and its status becomes FAILED. Positioning the cursor over the status will display the reason of the failure. Updated areas for files in error If there is a problem with the signature, even if you choose to trust the certificate in the Trusting Certificate popup, the digital signature notification will be displayed as a warning: If the checksum validation fails (aka the file is corrupted because of a network issue or the file was tampered with etc.), the file is added to the archive renamed with UNTRUSTED_ prefix. The status of the file becomes UNTRUSTED and it is not counted as a successfully downloaded file. Updated areas when there are UNTRUSTED files 5

8 Decrypting the files This section only concerns messages that have been sent using the recipient's public key for encryption. In this case the list of files section will include the certificate information just above the file container: Decryption certificate information area Click select it: to search and select a certificate file. Navigate to the location of the file and 6

9 Fill in the certificate password. The certificate information for decryption will be validated once you click error messages are displayed above the decryption certificate information area:. The If you provide the wrong certificate, you will not be able to download the files and you will see: Click. The status of the files will become CANCELLED: You may now choose a different certificate and retry the download. Sending a new message what changed To send a new message click on New in the top left of any of the views (Inbox, Sent or Draft). Only the user interaction for the signature and for the upload of the files has changed. 7

10 Signing the message Signature Section There are cases in which the signature is required and cases in which is optional. The user interface and interaction in these two cases is slightly different. If the signature is required you will see the following fields in the New message view (the Signature check-box is ticked by default and the user cannot change it): Signature specific fields If the signature is optional you will only see the Signature check-box which is unticked. If you want to sign the message, tick the check-box and the other certificate fields will be displayed. Tick the Signature check-box 8

11 Click on button to search and select a certificate file. Navigate to the location of the certificate file and select it: Fill in the certificate password. Certificate Validation The certificate information will be validated once you click Send. The error messages resulting from this validation are displayed at the top of the page like in the following example: 9

12 List of files section The list of file section has been redesigned: Number of files in the list that have not yet been uploaded Total number of files in the list (no matter if they are uploaded/hidden or not) Switch reducing the list to only the files that have not yet been uploaded Adds files to the list by selecting one or more individual files Adds files to the list by selecting one or more individual files The size of all the files in the list (no matter if they are uploaded/hidden or not) Adding files to upload You can add files to the list of files in three ways: 1. Via drag and drop: drag and drop the files or the folders containing the files to the file area (if you drag and drop a file all the files in the folder and all its subfolders are added to the list recursively): Drag and drop files in here 10

13 2. Via button you can add one or more individual files: The above popup might vary based on the browser you use and its version. 3. Via button you can add all the files from the selected folder (it will also add the files from any subfolder): The above popup might vary based on the browser you use and its version. 11

14 The above popup might vary based on the browser you use and its version (some browsers will not display it at all). Clicking in this popup will only add the files to the list. In order to upload the files you still need to use. The files will be then displayed in the list of files with no status associated: You can remove any of the files by using the button or all the files at once by using Uploading the files button. To upload the files in the list you need to click. A popup showing the progress of the upload appears (all the files that are not in status SUCCESS will be considered for uploading): If you choose to cancel the upload, you will see the following progress bar while the cancelling is being executed (only the files that have not yet been uploaded will be cancelled they will appear in the list with no status): 12

15 The files that were successfully uploaded will appear in the list with status SUCCESS: Status column The files for which there was a problem during the upload will be displayed with status FAILED. Positioning the cursor over the status will display a tooltip indicating the reason of the error. If there is no file to upload (or all files in the list have status SUCCESS) when you click the Start Upload button, you will see the error message in a popup window: 13