CSSCurrent en:Activating the Archiving Feature

Aus Cryptshare Documentation
Version vom 14. November 2022, 12:05 Uhr von imported>Winterm (Typo)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu:Navigation, Suche



Adding and configuring a new connector

Choose the desired connector from the drop-down box and click on the 'plus' button for adding the connector.

16 Aktivieren der Archivierung 01 EN.png

Enter the target directory to where archiving information shall be written and save the settings.

16 Aktivieren der Archivierung 02 EN.png

Make sure that this directory exists and that Cryptshare is granted write access.


If your archiving system supports working with file name suffixes, setup the suffixes as well. Save the changes.

16 Aktivieren der Archivierung 03 EN.png

Go to the Policy Rule Setup and activate the archiving feature by either activating it for single policy rules or by resetting the policy rules to their default settings. Activate archiving for a single policy rule

16 Aktivieren der Archivierung 04 EN.png Activate archiving using the reset-function

Activate archiving using the reset-function

16 Aktivieren der Archivierung 05 EN.png 16 Aktivieren der Archivierung 06 EN.png

Note that this will only enable the feature in case you have activated archiving for new Policy Rules previously.
Keep in mind, that the reset function may also change other settings to their defaults.

Setting up an SCP connector

General Setup

Follow the steps as described in the previous chapter by adding the connecor and setting up the target directory, optionally the file name suffix configuration.

16 Aktivieren der Archivierung 07 EN.png

Remote Host

Enter the host name or ip address of the remote SCP server. Make sure the SCP server is up and running. Change the port setting in case the SCP server is running on a different port.

16 Aktivieren der Archivierung 08 EN.png

Authentication

Keyboard Authentication

Activate the checkbox for keyboard authentication and enter a user name and password.

16 Aktivieren der Archivierung 09 EN.png

Public Key Authentication

Activate the checkbox for public-key authentication, enter a username, a passphrase if the key uses one and paste the private key into the text area.

Please note, that the format of the private key needs to be compatible with the openSSH format.

16 Aktivieren der Archivierung 10 EN.png

Finally click on the 'Test Connection' button in order to check the settings If you didn't setup the fingerprint manually, a dialogue will show up asking whether you want to import the fingerprint. Confirm the dialogue with 'Yes' in order to import it. If you do not import the fingerprint a connection will not be possible. Save the changes in order to finish the setup.

16 Aktivieren der Archivierung 11 EN.png

16 Aktivieren der Archivierung 12 EN.png

16 Aktivieren der Archivierung 13 EN.png

EML Archiving

This feature is supported for the archiving connectors "Local File System" and "Secure copy". When activated, the connector attaches all archiving information to a single EML file. This way of archiving information is a common way how archiving systems gather their contents.

Activate EML Archiving

16 Aktivieren der Archivierung 14 EN.png

Prioritization

Attachments for the archiving EML are attached according to the following prioritization definition:

  • General Order
    1. Confidential message
    2. Metadata
    3. Transfer files
  • Document types (default configuration)
    1. \*.eml
    2. \*.pdf
    3. \*.docx
    4. \*.doc
    5. \*.xlsx
    6. \*.xls
    7. \*.txt
    8. \*.ppt
    9. \*.pptx
    10. <all remaining files>
  • Files sizes: The smallest files are attached first

The document types consists of a list of file type extensions in the 'cryptshare.properties'. By setting these properties, the default configuration is overwritten, which provides the following options:

  • A new list can be defined
  • The order of the items can be changed
  • Further file types can be defined
  • At least one item needs to be specified, otherwise the setting will not be accepted and the default setting will be applied.

16 Aktivieren der Archivierung 15 EN.png

Set a Maximum Total Attachment Size

In order to limit the file size of the generated EML file, you can specifiy a maximum total attachment size for attachments. The allowed values are all positive integer numbers including zero. The default setting is 25 megabytes. When the overall size of all attachments (excluding the message itself and the metadata file) reaches the defined size threshold, no further attachments will be added to the EML.

Note that the final EML file size increases by up to a factor of 1.5 due to the attachments being Base64 encoded.

Set a file name template for the generated EML file

The filename for the generated EML file is fully customizable. For creating dynamic names and traceability, you can set the EML file name using the Velocity placeholders like in the Meta Data Configuration. A minimum file name of 4 characters is required and no empty value is allowed. The default setting is ${trackingId}.eml.

Example
A transfer is provided having the tracking-id '20170822-114019-3a4efd0d'. Together with the default setting the EML file name will be '20170822-114019-3a4efd0d.eml'.