Project status details:
Quality testing SKF-Angular:
Quality testing SKF-API:
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.
- Introduction
- Installing
- Updating
- Usage
- CI-Pipeline
- Development / Contributing
- Scrum Board
- License
- Contributors
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 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
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
# 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:
Readme: extended documentation
https://waffle.io/blabla1337/skf-flask
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:
https://travis-ci.org/blabla1337/skf-flask
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:
https://coveralls.io/r/blabla1337/skf-flask
Code coverage done right. Highly integrated with GitHub, Bitbucket and GitLab.
SKF codecov details:
https://codecov.io/gh/blabla1337/skf-flask
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:
https://scrutinizer-ci.com/g/blabla1337/skf-flask/
BitHound provides your Node team with comprehensive and prioritized issues in your code and npm packages.
SKF Bithound details:
https://www.bithound.io/github/blabla1337/skf-flask
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:
https://requires.io/github/blabla1337/skf-flask/requirements/
Announcing Black Duck CoPilot, a new service helping open source project teams catalog and report on their project's dependencies.
SKF Requires details:
https://copilot.blackducksoftware.com/github/groups/blabla1337/locations/skf-flask/public/results
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.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/>.
- Owasp
Licensed under the creative commons license
- 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
- Priyanka Jaine