MetaMask is an add-on for Chrome, Firefox, Opera, Brave and the new Microsoft Edge browsers. It is also available for mobile devices (Android and IOS). MetaMask is not supported on older browsers such as Internet Explorer and Safari.
This extension stores your blockchain private keys and enables you to sign transactions without revealing your private key - which is one step closer to the security hardware wallets provide. If you are unable to procure a hardware wallet, use MetaMask.
Because it adds functionality to a normal browser context, MetaMask requires your permission to read and write to any web page.
Setting up MetaMask for the first time
Step 1: Install the extension
MetaMask needs to be installed into your specific browser. This needs to be done only once.
Administrator access is required to install the MetaMask. If you cannot install the add-on software, please get in touch with your system administrator.
Download the extension at https://metamask.io/download.html and choose the version for your web browser.
Usually, you need to click the Get Extension and confirm the installation of the add-on, similar to what is shown below:
Alternately, use the Brave browser, which focuses on privacy and blockchain solutions. Brave already comes bundled with the MetaMask extension. You need to enable it by visiting the preferences page, section Extensions and choose MetaMask as the default Web3 wallet provider for using Dapps:
Step 2: Prepare your MetaMask
MetaMask helps you manage different Ethernet blockchain private keys, much like a hardware wallet would. To prepare your MetaMask , you need to create at least one wallet. This step needs to be done only once.
Click on the MetaMash icon (brown fox) to open the plugin, click Get Started.
Step 2.1: Create a new wallet on MetaMask
To set up a new account and wallet, click Create a Wallet.
Step 2.2: Create a password
The first thing you need to do is create a password. This password is used to securely store your MetaMask, so make sure you pick a good password and write it down somewhere safe. Losing this password will mean you will not be able to access your blockchain key stored in MetaMask.
Step 2.3: Save seed words
After creating a wallet, you will get a list of 12 or more seed words. These words help you recover your account on another computer if your computer gets lost or stolen, the disk breaks down, or if you forget your MetaMask password.
Write down these words on a piece of paper with a ball-point pen and store it somewhere safe (e.g. in a safe), away from your PC. 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.
Make sure you follow all the instructions.
Step 2.4: MetaMask initialization completed
You will be presented with the main MetaMask screen, as seen below. Depending on the browser this might open as a popup, new tab, or new browser window.
After you have configured your MetaMask account, it is time to link it with your CargoX Platform account. If you have not completed your account registration do so by visiting https://cargox.digital.
Using MetaMask with CargoX
Step 1: Unlock MetaMask and log in to CargoX Platform
Click on the MetaMask icon in your browser to open MetaMask window (usually it appears in the upper right corner).
Unless you have recently unlocked your MetaMask account, you will have to enter the password. For security reasons MetaMask will ask you for the password after every restart of the browser.
Step 2: Select MetaMask
Step 2.1: To link your MetaMask to your CargoX account, log into your CargoX account with your username and password, or a linked blockchain key, then go to Account | My profile | Privacy & Security, and click Add new blockchain key. Select MetaMask from the list and click Next.
Step 2.2: To log into the CargoX Platform with your MetaMask, go to the CargoX Platform login page, select I want to login with my blockchain key, then select More options and finally select MetaMask from the list, then click Next.
Step 2.3: To unlock your MetaMask for signing the blockchain transaction, just follow instructions for logging in with your MetaMask from step 3 onwards.
The CargoX advanced login window will open, containing further instructions.
Step 3: Authorize the CargoX Platform to communicate with the MetaMask
MetaMask will display the Connect request pop-up window, asking you to allow CargoX Platform to communicate with your MetaMask. Click the Connect button to continue.
This will allow the CargoX Platform to read the public address of your MetaMask account, and display it for confirmation.
Step 4: Verify the MetaMask account public address
If you have multiple accounts stored in your MetaMask, verify that this is the one you wish to use, then click Next to continue. It is important that you choose the same address every time.
When linking your MetaMask to your CargoX account, verify the address and click Next. On the next screen confirm your email by typing in the verification number that was sent to your email. With that your blockchain key adding process will end - there is no need to perform any additional steps in the MetaMask.
When logging in with your MetaMask, or unlocking it for signing a blockchain transaction, a different but similar screen will appear, where you again verify that MetaMask is providing the right public address:
Step 4: Confirm the transaction by Signing it
A MetaMask window will appear, displaying the challenge message you need to sign with your private blockchain key, in order to confirm action. Click the Sign button to continue.
Step 5: 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!