mirror of
https://github.com/InvoiceShelf/InvoiceShelf.git
synced 2026-09-06 23:24:13 +00:00
Darko Gjorgjijoski
4d6ece6230
Backport of InvoiceShelf/InvoiceShelf#691 to 2.x, for the reporter of #688 who is on 2.4.1. The guard added in the 2.4.0 security round rejects private addresses, which includes the shipped default host `http://pdf:3000` and every Docker Compose sidecar deployment. So the guard rejects its own default and Gotenberg cannot be configured at all on the standard setup — a usability regression introduced by a security patch, which is why this lands during the 2.x feature freeze. GOTENBERG_ALLOWED_PRIVATE_HOST names the single host that may skip the check. It is deliberately not a boolean and not settable from the admin UI: the driver streams the upstream response body back as the PDF, so a blanket "allow private" switch would let gotenberg_host be repointed at a link-local metadata endpoint and the response read back. Naming one host keeps the sidecar working while every other private target stays blocked. GotenbergHostPolicy owns the comparison so the save-time rule and the runtime driver guard cannot drift, normalising case, trailing slash and surrounding whitespace on both sides. Note this differs from 3.x in one respect: SafeRemoteUrl rejects hosts that do not resolve, where 3.x's PrivateNetworkGuard lets them through. That behaviour is unchanged here — a typo'd host is still refused at save time on 2.x, which is the friendlier outcome.
84 lines
2.6 KiB
PHP
84 lines
2.6 KiB
PHP
<?php
|
|
|
|
namespace App\Support;
|
|
|
|
use App\Rules\SafeRemoteUrl;
|
|
|
|
/**
|
|
* Decides whether a Gotenberg host is exempt from {@see SafeRemoteUrl}.
|
|
*
|
|
* Gotenberg is normally deployed as a sidecar on a private network — the shipped
|
|
* default host is `http://pdf:3000` — which the SSRF guard rejects. The exemption
|
|
* is declared in the environment and names the single host it trusts:
|
|
*
|
|
* GOTENBERG_ALLOWED_PRIVATE_HOST=http://pdf:3000
|
|
*
|
|
* It is deliberately NOT a boolean and deliberately not settable from the admin
|
|
* UI. `gotenberg_host` itself stays editable, and the driver returns the upstream
|
|
* response body verbatim as the PDF — so a blanket "allow private" switch would
|
|
* let that setting be repointed at a link-local metadata endpoint and read back
|
|
* the response. Matching one declared host keeps the sidecar working while every
|
|
* other private target stays blocked.
|
|
*
|
|
* Both the save-time validation rule and the runtime driver guard call this, so
|
|
* the two layers cannot drift apart.
|
|
*/
|
|
class GotenbergHostPolicy
|
|
{
|
|
/**
|
|
* Whether the given host is the operator-declared Gotenberg host, and may
|
|
* therefore skip the public-address check.
|
|
*/
|
|
public static function isExemptFromSafeRemoteUrl(?string $host): bool
|
|
{
|
|
$allowed = config('pdf.connections.gotenberg.allowed_private_host');
|
|
|
|
if (! is_string($allowed) || ! is_string($host)) {
|
|
return false;
|
|
}
|
|
|
|
$allowed = self::normalize($allowed);
|
|
$host = self::normalize($host);
|
|
|
|
// An unset or unparseable allowlist never exempts anything.
|
|
return $allowed !== null && $allowed === $host;
|
|
}
|
|
|
|
/**
|
|
* Reduce a URL to scheme://host[:port][/path] with casing and any trailing
|
|
* slash removed, so `HTTP://PDF:3000/` and `http://pdf:3000` compare equal.
|
|
*
|
|
* Returns null when the value is empty or carries no scheme and host.
|
|
*/
|
|
protected static function normalize(string $url): ?string
|
|
{
|
|
$url = trim($url);
|
|
|
|
if ($url === '') {
|
|
return null;
|
|
}
|
|
|
|
$parts = parse_url($url);
|
|
|
|
if ($parts === false || ! isset($parts['scheme'], $parts['host'])) {
|
|
return null;
|
|
}
|
|
|
|
// parse_url keeps IPv6 literals bracketed; strip them on both sides so
|
|
// the comparison is consistent.
|
|
$host = strtolower(trim($parts['host'], '[]'));
|
|
|
|
if ($host === '') {
|
|
return null;
|
|
}
|
|
|
|
return sprintf(
|
|
'%s://%s%s%s',
|
|
strtolower($parts['scheme']),
|
|
$host,
|
|
isset($parts['port']) ? ':'.$parts['port'] : '',
|
|
rtrim($parts['path'] ?? '', '/'),
|
|
);
|
|
}
|
|
}
|