Manual to customize Bitscout to fit your needs
Written by Vitaly Kamluk
3 minute read
This section describes instructions to modify Bitscout configuration and script files to accommodate your requirements. Note: this may NOT be applicable to older Bitscout branch (16.04).
Please analyse current scripts before customizing them. Here are some general advice for Bitscout contributors:
You should be able to add modification to files inside ./resources and ./scripts directory and rerun only those scripts that apply your changes to the final product. There is no need to restart build process from scratch every time.
Should you need to add some manual temporary modifications (i.e. install/remove/configure software packages) you can enter target filesystem using ./scripts/chroot_enter.sh script. To quit, press Ctrl+D or type exit and press Enter.
Bitscout offers 3 basic release size level: minimal (1), optimal (2) and maximum (3). Depending on this, it includes libraries and software that you may want to have during forensic operation. You need to find your favorite size depending on media size, acceptable ISO file network transfer time, etc. You can change your release size level to another one at any time in GLOBAL_RELEASESIZE variable in config/bitscout-build.conf
.
By default, Bitscout uses public key cryptography (SSH, OpenVPN) with 2048-bit keys. Should you need to increase the keylength change CRYPTOKEYSIZE variable in config/bitscout-build.conf
.
Config file config/bitscout-build.conf
also offers to change the choice of using custom kernel (variable GLOBAL_CUSTOMKERNEL). In this case Bitscout will compile a custom kernel for you and apply kernel patch to enforce write-blocking mechanism on the kernel level. Credits for the patch go to Maxim Suhanov (more details in his project: https://github.com/msuhanov/Linux-write-blocker).
During initial run, it will prompt for VPN Server, protocol and port number which shall not be prompted on subsequent run, however it can be modified manually.
To modify the VPN settings:
cd ./config
vi bitscout-build.conf
GLOBAL_VPNSERVER=new_vpn_server
GLOBAL_VPNPROTOCOL=new_protocol_type
GLOBAL_VPNPORT=new_port_number
automake.sh
script is executed again, it will use the settings from config/bitscout-build.conf
Note that you do not need to re-download all files when rebuilding after change of settings.Bitscout constructor builds 64-bit system by default. However, if you need to run on older 32-bit setup, you may want to use 32-bit build. In this case you can change the base architecture in config/bitscout-build.conf
file (change GLOBAL_BASEARCH variable from amd64 to i386) before making the ISO file.
If you find any bugs or problems with the project, please open an issue over on Github.
GithubFeel free to tweet at me if you have suggestions for Bitscout. Or if you just want to say hi.
Twitter