Forked and adapted from RKSelvi/devsecops-poc for NGINX Sprint Conference, 2021.

This repo is intended to demonstrate how to integrate NGINX App Protect WAF and DoS products into a typical DevSecOps workflow leveraging open source tooling.

The repository is featured in the Automate Application Security with NGINX conference session. A link to the session video will be included here once it airs.

• GitHub CI/CD has been leveraged for testing DevSecOps pipeline
• GitHub Actions pipeline has been implemented
• .NET code project built as docker container
• NGINX App Protect WAF and DoS are built into a docker container
• Containers are deployed to Azure Container Registry
• Application and App Protect proxy tiers is deployed to Azure Kubernetes
• CodeQL - GitHub's new code scanning workflow has been added for code scan
• Container linting, package vulnerability scanning
• Selenium tests run
• OWASP ZAP DAST scan run
• Container action has been added

The following are the high-level tasks needed to be able to run this POC yourself.

• Set up an Azure Container Registry
• Build and push The NGINX App Protect WAF + DoS container to the registry using the steps in the section below
• Set up an Azure Kubernetes Server cluster with an HTTP ingress enabled
• Create both devsecops-stage and devsecops-prod namespaces in the Kubernetes cluster
• Set up the following GitHub repository secrets that the workflow requires:

The workflow requires an NGINX App Protect WAF + DoS base container to be present your the Azure Container Registry. Since these are commercially-licensed products, you will need to request a free trial, and use this to build your own container.

cd app-protect
az login --use-device-code
az acr login --name <your acr name>

DOCKER_BUILDKIT=1 docker build --no-cache --secret id=nginx-crt,src=nginx-repo.crt --secret id=nginx-key,src=nginx-repo.key -t <your acr name>.azurecr.io/nginx-app-protect-waf-dos:3.4 -t <your acr name>.azurecr.io/nginx-app-protect-waf-dos:latest -f Base-Dockerfile .

docker push <your acr name>.azurecr.io/nginx-app-protect-waf-dos

Not specifically required, but deleting old GitHub workflow runs promotes cleanliness, especially when demoing. Credit: This is a local copy of the bash script by @qmacro Requires: jq, gh and fzf packages.

chmod +x delete-github-workflow-runs.sh
./util/delete-github-workflow-runs.sh <github id>/<repo name>

Get pod names in a particular namespace:

kubectl get pods -n devsecops-stage

SSH into one of the pods from the above command:

kubectl exec --stdin --tty -n devsecops-stage nap-dotnetcorewebapp-stage-84dbbb5bbf-7xffw -- /bin/bash

If you need to delete stage and prod deployments, use the following commands:

kubectl delete deployment dotnetcorewebapp-stage -n devsecops-stage
kubectl delete deployment nap-dotnetcorewebapp-stage -n devsecops-stage

kubectl delete deployment nap-dotnetcorewebapp-prod -n devsecops-prod
kubectl delete deployment dotnetcorewebapp-prod -n devsecops-prod

Original author (@RKSelvi) solution blog:

• Blog post link