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 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.
An administrator access is required to install the MetaMask . If you cannot install the addon/software, please get in touch with your system administrator.
To download the extension, visit https://metamask.io/download.html and choose a 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 MetaMask extension. You need to enabled it by visiting the preferences page, section Extensions and choosing 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 setup 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 in case your PC gets lost or stolen or disk breaks down, or if you forget your MetaMask password.
Write down this 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.
Make sure you follow all the instructions.
Step 2.4: MetaMask initialization completed
You are now 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 a configured your MetaMask it is time to link it with your CargoX Platform account. If you haven't completed your account registration do so by visiting https://cargox.digital.
Using MetaMask with CargoX
Step 1: Unlock Metamask and login to CargoX Platform
Click on the Metamask icon in your browser to display Metamask window (usually in upper right corner).
Unless you have recently already unlocked the Metamask, you will have to enter password (for security reasons, MetaMask will ask you for password after every restart of the browser).
Step 2: Select MetaMask
Step 2.1: To link your MetaMask with your CargoX account, login to your CargoX account with username/password or any other 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 login or to CargoX Platform with your MetaMask, go to login CargoX Platform page, select I want to login with my blockchain key, then select More options and finally select MetaMask from the list and click Next.
Step 2.3: To unlock your MetaMask for signing the blockchain transaction, just follow instructions for login with your MetaMask from step 3 onwards.
CargoX advanced sign in windows will open, and display instructions.
Step 3: Authorize CargoX Platform to communicate with Metamask
Metamask will display the Connect request popup window, asking you to allow CargoX Platform to communicate with your MetaMask. Click the Connect button to continue.
This will allow CargoX to read the public address of your MetaMask account, and display it for a confirmation.
Step 4: Verify MetaMask account public address
In case 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 sent to your email. With that your blockchain adding process will end, as you don't have to do any action on 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 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 Sign button to continue.
Step 5: Your login / unlock / confirming transaction is complete
Similar action (sign the message) will be required every time you want to perform an blockchain related action on the CargoX platform (like when transferring the document, releasing cargo or similar).