Installation

1. Install the module dependencies:

   UbuntuCentos

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

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

2. Extract the module:

   ActionScriptActionScript

   actionscript

   bunzip2 envoy.bz2
   

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

   ShellShell

   Shell

   cp envoy /usr/local/bin/
   

4. In your config.yaml file add, a new filter in the http_filterssection:

   YAMLYAML

   YAML

   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: ""
             px_cookie_secret: ""
             px_auth_token: ""
   

Make sure to update the following required properties:

• app_id - The HUMAN 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.