Ingress NGINX Controller with HUMAN Enforcer

Ingress NGINX Controller with the Enforcer

px-nginx-ingress-controller image is based on Ingress NGINX Controller

• Supported architecture: amd64

DockerHub project page: https://hub.docker.com/r/perimeterx/px-nginx-ingress-controller

Docker Pull Command: docker pull perimeterx/px-nginx-ingress-controller:TAG

Versioning schema: px-nginx-ingress-controller:vX.X.X-Y.Y.Y-Z

Where:

• vX.X.X: ingress-nginx version (ChangeLog: https://github.com/kubernetes/ingress-nginx/releases/)
• Y.Y.Y: Nginx Enforcer version (ChangeLog: https://docs.perimeterx.com/docs/whats-new-nginx)
• Z: module configuration type (server or location)

Configuration types:

• server (preferred): should go to “server ” section of nginx.conf.
• location (please avoid this type): should go to “location ” section of nginx.conf.

The following line must be present at the top of /etc/nginx/nginx.conf file:

thread_pool px_pool threads=10;

Example of HELM command to install PerimeterX Ingress NGINX Controller with the Enforcer

helm install nginx-ingress ingress-nginx/ingress-nginx --version <HELM CHART VERSION> --values px-values.xml (e.g.: helm install nginx-ingress ingress-nginx/ingress-nginx --version 4.8.0 --values px-values.xml)

Where px-values.xml is:

1
controller:
2
    name: controller
3
    image:
4
      registry: docker.io
5
      image: perimeterx/px-nginx-ingress-controller
6
      tag: TAG
7
      digest: DIGEST
8
    config:
9
      server-snippet: |
10
        px_enabled on;
11
        px_appId "--REPLACE--";
12
        px_cookie_secret "--REPLACE--";
13
        px_auth_token "--REPLACE--";
14
        # add other PX related settings here

Both TAG and DIGEST can be found on https://hub.docker.com/r/perimeterx/px-nginx-ingress-controller/tags page.