fix: align TSA handler errors with connectivity guidance

vitormattos · vitormattos · commit a15291a4e013 · 2026-04-05T22:16:43.000-03:00
Signed-off-by: Vitor Mattos &lt;1079143+vitormattos@users.noreply.github.com&gt;
diff --git a/lib/Handler/SignEngine/JSignPdfHandler.php b/lib/Handler/SignEngine/JSignPdfHandler.php
@@ -671,10 +671,10 @@ private function checkTsaError(string $errorMessage): void {
 
 		if ($isTsaError) {
 			if (str_contains($errorMessage, 'Invalid TSA') && preg_match("/Invalid TSA '([^']+)'/", $errorMessage, $matches)) {
-				$friendlyMessage = 'Timestamp Authority (TSA) service is unavailable or misconfigured: ' . $matches[1];
+				$friendlyMessage = 'Timestamp Authority (TSA) service is unavailable. Check DNS/network/firewall connectivity from this server: ' . $matches[1];
 			} else {
 				$friendlyMessage = 'Timestamp Authority (TSA) service error.' . "\n"
-					. 'Please check the TSA configuration.';
+					. 'Check TSA endpoint and DNS/network/firewall connectivity from this server.';
 			}
 			throw new LibresignException($friendlyMessage);
 		}

Original file line number	Diff line number	Diff line change
`@@ -671,10 +671,10 @@ private function checkTsaError(string $errorMessage): void {`
`671`	`671`
`672`	`672`	`if ($isTsaError) {`
`673`	`673`	`if (str_contains($errorMessage, 'Invalid TSA') && preg_match("/Invalid TSA '([^']+)'/", $errorMessage, $matches)) {`
`674`		`- $friendlyMessage = 'Timestamp Authority (TSA) service is unavailable or misconfigured: ' . $matches[1];`
	`674`	`+ $friendlyMessage = 'Timestamp Authority (TSA) service is unavailable. Check DNS/network/firewall connectivity from this server: ' . $matches[1];`
`675`	`675`	`} else {`
`676`	`676`	`$friendlyMessage = 'Timestamp Authority (TSA) service error.' . "\n"`
`677`		`- . 'Please check the TSA configuration.';`
	`677`	`+ . 'Check TSA endpoint and DNS/network/firewall connectivity from this server.';`
`678`	`678`	`}`
`679`	`679`	`throw new LibresignException($friendlyMessage);`
`680`	`680`	`}`