Serpico was a cool open-source penetration testing report generation and collaboration tool. It was developed to cut down on the amount of time it takes to write a penetration testing report, and now it's even better!
The installation commands for installing on a Ubuntu 16.04.2 LTS container:
mkdir Serpico-NG && cd Serpico-NG
curl https://raw.githubusercontent.com/dedins/Serpico-NG/master/Dockerfile | docker build -f - .
The installation commands for an Ubuntu 16.04.2 LTS are:
Install required packages:
sudo apt-get install git ruby ruby-dev build-essential make pkg-config libxml2-dev libglib2.0-dev libsqlite3-dev bundler
Clone git repository:
git clone https://github.com/Serpico-NG/Serpico-NG.git
Install Serpico-NG dependencies:
cd Serpico-NG && bundler install
Clone repository of dm-types library:
cd .. && git clone -b "gem-v1.2.2-with-frozen-nilclass-fix" https://github.com/julienma/dm-types.git
Install dm-types library:
cd dm-types && gem build dm-types.gemspec && sudo gem install dm-types-1.2.2.gem
Launch the first_time.rb script (in order to initialize the database) and follow the instructions:
cd Serpico-NG && ruby scripts/first_time.rb
And then start Serpico-NG (HTTPS, 8443 port, on 127.0.0.1 by default):
cd Serpico-NG && ruby serpico.rb &
Serpico is at its core a report generation tool but targeted at creating information security reports. When building a report the user adds "findings" from the template database to the report. When there are enough findings, click 'Generate Report' to create the docx with your findings. The docx design comes from a Report Template which can be added through the UI; a default one is included. The Report Templates use a custom Markup Language to stub the data from the UI (i.e. findings, customer name, etc) and put them into the report.
Nexpose parser added.
Now you can import findings directly from Nexpose XML report and have your doc report done in seconds.
Philosophy: Having things under control.
Statistics and beatiful charts (Thanks Chart.js) were added.
Philosophy: Calculating risk of findings should be easy.
Now the analyst is able to calc the CVSS (v2) score directly from the finding view, keeping the focus on it.
XLSX Remediation Plan Generate the remediation plan in just one click.
Philosophy: Scheduling.
Now you can place your tasks over time and see the history on a nice calendar view
Now you can backup database (including attachments) and restore in matter of seconds! (See Wiki)
Philosophy: Automation. A Natural Language Processing library was added, it summarize the description of findings for you, saving precious time.
Philosophy: Editing a report template should be easy. During peer review we would constantly ran into "little things" we were fixing from the report template; an extra space here, a misspelling there. But it adds up. With Serpico, "fix" the report template, upload it back through the UI, and generate a new report; the error should be fixed permanently.
Philosophy: We do not need to write most findings from scratch. Most findings have been found in a previous assessment. In Serpico, all authors can pull findings from the template database and add to the report. A user can also 'Upload' a finding they made into the Template Database to share with everyone.
Philosophy: It should be easy to share files with teammates. Use the 'Add Attachment' functionality to store a file (e.g. screenshots, nmap scans) or share with teammates on a pen test. No thumb drive swapping or e-mailing, just log into the UI and download the files. At the end of the assessment everything traded or generated for that assessment is in one place.
The Meta language used for Microsoft Word was designed to be as simple as possible while still serving enough features to create a basic penetration test report.
See also: