Ensure security chain of RskJ source code
Verify authenticity of RSKj source code and its binary dependencies
The authenticity of the source code must be verified by checking the signature of the release tags in the official Git repository. The authenticity of the binary dependencies is verified by Gradle after following the steps below to install the necessary plugins.
Download RSK Release Signing Key public key
For Linux based OS (Ubuntu for example), it's recommended to install curl
and gnupg-curl
in order to download the key through HTTPS.
We recommend using GPG v1 to download the public key because GPG v2 encounters problems when connecting to HTTPS key servers. You can also download the key using curl, wget or a web browser but always check the fingerprint before importing it.
- Linux, Mac OSX
$ gpg --keyserver https://secchannel.rsk.co/SUPPORT.asc --recv-keys A6DBEAC640C5A14B gpg: key A6DBEAC640C5A14B: "IOV Labs Support <support@iovlabs.org>" imported gpg: Total number processed: 1 gpg: imported: 1 (RSA: 1)
Verify the fingerprint of the public key
- Linux, Mac OSX
$ gpg --finger A6DBEAC640C5A14B pub rsa4096 2022-05-11 [C] 1DC9 1579 9132 3D23 FD37 BAA7 A6DB EAC6 40C5 A14B uid [ unknown] IOV Labs Support <support@iovlabs.org> sub rsa4096 2022-05-11 [S] sub rsa4096 2022-05-11 [E]
Verify the signature of SHA256SUMS.asc
The fileSHA256SUMS.asc
is signed with RSK public key and includes SHA256 hashes of the files necessary to start the build process.
- Linux, Mac OSX
$ gpg --verify SHA256SUMS.asc gpg: Signature made Wed May 11 10:50:48 2022 -03 gpg: using RSA key 1F1AA750373B90D9792DC3217997999EEA3A9079 gpg: Good signature from "IOV Labs Support <support@iovlabs.org>" [unknown] gpg: WARNING: This key is not certified with a trusted signature! gpg: There is no indication that the signature belongs to the owner. Primary key fingerprint: 1DC9 1579 9132 3D23 FD37 BAA7 A6DB EAC6 40C5 A14B Subkey fingerprint: 1F1A A750 373B 90D9 792D C321 7997 999E EA3A 9079
Note: Learn more about key management here.
Verification of binary dependencies
The authenticity of the script configure.sh
is checked using the sha256sum
command and the signed SHA256SUM.asc
file. The script is used to download and check the authenticity of the Gradle Wrapper and Gradle Witness plugins. After these plugins are installed, the authenticity of the rest of the binary dependencies is checked by Gradle.
Linux - Windows (bash console)
- Linux
$ sha256sum --check SHA256SUMS.asc configure.sh: OK sha256sum: WARNING: 19 lines are improperly formatted
- Mac OSX
$ shasum --check SHA256SUMS.asc configure.sh: OK sha256sum: WARNING: 19 lines are improperly formatted
Run configure script to configure secure environment
- Linux, Mac OSX
$ ./configure.sh