Installation

Install the module dependencies:

apt update && apt install -y libcurl4 libapr1 libjansson4 libaprutil1 bzip2

yum update && yum install -y jansson libcurl apr apr-util pcre

Extract the module:

bunzip2 envoy.bz2

Copy the new Envoy binary to /usr/local/bin/ folder:

cp envoy /usr/local/bin/

In your config.yaml file add, a new filter in the http_filters section:

http_filters:
    ...
    - name: perimeterx
      typed_config:
        "@type": type.googleapis.com/udpa.type.v1.TypedStruct
        type_url: type.googleapis.com/envoy.extensions.filters.http.perimeterx
        value:
          px_enabled: true
          px_appid: "<APP_ID>"
          px_cookie_secret: "<COOKIE_SECRET>"
          px_auth_token: "<AUTH_TOKEN>"

Make sure to update the following required properties:

app_id - The PerimeterX application id in the format of PX__. The application id can be found at Platform Settings -> Applications section.
cookie_secret - The key used by the cookie signing page. The Cookie Key is generated in the Platform Settings -> Policies section.
auth_token - The JWT token for REST API. The Authentication Token is generated in the Platform Settings -> Applications section.