Overview

The Senthor Nginx connector integrates directly into your Nginx configuration via the auth_request module. It intercepts incoming requests, analyzes them through the Senthor API, and applies your protection and monetization rules.

Main features

• Server-level integrated WAF protection
• Fail-open mode: if the service is unavailable, traffic passes through normally
• Sensitive headers (cookies, authorization) automatically stripped
• Detailed analytics via Senthor dashboard

Installation

1. Download the configuration file

Place the senthor.conf file in the Nginx snippets directory:

# Télécharger depuis votre dashboard Senthor
# ou directement :
wget -O /etc/nginx/snippets/senthor.conf \
  https://app.senthor.io/connectors/nginx/senthor.conf

2. Enable Senthor in your Nginx configuration

In your server block, include the snippet and configure auth_request:

server {
    ...
    include /etc/nginx/snippets/senthor.conf;

    location / {
        auth_request /senthor-check;
        error_page 403 = /senthor-paywall;
        ...
    }
}

3. Reload Nginx

Reload or restart Nginx to apply the changes:

sudo nginx -t && sudo systemctl reload nginx

How it works

Once configured, the Senthor Nginx connector:

• Intercepts each incoming request via auth_request
• Sends request metadata (method, host, URI, IP) to the Senthor API
• Automatically strips sensitive headers before transmission
• Applies the decision (authorization, blocking, paywall) via the response

If the Senthor API connection fails, the request is allowed by default (fail-open).

That's it!

Your Nginx server is now protected. You can track statistics and configure protection rules from your Senthor.io dashboard.

Automatic update (cron)

To keep your Senthor configuration always up to date, you can set up a cron job that automatically downloads the latest version of the senthor.conf file:

# Cron : mise à jour automatique de senthor.conf (1x/jour à minuit)
0 0 * * * wget -qO /etc/nginx/snippets/senthor.conf \
  https://app.senthor.io/connectors/nginx/senthor.conf \
  && nginx -t && systemctl reload nginx

To set up the cron job, open your crontab:

crontab -e

• The file is automatically updated every day at midnight
• Nginx is reloaded only if the configuration is valid (nginx -t)
• If the download fails, the previous configuration is preserved

Support

For any questions about Nginx integration, contact us at contact@senthor.io

Download the configuration file

The senthor.conf file is available directly from your Senthor dashboard: