Skip to content

983933-ug: Need to add the details in troubleshooting section #1525

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Oct 8, 2025
Merged

983933-ug: Need to add the details in troubleshooting section #1525

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
507dfb9
983933-ug: Need to add the details in troubleshooting section
sameerkhan001 Oct 8, 2025
8dadf0d
983933-ug: Added proper code.
sameerkhan001 Oct 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions Document-Processing/PDF/Conversions/HTML-To-PDF/NET/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -543,6 +543,58 @@ settings.CommandLineArguments.Add("--ignore-certificate-errors");
</tr>
</table>

## Security Alert - Bundled chrome.exe in HTML-to-PDF Conversion

<table>
<th style="font-size:14px" width="100px">Issue
</th>
<th style="font-size:14px">Security alerts are triggered when the Syncfusion HTML-to-PDF converter uses a bundled `chrome.exe` executable to render HTML content in headless mode during PDF generation.
</th>

<tr>
<th style="font-size:14px" width="100px">Reason
</th>
<td>The HTML-to-PDF conversion relies on Chromium's Blink rendering engine:<br>

1.The NuGet package includes Blink binaries (`chrome.exe`) under `runtimes/win-x64/native`<br
2.This bundled Chrome instance launches in headless mode to render web content<br>
3.Security systems flag the execution of embedded binaries as potential risks<br>
</td>
</tr>

<tr>
<th style="font-size:14px" width="100px">Solution
</th>
<td>Use system-installed Chromium instead of bundled binaries:
<br><br/>
Step 1: Configure Blink Path
{% tabs %}
{% highlight C# tabtitle="C#" %}

HtmlToPdfConverter htmlConverter = new HtmlToPdfConverter();
BlinkConverterSettings settings = new BlinkConverterSettings();

// Point to system-installed Chrome.
settings.BlinkPath = @"C:\Program Files\Google\Chrome\Application";

//Convert HTML to PDF.
htmlConverter.ConverterSettings = settings;
PdfDocument document = htmlConverter.Convert("https://example.com");

//Save and close the document.
document.Save("Output.pdf");
document.Close(true);

{% endhighlight %}
{% endtabs %}

Step 2: Verify Installation <br>
Ensure Chrome exists at the specified path (standard locations): `C:\Program Files\Google\Chrome\Application`

</td>
</tr>
</table>

## Conversion failure in windows server 2012 R2

<table>
Expand Down