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 Kubernetes Ingress Controller + App Protect WAF and DoS are built into a docker container
• Containers are deployed to Azure Container Registry
• Application is deployed to Azure Kubernetes Service
• 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
• cert-manager has been installed to k8s cluster to manage the lifecycle of Let's Encrypt certificates
• cert-manager has been configured to update Azure DNS Zone with the DNS challenges for Let's Encrypt

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 Kubernetes Ingress Controller + App Protect WAF + DoS container to the registry using the steps in the section below
• Set up an Azure Kubernetes Server cluster
• Create both devsecops-stage and devsecops-prod namespaces in the Kubernetes cluster
• Install cert-manager in the cluster
• Set up the following GitHub repository secrets that the workflow requires:

The workflow requires an NGINX Ingress Controller + 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.

NOTE: Ensure that your NGINX certificate and key files (nginx-repo.crt and nginx-repo.key) are present in the root of this directory before executing the following commands.

ACR_NAME=<your ACR name>
KIC_VERSION=2.1.2

az login --use-device-code
az acr login --name "$ACR_NAME"

git clone -b "v$KIC_VERSION" https://github.com/nginxinc/kubernetes-ingress.git
cp nginx-repo.* kubernetes-ingress
pushd kubernetes-ingress

make debian-image-nap-dos-plus PREFIX="$ACR_NAME.azurecr.io/nginx-plus-ingress-nap-waf-dos" TAG="$KIC_VERSION" TARGET=download

popd

docker tag "$ACR_NAME.azurecr.io/nginx-plus-ingress-nap-waf-dos:$KIC_VERSION" "$ACR_NAME.azurecr.io/nginx-plus-ingress-nap-waf-dos:latest"

docker push --all-tags "$ACR_NAME.azurecr.io/nginx-plus-ingress-nap-waf-dos"

This solution makes use of the Elastic Cloud, specifically Elastic and Kibana for NGINX App Protect WAF & DoS analytics. You can set up a free trial for this, or use an existing subscription. Once available, use the following script to install the resources needed:

cd analytics && ./elastic-setup.sh -a \"https://my-deployment:9243\" -b \"elastic:mypassword\" -c \"https://my-deployment:9243\" -d \"elastic:mypassword\"

This is a manual process for now. Refer to Azure DNS documentation for guidance in creating stage and prod DNS zones and records once AKS has assigned a public IP address to the k8s loadbalancers.

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

Show kustomization built configuration for stage environment:

kustomize build manifests/overlays/stage

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

kubectl delete deployment dotnetcorewebapp-stage -n devsecops-stage

kubectl delete deployment dotnetcorewebapp-prod -n devsecops-prod

Original author (@RKSelvi) solution blog:

• Blog post link