Reverse Proxy

Autentico listens on plain HTTP. Always deploy it behind a TLS-terminating reverse proxy in production.

Caution

Set AUTENTICO_APP_URL to your public HTTPS URL — not the internal HTTP address. The issuer claim in tokens and the OIDC discovery document are derived from this value.

Caddy

Caddy handles TLS automatically via Let’s Encrypt:

auth.example.com {
    reverse_proxy localhost:9999
}

Or with Docker Compose (Autentico on internal network):

auth.example.com {
    reverse_proxy autentico:9999
}

nginx

server {
    listen 443 ssl;
    server_name auth.example.com;

    ssl_certificate     /etc/ssl/certs/auth.example.com.crt;
    ssl_certificate_key /etc/ssl/private/auth.example.com.key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        proxy_pass         http://127.0.0.1:9999;
        proxy_set_header   Host              $host;
        proxy_set_header   X-Real-IP         $remote_addr;
        proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
    }
}

server {
    listen 80;
    server_name auth.example.com;
    return 301 https://$host$request_uri;
}

Traefik

Label your Docker container:

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.autentico.rule=Host(`auth.example.com`)"
  - "traefik.http.routers.autentico.entrypoints=websecure"
  - "traefik.http.routers.autentico.tls.certresolver=letsencrypt"
  - "traefik.http.services.autentico.loadbalancer.server.port=9999"

CORS

If your relying party SPA needs to call the token endpoint from a browser, configure allowed origins via the Admin UI (CORS page) or the cors_allowed_origins runtime setting:

# Via API
curl -X PUT \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cors_allowed_origins": "https://app.example.com,https://admin.example.com"}' \
  https://auth.example.com/admin/api/settings

Use specific origins in production. Set * to allow all origins (development only). Leave empty to disable CORS and handle it at the reverse proxy level instead.

Headers

The X-Forwarded-For and X-Real-IP headers are logged with each request. Ensure your proxy sets them so the logs reflect real client IPs rather than the proxy’s IP.