Skip to content

Commit 5158ef5

Browse files
update to internal commit 9508987d
1 parent 093a27a commit 5158ef5

File tree

7 files changed

+72
-54
lines changed

7 files changed

+72
-54
lines changed

.github/workflows/main.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ on:
88
push:
99
branches:
1010
- master
11-
- preview
11+
# - preview
1212

1313
# Allows you to run this workflow manually from the Actions tab
1414
workflow_dispatch:

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

Lines changed: 28 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -7,87 +7,78 @@ 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-05 17:26:42 +0800
10+
last_modified: 2025-11-04 17:21: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 - CORS Errors caused by local network access permissions when using Chromium 142 and later
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.
1919

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

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.
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:
2323

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

26-
You may experience one or more of the following:
27-
28-
***1. Service installer repeatedly prompted***
29-
30-
The browser prompts you to download/install the service even though it is already installed.
3126
![DWT_installer.png](/assets/imgs/DWT_installer.png)
3227

33-
***2. Initialization succeeds, but scan/load shows blank images***
28+
- Phenomenon 2: the initialization succeeds, but scanning or loading images results in blank images.
29+
30+
Open the browser console (press F12, then go to the Console tab), you should see the following error message:
3431

35-
The browser console (F12 → Console) shows a CORS rejection similar to:
3632
```shell
3733
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.
3834
```
3935

40-
### Root Cause
36+
### Cause
4137

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.
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.
4439

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

4742
### Resolution
4843

49-
***1. To Manually Correct This in Chrome***
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.
5049

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

5552
![local-network.png](/assets/imgs/local-network.png)
5653

5754
> [!NOTE]
5855
> If you're unable to restore functionality after enabling 'Local Network Access,' please contact [Dynamsoft](https://www.dynamsoft.com/contact/).
5956
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.
57+
***Step 2: (For Developers Only)***
6358

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)
59+
**Option 1:**
6760

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

7263
```javascript
7364
let status = await navigator.permissions.query({ name: "local-network-access" });
7465
console.log(status.state);
7566
```
7667

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`**
68+
If the permission is not granted, prompt users to manually enable it (Chrome settings → Privacy and security → Site settings → Local network access).
8269

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

91-
### Roadmap
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
9283

9384
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 - CORS Errors caused by local network access permissions when using Chromium 142 and later](/_articles/faq/chromium-142-local-network-access-issue.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)
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)