Skip to content

Commit e94ae9e

Browse files
authored
Update FAQ related to Chrome 142 (#941)
1 parent b8a8483 commit e94ae9e

File tree

6 files changed

+80
-44
lines changed

6 files changed

+80
-44
lines changed

_articles/faq/chromium-142-local-network-access-issue.md

Lines changed: 37 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -7,78 +7,87 @@ keywords: Dynamic Web TWAIN, Error Troubleshooting, CORS, unknown address space,
77
breadcrumbText: Error message - Permission was denied for this request to access the unknown address space
88
description: CORS unknown address space
99
date: 2025-11-04 17:21:42 +0800
10-
last_modified: 2025-11-04 17:21:42 +0800
10+
last_modified: 2025-11-05 17:26:42 +0800
1111
---
1212

1313
# Error Troubleshooting
1414

1515
> [!IMPORTANT]
1616
> This is a newly developing issue, and as such the information in this article may change over time.
1717
18-
## Error message - Access to fetch at `https://127.0.0.1:18623` or `http://127.0.0.1:18622` has been blocked by CORS policy: Permission was denied for this request to access the unknown address space.
18+
## Error message - CORS Errors caused by local network access permissions when using Chromium 142 and later
1919

20-
### Symptom
20+
### Overview
2121

22-
When using Chromium-based browsers version 142 or later (released on October 28th, 2025), including Chrome, Edge, Brave, and Opera, the Dynamsoft Web TWAIN Service may fail to function properly:
22+
Starting in **Chromium-based browsers v142+** (released Oct 28, 2025)including Chrome, Edge, Brave, and OperaDynamsoft Web TWAIN Service may not work as expected due to new local-network security rules.
2323

24-
- Phenomenon 1: the browser prompts users to download the service installer even though it is already installed.
24+
### Symptoms
2525

26-
![DWT_installer.png](/assets/imgs/DWT_installer.png)
26+
You may experience one or more of the following:
27+
28+
***1. Service installer repeatedly prompted***
2729

28-
- Phenomenon 2: the initialization succeeds, but scanning or loading images results in blank images.
30+
The browser prompts you to download/install the service even though it is already installed.
31+
![DWT_installer.png](/assets/imgs/DWT_installer.png)
2932

30-
Open the browser console (press F12, then go to the Console tab), you should see the following error message:
33+
***2. Initialization succeeds, but scan/load shows blank images***
3134

35+
The browser console (F12 → Console) shows a CORS rejection similar to:
3236
```shell
3337
Access to fetch at 'https://127.0.0.1:18623/fa/VersionInfo?ts=1761893667670' from origin 'https://your-domain.com' has been blocked by CORS policy: Permission was denied for this request to access the `unknown` address space.
3438
```
3539

36-
### Cause
40+
### Root Cause
3741

38-
In Chromium 142 Google introduced a new [Local Network Access security policy](https://chromestatus.com/feature/5152728072060928). Requests from web pages to local addresses such as 127.0.0.1 or localhost get blocked unless explicit permission is granted.
42+
Chromium 142 introduces a new [Local Network Access security policy](https://chromestatus.com/feature/5152728072060928) requirement.
43+
Requests from web pages to loopback addresses such as `localhost` / `127.0.0.1` are blocked unless the user (or an admin policy) explicitly grants access.
3944

40-
This affects the Dynamic Web TWAIN Service which relies on local services for communication.
45+
Because Dynamic Web TWAIN communicates with a local service, these restrictions can prevent normal operation.
4146

4247
### Resolution
4348

44-
***Step 1: (For All End Users)***
45-
46-
- Navigate to your Dynamic Web TWAIN web interface
47-
48-
- Click the lock icon (or settings icon) next to your site URL in the browser’s address bar.
49+
***1. To Manually Correct This in Chrome***
4950

51+
- Navigate to your Dynamic Web TWAIN page.
52+
- Click the lock/settings icon in the browser address bar.
5053
- Ensure that **Local Network Access** is enabled.
5154

5255
![local-network.png](/assets/imgs/local-network.png)
5356

5457
> [!NOTE]
5558
> If you're unable to restore functionality after enabling 'Local Network Access,' please contact [Dynamsoft](https://www.dynamsoft.com/contact/).
5659
57-
***Step 2: (For Developers Only)***
60+
***2. (For Admins) To Apply This Setting Across an Enterprise***
61+
62+
Enterprise administrators can deploy a Chrome and/or Edge policy to set the "Local Network Access" setting to "Allow" for your website.
5863

59-
**Option 1:**
64+
Please refer to:
65+
* [Chrome Enterprise Policy List & Management Documentation](https://chromeenterprise.google/policies/#LocalNetworkAccessAllowedForUrls)
66+
* [Microsoft Edge Browser Policy Documentation](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/localnetworkaccessallowedforurls)
6067

61-
You can check the permission programmatically:
68+
***3. Developer Notes***
69+
70+
**a) Check Permission Programmatically**
6271

6372
```javascript
6473
let status = await navigator.permissions.query({ name: "local-network-access" });
6574
console.log(status.state);
6675
```
6776

68-
If the permission is not granted, prompt users to manually enable it (Chrome settings → Privacy and security → Site settings → Local network access).
77+
If not granted, guide users to:
78+
79+
Chrome → Settings → Privacy and Security → Site Settings → Local network access
80+
81+
**b) If Running Inside an `iframe`**
6982

70-
> [!WARNING]
71-
> If Dynamic Web TWAIN is running in an iframe, ensure the iframe element includes the following attribute:
83+
> [!IMPORTANT]
84+
> If your site is embedded in an iframe, you MUST explicitly allow local-network access.
7285
86+
Please explicitly allow `local-network-access` in the attributes of the iframe:
7387
```html
7488
<iframe src="..." allow="local-network-access *"></iframe>
7589
```
7690

77-
**Option 2: (For Enterprise Users)**
78-
79-
Enterprise administrators can allow specified URLs to access local resources through Chrome’s Enterprise Policy configuration.
80-
Refer to: [Chrome Enterprise Policy List & Management | Documentation](https://chromeenterprise.google/policies/#LocalNetworkAccessAllowedForUrls)
81-
82-
### Planning
91+
### Roadmap
8392

8493
Dynamsoft plans to add a feature that automatically detects local service connectivity and permission status. If the connection is blocked, users will be prompted with a message and directed to this FAQ page.

_articles/faq/failed-to-load-resource.md

Lines changed: 35 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ keywords: Dynamic Web TWAIN, Error Message, Failed to load resource, CERT INVALI
77
breadcrumbText: Error Message - Failed to load resource
88
description: Error Message - Failed to load resource
99
date: 2021-12-01 17:04:03 +0800
10-
last_modified: 2025-10-11 15:23:24 +0800
10+
last_modified: 2025-11-05 15:23:24 +0800
1111
---
1212

1313
# Error Troubleshooting
@@ -22,7 +22,7 @@ You get an error message that says **"Failed to load resource: net::ERR_CERT_DAT
2222

2323
By default, "127.0.0.1" is used for service connection. "127.0.0.1" uses a self-signed SSL certificate without an expiry date. It is installed to your system so that the browser can trust it. If your environment requires high level security, self-signed certificates may not be accepted. Moreover, it is not easy to install the self-signed certificate for systems like Chrome OS.
2424

25-
In this case, we provide a domain, "local.dynamsoft.com", which points to "127.0.0.1". It has a VeriSign’ed certificate that has an expiry date. The most recent expired "local.dynamsoft.com" certificate expired on <font color=red>2024 November 19th</font>, and the latest certificate will expire on <font color=red>2025 November 20th</font>.
25+
In this case, we provide a domain, "local.dynamsoft.com", which points to "127.0.0.1". It has a VeriSign’ed certificate that has an expiry date. The most recent expired "local.dynamsoft.com" certificate expired on <font color=red>2025 November 20th</font>, and the latest certificate will expire on <font color=red>2026 November 21st</font>.
2626

2727
> ___Please note:___ _all official certificates issued by 3rd party come with an expiry date - generally one year. This means that each year the certificate will need to be updated if local.dynamsoft.com is used._
2828
@@ -39,11 +39,39 @@ In this case, we provide a domain, "local.dynamsoft.com", which points to "127.0
3939

4040
If you have to use "local.dynamsoft.com", the following methods can be taken:
4141

42-
- Method 1. Click <a href="https://tst.dynamsoft.com/public/download/dwt/newcert/local.dynamsoft.com/newcert.zip" target="_blank">here</a> to download the new certificate and use the new server.pem.ldsc & server_key.pem.ldsc to replace the old one in the `cert` folder under the service's [installation folder](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-folder). Then restart Dynamic Web TWAIN Service.
43-
44-
- Method 2. [Contact Dynamsoft](/_articles/about/getsupport.md){:target="_blank"} for a new service installer for client-side. Please specify the exact service version build number found from the version your client currently has installed.
45-
46-
- Method 3. You can also generate the certificate by yourself. Check out this [post](/_articles/faq/change-dynamsoft-service-certificate.md).
42+
- Method 1.Use the following links to download and install the new Dynamic Web TWAIN Service Installer.
43+
- For Windows
44+
> Choose between Admin (requires admin privileges) or Personal (for individual users).
45+
- Version 19.2
46+
- [Windows Installer (Admin)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.msi)
47+
- [Windows Installer (Personal)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.exe)
48+
- Version 18
49+
- [Windows Installer (Admin)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.msi)
50+
- [Windows Installer (Personal)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.exe)
51+
- For macOS
52+
> Use the installer matching your SDK version.
53+
- [macOS Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.pkg)
54+
- [macOS Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.pkg)
55+
- For Linux
56+
> Select the installer format based on your distribution type.
57+
- RPM Packages (Red Hat, Fedora, CentOS, etc.)
58+
- [Linux RPM Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.rpm)
59+
- [Linux RPM Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.rpm)
60+
- DEB Packages (Ubuntu, Debian, etc.)
61+
- [Linux DEB Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.deb)
62+
- [Linux DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.deb)
63+
- ARM64 Architecture
64+
- [Linux ARM64 DEB Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup-arm64.deb)
65+
- [Linux ARM64 DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup-arm64.deb)
66+
- MIPS Architecture
67+
- [Linux MIPS DEB Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup-mips64el.deb)
68+
- [Linux MIPS DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup-mips64el.deb)
69+
70+
- Method 2. Click <a href="https://demo.dynamsoft.com/DWT/Resources/dist/cert.zip" target="_blank">here</a> to download the new certificate and use the new server.pem.ldsc & server_key.pem.ldsc to replace the old one in the `cert` folder under the service's [installation folder](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-folder). Then restart Dynamic Web TWAIN Service.
71+
72+
- Method 3. [Contact Dynamsoft](/_articles/about/getsupport.md){:target="_blank"} for a new service installer for client-side. Please specify the exact service version build number found from the version your client currently has installed.
73+
74+
- Method 4. You can also generate the certificate by yourself. Check out this [post](/_articles/faq/change-dynamsoft-service-certificate.md).
4775

4876
<!--
4977

_articles/faq/http-insecure-websites-in-chromium-browser.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,22 @@
22
layout: default-layout
33
noTitleIndex: true
44
needAutoGenerateSidebar: true
5-
title: How to resolve Dynamic Web TWAIN SDK doesn't work on insecure public websites in Chrome v94+
5+
title: How to Resolve Dynamic Web TWAIN Issues on Insecure Websites in Chrome v94–v141
66
keywords: Dynamic Web TWAIN, Project Deployment and End-user Installation, Chrome 94 issue, HTTP website, Edge 94 issue
7-
breadcrumbText: How to resolve if Dynamic Web TWAIN doesn't work on insecure public websites in Chrome v94+
8-
description: How to resolve if Dynamic Web TWAIN doesn't work on insecure public websites in Chrome v94+
7+
breadcrumbText: How to Resolve Dynamic Web TWAIN Issues on Insecure Websites in Chrome v94–v141
8+
description: How to Resolve Dynamic Web TWAIN Issues on Insecure Websites in Chrome v94–v141
99
date: 2021-09-24 07:56:47 +0800
10-
last_modified: 2022-12-22 10:44:01 +0800
10+
last_modified: 2025-11-05 10:44:01 +0800
1111
---
1212

1313
View all FAQs about [Project Deployment and End-user Installation](
1414
https://www.dynamsoft.com/web-twain/docs/faq/#project-deployment-and-end-user-installation)
1515

16-
# Dynamic Web TWAIN doesn't work on insecure public websites in Chrome v94+
16+
# Dynamic Web TWAIN does not function on insecure (non-HTTPS) public websites in Chrome versions 94 to 141 due to browser security restrictions.
1717

1818
### Symptom
1919

20-
Visiting a public HTTP website with Dynamic Web TWAIN SDK integrated via Chrome v94+, you may get prompted to download and install the Dynamic Web TWAIN Service (also called "Dynamsoft Service") repeatedly.
21-
The same issue is also seen in Microsoft Edge 94.0.992.31 - as it uses the same Chromium version 94 as the latest Chrome browser.
20+
When visiting a public HTTP website that integrates the Dynamic Web TWAIN SDK using Chrome versions 94 through 141, you may be repeatedly prompted to download and install the Dynamic Web TWAIN Service (also known as the Dynamsoft Service). The same issue occurs in Microsoft Edge, as it is based on Chromium.
2221

2322
In the browser console, you may see the following **error message**
2423

_articles/faq/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -163,7 +163,7 @@ description: Dynamic Web TWAIN SDK Documentation FAQ
163163
14. [Can I use two different websites integrated with two different versions of Dynamic Web TWAIN on the same computer?](/_articles/faq/service-backward-compatibility.md)
164164
15. [How do I upgrade my project to use the latest version of the Dynamic Web TWAIN SDK?](/_articles/faq/upgrade-to-latest-version.md)
165165
16. [How do I upgrade the end-user installation for all end users once I upgrade my project?](/_articles/faq/upgrade-end-user-installations.md)
166-
17. [How to resolve if Dynamic Web TWAIN stops working on insecure websites in Chrome v94?](/_articles/faq/http-insecure-websites-in-chromium-browser.md)
166+
17. [How to Resolve Dynamic Web TWAIN Issues on Insecure Websites in Chrome v94–v141](/_articles/faq/http-insecure-websites-in-chromium-browser.md)
167167
18. [How to resolve Dynamic Web TWAIN issue in Chrome 101?](/_articles/faq/private-network-access-in-chrome101.md)
168168
19. [Dynamic Web TWAIN – Content-Security-Policy violated](/_articles/faq/content-security-policy-violated.md)
169169
20. [Scanner source is listed on XSane application but not on my web application on Linux machines](/_articles/faq/source-not-listed-on-linux.md)
@@ -206,7 +206,7 @@ description: Dynamic Web TWAIN SDK Documentation FAQ
206206
30. [How to debug on Dynamic Web TWAIN online demo?](/_articles/faq/debug-on-online-demo.md)
207207
31. [Dynamic Web TWAIN prompts the .deb installer for Windows](/_articles/faq/incorrect-installer-for-windowsARM64.md)
208208
32. [Why am I unable to load the TIFF file into Dynamic Web TWAIN?](/_articles/faq/unable-to-load-4-bit-tiff.md)
209-
33. [Error message - Permission was denied for this request to access the unknown address space](/_articles/faq/chromium-142-local-network-access-issue.md)
209+
33. [Error message - CORS Errors caused by local network access permissions when using Chromium 142 and later](/_articles/faq/chromium-142-local-network-access-issue.md)
210210

211211
## Licensing and Purchase
212212

assets/imgs/DWT_installer.png

5.23 KB
Loading

assets/imgs/local-network.png

-23.2 KB
Loading

0 commit comments

Comments
 (0)