# Introduction

![security knowledge framework](https://3340202422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LVYiEUhSeJlr6AAhtYG%2Fuploads%2Fgit-blob-7017518ad5b3e272bb7ab61d814485b864ee0d3b%2Flogo.svg?alt=media\&token=ed9b5cba-6b2d-4159-8d9e-2a595920ea4b)

Here we find all the labs and write-ups for the security knowledge framework!\
These labs are correlated to knowledge-base id's which are on their place\
again correlated to security controls such as from the ASVS or NIST, etc.

The labs are all downloadable from the following Github repository:

{% hint style="info" %}
[SKF Labs repo](https://github.com/Security-Knowledge-Framework/Labs)
{% endhint %}

The images can also be found on the skf docker hub. These skf-labs images are automatically pushed to the docker registry on each commit to the Github repository.

## Useful tools

First thing we need to do is to be able to investigate the requests that are being made by the labs/applications. We do this by setting up our intercepting proxy so we can gain more understanding of the application under test.

{% hint style="info" %}
Burp suite:\
[https://portswigger.net/burp/communitydownload](https://portswigger.net/burp/communitydownload)
{% endhint %}

{% hint style="info" %}
ZAP: For the latest features we want to advise to use the Weekly build of ZAP. This is using the latest and greatest improvements + Libraries [https://www.zaproxy.org/download/#weekly](https://www.zaproxy.org/download/#weekly)
{% endhint %}

## How to add a Lab & write-up

When you want to contribute and add your own labs then please make sure you use the styling template in one of the lab challenges. We think its really important to have one look and feel and for able to merge your lab its required to use the SKF template. You can copy this from any of the labs we currently already have.

For adding the write-up for the lab we advice to create a copy of on existing write-up and work from there or use the template.md file as a base. You can store all your images in .gitbook/assets/ and also make sure you correlate your lab to one of the knowledge base item identifier in SKF. When you completed the lab and the write-up you only have to add it to the SUMMARY.md file and you are ready to create your Pull Request.

After the pull request you can find your nice styled write-up here: [https://skf.gitbook.io/asvs-write-ups/](https://skf.gitbook.io/asvs-write-ups/)

## Deploying SKF Lab's from your terminal

You can now deploy skf-lab from your terminal, with [joyghoshs/skf-cli](https://github.com/joyghoshs/skf-cli), you don't need to setup server if you don't want to with skf-cli you can deploy lab with security knowledge frameworks own api, if you want you can also search and deploy lab using skf-cli.
