Every user on the CargoX platform needs a blockchain key to sign transactions and send documents. Users can have more that one key associated with their account, and use them independently.
You will be offered to add your first blockchain key at the end of the company registration process and also at every login. To start the process just click the green Start button.
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.
Step 1: New or existing blockchain key
You can either create your new blockchain key inside the web browser (takes only a few seconds and it’s free of charge), or use your existing blockchain key if you already have it.
Once you read the page confirm that you understand that CargoX can not restore your blockchain key for you (by clicking in to the checkbox - red circle in photo below).
If you want to create a new blockchain key, click on the green Create a new key button. Skip to next step!
If you want to use your existing blockchain key, click the grey Add an existing key button and follow on-screen instructions depending on the type of the blockchain key (consult blockchain key guide for details). If you are adding a Keystore type of blockchain key, skip to Step 4.
Step 2: Set the password for your new blockchain key
Choose and enter a password that will be used to encrypt your blockchain key file. This should not be the same password as your login password. Make sure you can not forget or lose your password (use a password manager). Click the green Next button to continue.
Step 3: Download your newly created blockchain (keystore file)
Blockchain key is generated in your web browser locally which means that nobody - not even CargoX - ever sees your key or password.
First click the green Download button to save keystore file on your computer. Put it in a safe place where you will find it even a year from now. We recommend, that you immediately store a copy of the file also on a USB drive and create a third copy somewhere else.
WARNING: Please note that 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 key file successfully and stored it in a safe location confirm that (by clicking in to the checkbox - red circle in photo below) and click Next.
NOTE: Some companies have very restrictive IT security policies, that are essentially prohibiting users to download anything from the internet. If you are unable to download the blockchain key file to your computer, click on the I am unable to download files button, for an alternative method. Skip to step 5.
Step 4: Link your blockchain key to your account (keystore file)
You have now created and downloaded your blockchain key, and the only thing remaining is to associate it with your CargoX account.
Click the Choose file button and select your keystore file (blockchain key) from your computer. Providing the password to decrypt it in the field below.
This will unlock your blockchain key in your browser (please note that your keystore + password never leave your computer). Click Verify and Add to continue and skip to step 7.
Step 5: Copy contents of your newly created blockchain key
Alternative way to save your blockchain key is to copy content of the encrypted blockchain key file (which is essentially just a text file). Click the green Copy to clipboard button to copy it to the clipboard. Now paste it to a document on your computer. Store document in a safe place where you will expect to find it even a year from now. We recommend, that you immediately also make a backup copy.
WARNING: Please note that if you lose your blockchain key file content 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.
Step 6: Link your blockchain key to your account (keystore file contents)
You have now created a new blockchain key for yourself and stored its content to your computer. Now it is time to link it to your CargoX account. Pasting your keystore file's content (blockchain key) 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 keystore + password never leave your computer).
Click Verify and Add to continue.
Step 7: Email verification
As an extra security measure, before allowing you to link a new blockchain key with your account, CargoX sends a code to your email. Please check your email and type the received code into the box. Click Submit to continue.
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 part where it says: The key has been activated and is ready to use), skip to Step 9.
It seems that you are the first user from your company to add a blockchain key. First blockchain key is activated automatically by the CargoX Platform.
As a security mechanism all blockchain keys need to be activated after they have been added.
To activate them you need an active blockchain key. Since you are now the only one with it, you will need to manually approve second and all consecutive blockchain keys.
You will also need to manually approve blockchain keys of other users under your company.
You can also give this permission to your colleagues at the time when you create accounts for them.
Once a new blockchain key is added under your company, system will notify all users with permission to review it.
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.
Step 10: Congratulations, you are done!
Your registration is completed.
You now have the blockchain key added to your account (if not yet activated, we will send you an email once it is).
Suggested next steps are:
- Review your profile, and complete your personal details. You can add your avatar photo, phone number, and other info like your department, your position etc. and view your permissions on the platform (Account | My profile)
- Review company's profile, and add contact details and a company logo (Manage | Company details)***
- Create additional user accounts for your colleagues (Manage | Users)***
- Build your ecosystem and connect with other companies on the CargoX Platform, which will allow you to exchange documents with them (Manage | Contacts)***
In case of questions or problems, feel free to reach out to us at [email protected].
*** Allowed only if your account has the right permissions.