mirror of
https://github.com/InvoiceShelf/InvoiceShelf.git
synced 2026-08-04 07:02:13 +00:00
f8cfb6cd33
* fix: allow Gotenberg to reach private/Docker-internal hosts (Issue #688) The SSRF guard introduced in #664/#671 correctly blocks arbitrary private URLs, but also prevents legitimate use-cases where Gotenberg runs alongside InvoiceShelf in a Docker Compose network (e.g. the default http://pdf:3000 service name resolves to a private IP). Add a `gotenberg_allow_private_host` setting (env: GOTENBERG_ALLOW_PRIVATE_HOST, default false) that: - skips PrivateNetworkGuard in GotenbergPdfDriver - skips PublicHttpUrl validation in PDFConfigurationRequest - exposes a clearly-warned toggle in the admin PDF settings UI - is persisted to the settings table and loaded via AppConfigProvider A disabled guard is safe for controlled private networks (Docker Compose, LAN); it must never be enabled for untrusted hosts. The UI surfaces a prominent warning to communicate this constraint. Closes #688 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * refactor(gotenberg): scope the private-host exemption to a declared host Reshapes the escape hatch from a boolean admin setting into an environment-declared host allowlist. The driver streams the upstream response body back as the PDF, so a mis-set Gotenberg host is full-response SSRF — pointed at a link-local metadata endpoint it returns cloud credentials. A blanket "allow private" switch left that reachable: gotenberg_host stays editable from the admin UI, so any install that enabled the switch to run a sidecar could have the host repointed at an internal service. The population the flag existed to serve was exactly the population it failed to protect. GOTENBERG_ALLOWED_PRIVATE_HOST now names the single host that may skip the guard. Only that exact value is exempt; every other private target stays blocked. GotenbergHostPolicy owns the comparison so the save-time rule and the runtime driver guard cannot drift, and normalises case, trailing slash and surrounding whitespace on both sides. Being env-only also drops the settings-table key, the AppConfigProvider branch and the whole admin UI surface — the toggle there could not be switched on in any case, since BaseSwitchSection has no slot and was passed no v-model, so the child BaseSwitch was discarded and the value never changed from false. Restores the gotenberg_margins validation rule, which the previous revision replaced rather than added alongside. Tests cover both directions, including that declaring one private host does not exempt another; sabotaging the policy to always exempt fails 16 of the 22. Co-authored-by: csoscd <csoscd@users.noreply.github.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com> Co-authored-by: Darko Gjorgjijoski <dg@darkog.com> Co-authored-by: csoscd <csoscd@users.noreply.github.com>
40 lines
1.2 KiB
Plaintext
40 lines
1.2 KiB
Plaintext
APP_ENV=production
|
|
APP_DEBUG=false
|
|
APP_KEY=base64:kgk/4DW1vEVy7aEvet5FPp5un6PIGe/so8H0mvoUtW0=
|
|
|
|
APP_NAME="InvoiceShelf"
|
|
APP_TIMEZONE=UTC
|
|
APP_URL=
|
|
APP_LOCALE=en
|
|
|
|
DB_CONNECTION=sqlite
|
|
DB_HOST=
|
|
DB_PORT=
|
|
DB_DATABASE=
|
|
DB_USERNAME=
|
|
DB_PASSWORD=
|
|
|
|
SESSION_DOMAIN=null
|
|
SANCTUM_STATEFUL_DOMAIN=
|
|
TRUSTED_PROXIES="*"
|
|
|
|
# Dompdf: keep false so untrusted HTML in PDF notes cannot trigger outbound requests (SSRF).
|
|
# Set true only if you fully trust all PDF HTML and need remote images/CSS.
|
|
DOMPDF_ENABLE_REMOTE=false
|
|
|
|
# Gotenberg (optional alternative PDF driver; the default is dompdf).
|
|
# PDF_DRIVER=gotenberg
|
|
# GOTENBERG_HOST=http://pdf:3000
|
|
# GOTENBERG_PAPERSIZE="210mm 297mm"
|
|
#
|
|
# Gotenberg is normally a sidecar on a private network, which the SSRF guard
|
|
# rejects. Name that one host to exempt it — and only it. Every other private
|
|
# target stays blocked, so the host cannot later be repointed at an internal
|
|
# service. Leave unset unless you actually run Gotenberg privately.
|
|
# GOTENBERG_ALLOWED_PRIVATE_HOST=http://pdf:3000
|
|
|
|
# InvoiceShelf marketplace and updater base URL.
|
|
# Defaults to https://invoiceshelf.com. Override to point at a local website
|
|
# checkout for development:
|
|
# INVOICESHELF_BASE_URL=http://invoiceshelf-website.test
|