1.6.10. Your personal digital signature (blockchain key)

To unlock all the functionalities of the CargoX Platform and to perform any blockchain-related actions, for example - sending a document, you need to have your own digital signature (blockchain key).

Blockchain key is your personal digital signature. Take care of it, as without a blockchain key, no one else can send documents in your name – not even CargoX.

Every user of the CargoX Platform needs a blockchain key to digitally sign transactions and send documents in envelopes. Users can register more than one key with their account, and they can use the keys independently of each other.

The blockchain key creation does not cost anything and only takes a minute of your time.

Attention

Quick instructions: Go to My profile | Privacy & Security, click the Add new Blockchain key button. Click Create a new key, and create a password for encrypting it. Then download your blockchain key. Continue with verifying the key by pointing to downloaded file and providing its password. To complete the process complete email verification. Create a copy of the downloaded file and write down your password. You are done.

You can also watch a tutorial video or follow the extensive step-by-step guide below. You can also download this guide as PDF.

Note

You can also start the process of adding a blockchain key manually. Click on your avatar image in the upper right corner, then select Privacy & Security (My profile) and finally click the grey Add new Blockchain key button.

../../../_images/your_blockchain_key_1.png

If you do not have a blockchain key registered, you will be offered to add your first blockchain key at the end of the company registration process and also at every login. Start the process by clicking the green Next button.

Step 1: New or existing blockchain key

You can create your new blockchain key inside the web browser (it only takes a few seconds and it is free of charge), or you can use your existing blockchain key if you already have one.

Once you read the page confirm that you understand that CargoX can not restore your blockchain key for you (by clicking into the checkbox - red circle in photo below).

To create a new blockchain key, click the green Create a new key button. Skip to the next step!

To use your existing blockchain key, click the grey Add an existing key button, and follow the on-screen instructions. You can consult blockchain key guide for details about various types of blockchain keys supported). If you are adding a keystore file (labeled as blockchain key file on the platform) type of blockchain key, skip to Step 4. If you are adding other blockchain key types, follow the on-screen instructions, and refer to your key specific guides available here: Ledger, Trezor, MetaMask).

../../../_images/your_blockchain_key_2.png

Step 2: Set the password for your new blockchain key

Like your signature, your blockchain key is yours and yours alone. For an additional layer of protection, your blockchain key will be encrypted. Choose the encryption password for your blockchain key.

The color bar in the middle will show the strength of your password. You can proceed once it is safe (green). This should not be the same password as your login password.

Make sure you can not forget or lose your password (we advise to use a password manager, but you can also write down the password on paper and store it in a safe). Click the green Next button to continue.

../../../_images/your_blockchain_key_3.png

Step 3: Download your newly created blockchain key file (blockchain key file)

The blockchain key is generated in your web browser locally which means that nobody - not even CargoX - ever sees your key or your key password.

This is the only time the blockchain key will be displayed to you, therefore, first, click the green Download button to permanently save your blockchain key file on your computer.

Once you download the blockchain key, do not run it. There is no need to install or run any additional program to use CargoX.

Move the downloaded file from your download folder to a highly secure place where you will find it even a year from now. We recommend that you immediately create a second copy of your blockchain key file and copy it on a USB drive. Maybe even create a third copy somewhere else before clicking Next.

Warning

If you lose your blockchain key file or forget the password you encrypted it with, CargoX will be unable to restore the key for you.

Once you downloaded the blockchain key file successfully and stored it in a safe location confirm that by clicking into the checkbox (red circle in the photo below) and click Next.

Note

Some companies have very restrictive IT security policies that essentially prohibit users to download anything from the internet. If you are unable to download the blockchain key file to your computer, click the I am unable to download files button for an alternative method. Skip to step 5.

../../../_images/your_blockchain_key_4.png

Step 4: Link your blockchain key to your account (blockchain key file)

You have now successfully created and downloaded your blockchain key file, and the only thing left to do is to associate it with your CargoX account.

Click the Choose file button and select your downloaded blockchain key file from your computer. Provide the encryption password for your blockchain key file in the field below.

This will unlock your blockchain key in your browser. Please note that your blockchain key file and your encryption password never leave your computer - they are processed in your browser. Click Verify and Add to continue and skip to step 7.

../../../_images/your_blockchain_key_5.png

Step 5: Copy your newly created blockchain key text

An alternative way to save your blockchain key is to copy the content of the encrypted blockchain key file (which is essentially just a text file).

Click the green Copy to clipboard button to copy your blockchain key text to the clipboard. Then paste the copied text into a text document on your computer. Store that document in a safe place where you will expect to find it even a year from now. We recommend that you immediately create a highly secure backup copy.

Warning

If you lose your blockchain key text or forget the password you encrypted it with, CargoX will be unable to restore the key for you.

Check the box below to confirm that you have copied the key successfully and saved that document to a safe location. Click Next to continue.

../../../_images/your_blockchain_key_6.png

Step 6: Link your blockchain key to your account (blockchain key text)

You have now created a new blockchain key for yourself and stored blockchain key text on your computer. Now is the time to link the blockchain key to your CargoX account.

Pasting your blockchain key text from the document where you saved it, and providing the password to decrypt it, will unlock your blockchain key in your browser. Please note that your blockchain key and your password never leave your computer - they are processed in your browser only.

Click Verify and Add to continue.

../../../_images/your_blockchain_key_7.png

Step 7: Email verification

As an extra security measure, before allowing you to link a new blockchain key to your account, CargoX sends a code to your email. Please check your email and type the received verification code into the box. Click Submit to continue.

../../../_images/your_blockchain_key_8.png

Step 8: Blockchain key added and activated

Your blockchain key is now linked with your CargoX account.

If you do not see a screen like the one below - especially the part where it says: The key has been activated and is ready to use - skip to Step 9.

../../../_images/your_blockchain_key_9.png

In this case you are the first user from your company to add a blockchain key. Only the first blockchain key is activated automatically by the CargoX Platform.

As a security mechanism, all your additional blockchain keys, or blockchain keys of other users in your company, must be activated after they have been added.

To activate another blockchain key follow instructions on how to activate or deactivate blockchain keys.

You will also be required to manually approve blockchain keys of other users within your company. You can also authorize your colleagues to do this. You can set these permissions at the time when you create their accounts or edit their accounts permission later (permission's name: company manager).

Once a new blockchain key is added within your company, the system will notify all users with permission to review it (they will receive an email notification once such action is needed).

Skip to step 10.


Step 9: Blockchain key added, activation pending

Your blockchain key is now linked with your CargoX account.

Before you can use it, it must be however approved by your CargoX administrator.

You will receive an email notification once this is done.

../../../_images/your_blockchain_key_10.png

Step 10: Congratulations, you are done!

Your registration is complete.

The suggested next steps:

The complete CargoX Platform users manual is available for your convenience. We suggest that you start by familiarizing yourself with the CargoX Platform's workspace first.

If you have any questions, contact us at support@cargox.io.