About Ledger Nano S
The Ledger Nano S and other Ledger hardware wallets are very secure blockchain storage and transaction signing devices. The private keys are generated by the device itself and they never leave the device. This makes them very safe as it is virtually impossible to steal or abuse blockchain private keys from them. To use the CargoX Platform securely, the basic and most affordable model Ledger Nano S satisfies the requirements. CargoX is compatible with all different Ledger devices.
Please note that as of this writing, the Ledger wallet is only compatible with the Google Chrome browser.
Where to buy?
The Ledger hardware wallets can be purchased from the manufacturer's online shop and from many resellers worldwide. We recommend checking your local electronics and computer stores, or your favorite online retailers, as they frequently also have the device in stock. Please, make sure the device is delivered in the originally sealed packaging - if the package is open or visibly damaged, reject it, as it might have been tampered with.
Setting up Ledger Nano S for the first time
Before you can use the Ledger device you have to initialize it. This only needs to be done once. Because the Ledger software is evolving and it is being updated monthly, follow Ledger's official instructions - they are guaranteed to be always up to date and valid.
Here is a rough outline of this simple procedure:
- The first thing you should do is install the latest version of the Ledger Live app, which is required for the device to work properly on your computer. Note that administrator access is required to install the app. If you cannot install the software, please get in touch with your system administrator.
- Once installed, connect the Ledger device to your computer via USB cable.
- Open the Ledger Live app.
- Follow the application wizard and follow the instructions. Among other things be sure to:
4.1. Set up a security PIN for your Ledger.
4.2. Create a backup of your Ledger (write down 12 or 24 seed words on the paper card).
4.3. Store this paper card in a safe place (like a safe deposit box or in a corporate secure space).
Anyone who can view these words, can compromise your private key (and potentially abuse your credentials), so handle this card with extreme care as per your company's security policy. This card enables you to restore your blockchain ID in case you forget a PIN or lose your Ledger device. Do not skip this step!
- Complete the Ledger initialization process.
- Prepare your Ledger to work with CargoX Platform by configuring the Ethereum app on it. Once the Ethereum app is open (if you do not have it, install it), go to Settings and verify that Contract data is set to Allowed (you can leave Debug data at NOT Displayed).
After completing all the steps described above and in detail on Ledger's Live app or webpage or user's manual, you should have a properly configured Ledger hardware wallet device, protected by a PIN code and also a backup 12- or 24- seed words written on the paper and stored in a safe place. Once all this is done, you are ready to proceed with the registration of your CargoX account.
NOTE: THE MOST IMPORTANT STEP WITH INITIALIZATION OF LEDGER IS CREATING A BACKUP! IF YOU SKIPPED THIS STEP, DO IT NOW.
Using Ledger with the CargoX Platform
After you have configured your Ledger hardware wallet it is time to link it with your CargoX Platform account. If you have not completed your account registration yet, do so by visiting https://cargox.digital.
NOTE: If you have a problem logging in with Ledger, please make sure your device is updated to the latest firmware.
Step 1: Plug in your hardware wallet
Make sure your Ledger is connected via USB.
Step 2: Enter PIN
Use buttons on your Ledger to enter your PIN.
Step 3: Open Ethereum app
Use your Ledger buttons to select the Ethereum application, open it by pressing both buttons at once. Once in the app, you should see the Application ready prompt.
Step 4: Select "Ledger Hardware Wallet"
Step 4.1: To link your Ledger with your CargoX account, login to your CargoX account with your username and password, or with any other blockchain key, then go to Account | My profile | Privacy & Security, and click Add new blockchain key. Select Ledger Hardware Wallet from the list and click Next to start the process.
Step 4.2: To log into CargoX Platform with your Ledger, go to the CargoX Platform login page, select I want to login with my blockchain key, then select More options and finally select Ledger Hardware Wallet from the list and click Next.
Step 4.3: To unlock your Ledger for signing the blockchain transaction, just follow the instructions for login with your Ledger from step 5 onwards.
CargoX advanced sign-in window will open, and display instructions.
NOTE: On Windows 10, you might see Windows security popup flashing 5 times. It might tell you that there is a problem, or it might instruct you to sign in. This is normal, just ignore it and do not click the Cancel button.
Step 5: Select Ethereum address
Ledger supports multiple Ethereum addresses on one device. On the next screen you will be presented with a list of addresses configured on your Ledger wallet.
It is essential that you choose one address and always use this address to log into the application.
When linking your Ledger to your CargoX account, select the address and click Next. On the next screen confirm your email by typing in the verification number sent to your email. With that your blockchain adding process will end, as you don't have to do any action on the Ledger device itself.
When logging in with your Ledger, on unlocking, or confirming a transaction, you will see a slightly different window, but displaying the same 5 addresses as on the login. Choose your address and click Next.
Step 6: Sign the message on your Ledger
To complete the log in, unlock or to sign the transfer, you must sign a message. CargoX will show you this window:
NOTE: On Windows 10 you might see the Windows security popup flash a number of times.
Check your Ledger device. When its screen changes to Sign message do the following:
Click the right button once, which will display a transaction message similar to this:
Then click the right button again, and the display will change to ✓ Sign message:
Now press both buttons simultaneously to confirm signing.
Step 7: Your login, unlock or confirmation of the transaction is complete
A similar action (sign the message) will be required every time you want to perform a blockchain-related action on the CargoX Platform - for example, when you will be transferring a document or envelope, release cargo, or similar. This is now your equivalent of a digital signature - and nobody can forge it!