OWASP Security Knowledge Framework
Security Knowledge Framework is an expert system application that uses the OWASP Application Security Verification Standard with detailed code examples (secure coding principles) to help developers in pre-development and post-development phases and create applications that are secure by design.
Table of Contents
- Development / Contributing
- Scrum Board
Our experience taught us that the current level of security of web-applications is not sufficient enough to ensure security. This is mainly because web-developers simply aren't aware of the risks and dangers that are lurking, waiting to be exploited by hackers.
Because of this we decided to develop a framework in order to create a guide-system available for all developers so they can develop applications secure by design from the start.
The OWASP Security Knowledge Framework is here to support developers create secure applications. By using the OWASP Application Security Verification Standards. as a security requirement and give the developer feedback regarding descriptions and solutions on how to properly implement these security controls in a safe manner.
The second stage is validating if the developer properly implemented different security controls and the belonging defence mechanisms by means of checklists created with the OWASP Application Security Verification Standards. By means of the answers supplied by the developer the application again generates documentation in which it gives feedback on what defence mechanisms the developer forgot to implement and give him feedback regarding descriptions and solutions on how to properly implement these techniques in a safe manner.
Local / dedicated server install
Local installation based on Ubuntu 16.04.
- nginx (
sudo apt install nginx)
- npm (
sudo apt install npm)
- ng (
sudo apt install ng-common)
- latest version of node ():
* sudo npm install n -g * sudo n stable
- python3.6, pip3.6 (https://stackoverflow.com/questions/42662104/how-to-install-pip-for-python-3-6-on-ubuntu-16-10):
* sudo add-apt-repository ppa:jonathonf/python-3.6 # (only for 16.04 LTS) * sudo apt update * sudo apt install python3.6 * wget https://bootstrap.pypa.io/get-pip.py * sudo python3.6 get-pip.py
Installation SKF and configuration:
Run on terminal
cd /tmp; git clone git://github.com/blabla1337/skf-flask.git cd /tmp/skf-flask; pip3.6 install -r requirements.txt cd /tmp/skf-flask/Angular; npm install cd /tmp/skf-flask/Angular; ng build --aot --configuration=production rm /etc/nginx/sites-enabled/default cp /tmp/skf-flask/Local/site-tls.conf /etc/nginx/sites-enabled/default mv /tmp/skf-flask / # Change the JWT_SECRET value with below command perl -pi -e "s/JWT_SECRET = ''/JWT_SECRET = 'THIS_SHOULD_BE_CHANGED_AND_RANDOM'/" /skf-flask/skf/settings.py # Change the domain value with below command perl -pi -e "s/\*/https:\/\/demo.securityknowledgeframework.org/" /skf-flask/skf/settings.py # Change the domain value with below command perl -pi -e "s/https:\/\/localhost\/api/https:\/\/demo.securityknowledgeframework.org\/api/" /skf-flask/Angular/src/environments/environment.prod.ts # Change the domain value with below command perl -pi -e "s/localhost/demo.securityknowledgeframework.org/" /skf-flask/Local/skf-angular.sh # Certificates stored in /skf-flask/ dir openssl req -nodes -newkey rsa:4096 -keyout /skf-flask/server.key -out /skf-flask/server.csr -subj "/CN=OWASP-SKF" openssl x509 -req -days 365 -in /skf-flask/server.csr -signkey /skf-flask/server.key -out ./skf-flask/server.pem # Start nginx sleep 5 sudo nginx
Run SKF (with terminal in Local folder):
# Start SKF services cd /skf-flask/Local; bash wrapper.sh
Navigate to https://your_domain_value_you_used_above_commands
If you get the following error
nginx: [emerg] a duplicate default server for 0.0.0.0:80 in /etc/nginx/sites-enabled/default:17
If you are not using that file just remove it: (
sudo rm /etc/nginx/sites-enabled/default)
The fastest way to start using the SKF project is using the pre-built container hosted at Docker hub. This container always has the very latest version from the master repository. Change the JWT_SECRET value to a new random secret string before starting the docker image.
First run the docker pull command to get the latest image
docker pull blabla1337/skf-flask
Then start the docker image
docker run -e "ORIGIN=localhost" -e "JWT_SECRET=change_this_super_secret_random_string" -ti -p 127.0.0.1:443:443 blabla1337/skf-flask
You can also store the database outside of the Docker container so all the data is persistant Replace the /Users/gibson/Desktop/development/skf-flask/skf/db/db.sqlite with your db.sqlite file you have locally and then run:
docker run -v /Users/gibson/Desktop/development/skf-flask/skf/db/db.sqlite:/skf-flask/skf/db/db.sqlite -e "ORIGIN=localhost" -e "JWT_SECRET=change_this_super_secret_random_string" -ti -p 127.0.0.1:443:443 blabla1337/skf-flask
The application will greet you on: https://localhost
There is a method available to update the content of the SKF application.
When you have modified or created new Knowledge base items, code examples or checklist you need to run the following commands in the SKF root directory:
export FLASK_APP=skf/app.py export PYTHONPATH=.:$PYTHONPATH flask updatedb
For more detailed information such as setting up an admin account and user guides please see the extended documentation that can be found below:
Test and Deploy with Confidence. Easily sync your GitHub projects with Travis CI and you'll be testing your code in minutes! SKF Build details:
DELIVER BETTER CODE. We help developers deliver code confidently by showing which parts of your code aren't covered by your test suite. SKF Coveralls details:
codecov.io for Angular:
Code coverage done right. Highly integrated with GitHub, Bitbucket and GitLab. SKF codecov details:
Why to use Scrutinizer. Improve code quality and find bugs before they hit production with our continuous inspection platform. Improve Code Quality. SKF Scrutinizer details:
Bithound.io NPM packages:
BitHound provides your Node team with comprehensive and prioritized issues in your code and npm packages. SKF Bithound details:
Requires.io pip packages:
Stay Up-to-date! Stay secure! Requires.io monitors your Python projects dependencies, and notify you whenever any of your dependency is out-of-date. SKF Requires details:
Black Duck Security Risk:
Announcing Black Duck CoPilot, a new service helping open source project teams catalog and report on their project's dependencies. SKF Requires details:
Monitor HTTP(s), Ping, Port and check Keywords. Get alerted via e-mail, SMS, Twitter, web-hooks or push. View uptime, downtime and response times.
ssllabs.com & sslbadge.org:
ssllabs.org: Bringing you the best SSL/TLS and PKI testing tools and documentation. sslbadge.org: Creates a nice badge for your website SSL/TLS security settings based on the Qualys SSL Labs testing.
Copyright (C) 2017 Glenn ten Cate, Riccardo ten Cate This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
- Glenn ten Cate
- Riccardo ten Cate
- Alexander Kaasjager
- John Haley
- Daniel Paulus
- Erik de Kuijper
- Roderick Schaefer
- Jim Manico
- Martijn Gijsberti Hodenpijl
- Bithin Alangot
- Martin Knobloch
- Adam Fisher
- Tom Wirschell
- Joerg Stephan
- Simon Brakhane
- Gerco Grandia
- Ross Nanopoulos
- Bob van den Heuvel
- Mariano Jose Abdala
- Ilguiz Latypov
- Laurence Keijmel
- Rick Mitchell (Kingthorin)
- Xenofon Vassilakopoulos
- Heeraj Nair
- Alpha Kitonga
- Wojciech Reguła
- Amadeusz Starzykiewicz
- Adam Zima
- Kacper Madej
- Rafał Fronczyk
- Chang Xu (Neo)
- Martin Marsicano