NOTE: This Repository contains a work in progress preview of the planned next major secureCodeBox Release. You can find the current stable release here https://github.com/secureCodeBox/secureCodeBox. The release of version 2.0 is still at least some month away but you can already get a sneak peak here π. The release will contain a major architecture change which will not be backward compatible. More details will follow soon in a series of blog articles.
secureCodeBox is a kubernetes based, modularized toolchain for continuous security scans of your software project. Its goal is to orchestrate and easily automate a bunch of security-testing tools out of the box.
For additional documentation aspects please have a look at our:
The typical way to ensure application security is to hire a security specialist (aka penetration tester) at some point in your project to check the application for security bugs and vulnerabilities. Usually, this check is done at a later stage of the project and has two major drawbacks:
- Nowadays, a lot of projects do continuous delivery, which means the developers deploy new versions multiple times each day. The penetration tester is only able to check a single snapshot, but some further commits could introduce new security issues. To ensure ongoing application security, the penetration tester should also continuously test the application. Unfortunately, such an approach is rarely financially feasible.
- Due to a typically time boxed analysis, the penetration tester has to focus on trivial security issues (low-hanging fruits) and therefore will not address the serious, non-obvious ones.
With the secureCodeBox we provide a toolchain for continuous scanning of applications to find the low-hanging fruit issues early in the development process and free the resources of the penetration tester to concentrate on the major security issues.
The purpose of secureCodeBox is not to replace the penetration testers or make them obsolete. We strongly recommend to run extensive tests by experienced penetration testers on all your applications.
Important note: The secureCodeBox is no simple one-button-click-solution! You must have a deep understanding of security and how to configure the scanners. Furthermore, an understanding of the scan results and how to interpret them is also necessary.
There is a german article about Security DevOps β Angreifern (immer) einen Schritt voraus in the software engineering journal OBJEKTSpektrum.
- kubernetes (last 4 major releases supported:
1.15
,1.16
,1.17
&1.18
)
There are shorthand scripts to un-/install everything in the bin
directory.
Deploy the secureCodeBox operator first:
kubectl create namespace securecodebox-system
helm -n securecodebox-system upgrade --install securecodebox-operator ./operator/
Optionally deploy SCB scanner charts for each security scanner you want to use. They should not be installed into the securecodebox-system
like the operator so that different teams can use different kinds of scanners.
helm upgrade --install amass ./scanners/amass/
helm upgrade --install kube-hunter ./scanners/kube-hunter/
helm upgrade --install nikto ./scanners/nikto
helm upgrade --install nmap ./scanners/nmap/
helm upgrade --install ssh-scan ./scanners/ssh_scan/
helm upgrade --install sslyze ./scanners/sslyze/
helm upgrade --install trivy ./scanners/trivy/
helm upgrade --install zap ./scanners/zap/
helm upgrade --install wpscan ./scanners/wpscan/
Optional deploy some demo apps for scanning:
helm upgrade --install dummy-ssh ./demo-apps/dummy-ssh/
helm upgrade --install bodgeit ./demo-apps/bodgeit/
helm upgrade --install juice-shop ./demo-apps/juice-shop/
helm upgrade --install old-wordpress ./demo-apps/old-wordpress/
helm upgrade --install swagger-petstore ./demo-apps/swagger-petstore/
Deploy secureCodeBox Hooks:
helm upgrade --install aah ./hooks/update-field/
helm upgrade --install gwh ./hooks/generic-webhook/
helm upgrade --install issh ./hooks/imperative-subsequent-scans/
Persistence provider Elasticsearch:
helm upgrade --install elkh ./hooks/persistence-elastic/
Now everything is installed. You can try deploying scans from the scanners/*/examples
directories.
E.g. localhost nmap scan:
kubectl apply -f scanners/nmap/examples/localhost/scan.yaml
kubectl apply -f scanners/nmap/examples/scan.nmap.org/scan.yaml
kubectl get scans
- Minio UI:
- AccessKey:
kubectl get secret securecodebox-operator-minio -n securecodebox-system -o=jsonpath='{.data.accesskey}' | base64 --decode; echo
- SecretKey:
kubectl get secret securecodebox-operator-minio -n securecodebox-system -o=jsonpath='{.data.secretkey}' | base64 --decode; echo
- Port Forward Minio UI:
kubectl port-forward -n securecodebox-system service/securecodebox-operator-minio 9000:9000
- AccessKey:
- Elastic / Kibana UI:
- User:
elastic
- Password:
kubectl get secret scb-elasticsearch-es-elastic-user -n scb-analytics -o=jsonpath='{.data.elastic}' | base64 --decode; echo
- Port Forward Kibana:
kubectl port-forward -n default service/persistence-elastic-kibana 5601:5601
- Port Forward Elasticsearch:
kubectl port-forward -n default service/elasticsearch-master 9200:9200
- User:
Code of secureCodeBox is licensed under the Apache License 2.0.
You are welcome, please join us on... π
secureCodeBox is an official OWASP project.
Contributions are welcome and extremely helpful π
Sponsored by iteratec GmbH - secureCodeBox.io