Use the njs Scripting language

F5 NGINX as a Service for Azure (NGINXaaS) supports the open-source njs module, allowing the extension of NGINX functionality with a subset of the Javascript language.

Upload NGINX configuration with njs

Create an njs script file by uploading a gzipped tar file or create the script file in the editor. See NGINX Configuration for a step-by-step guide.

Note: If specifying an absolute file path as your njs script’s File path, see the NGINX Filesystem Restrictions table for the allowed directories the file can be written to.

Switch between the language options to see syntax highlighting for NGINX configs or JavaScript.

To use njs, enable the ngx_http_js_module module and specify the js_import directive with your njs file.

load_module modules/ngx_http_js_module.so;

http {
    js_import http.js;

    server {
        location / {
            js_content http.hello;
        }
    }
}

njs validation

NGINXaaS will not parse, evaluate, or run any provided njs scripts when validating the NGINX configuration. Enable logging to monitor errors caused by njs scripts.

“fs” module

The njs File System module provides operations with files. NGINXaaS only allows reading and writing from specified directories.