Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .github/workflows/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ on:
push:
branches:
- master
# - preview
- preview

# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:
Expand Down
65 changes: 37 additions & 28 deletions _articles/faq/chromium-142-local-network-access-issue.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,78 +7,87 @@ keywords: Dynamic Web TWAIN, Error Troubleshooting, CORS, unknown address space,
breadcrumbText: Error message - Permission was denied for this request to access the unknown address space
description: CORS unknown address space
date: 2025-11-04 17:21:42 +0800
last_modified: 2025-11-04 17:21:42 +0800
last_modified: 2025-11-05 17:26:42 +0800
---

# Error Troubleshooting

> [!IMPORTANT]
> This is a newly developing issue, and as such the information in this article may change over time.

## 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.
## Error message - CORS Errors caused by local network access permissions when using Chromium 142 and later

### Symptom
### Overview

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

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

![DWT_installer.png](/assets/imgs/DWT_installer.png)
You may experience one or more of the following:

***1. Service installer repeatedly prompted***

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

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

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

### Cause
### Root Cause

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.
Chromium 142 introduces a new [Local Network Access security policy](https://chromestatus.com/feature/5152728072060928) requirement.
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.

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

### Resolution

***Step 1: (For All End Users)***

- Navigate to your Dynamic Web TWAIN web interface

- Click the lock icon (or settings icon) next to your site URL in the browser’s address bar.
***1. To Manually Correct This in Chrome***

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

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

> [!NOTE]
> If you're unable to restore functionality after enabling 'Local Network Access,' please contact [Dynamsoft](https://www.dynamsoft.com/contact/).

***Step 2: (For Developers Only)***
***2. (For Admins) To Apply This Setting Across an Enterprise***

Enterprise administrators can deploy a Chrome and/or Edge policy to set the "Local Network Access" setting to "Allow" for your website.

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

You can check the permission programmatically:
***3. Developer Notes***

**a) Check Permission Programmatically**

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

If the permission is not granted, prompt users to manually enable it (Chrome settings → Privacy and security → Site settings → Local network access).
If not granted, guide users to:

Chrome → Settings → Privacy and Security → Site Settings → Local network access

**b) If Running Inside an `iframe`**

> [!WARNING]
> If Dynamic Web TWAIN is running in an iframe, ensure the iframe element includes the following attribute:
> [!IMPORTANT]
> If your site is embedded in an iframe, you MUST explicitly allow local-network access.

Please explicitly allow `local-network-access` in the attributes of the iframe:
```html
<iframe src="..." allow="local-network-access *"></iframe>
```

**Option 2: (For Enterprise Users)**

Enterprise administrators can allow specified URLs to access local resources through Chrome’s Enterprise Policy configuration.
Refer to: [Chrome Enterprise Policy List & Management | Documentation](https://chromeenterprise.google/policies/#LocalNetworkAccessAllowedForUrls)

### Planning
### Roadmap

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.
42 changes: 35 additions & 7 deletions _articles/faq/failed-to-load-resource.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ keywords: Dynamic Web TWAIN, Error Message, Failed to load resource, CERT INVALI
breadcrumbText: Error Message - Failed to load resource
description: Error Message - Failed to load resource
date: 2021-12-01 17:04:03 +0800
last_modified: 2025-10-11 15:23:24 +0800
last_modified: 2025-11-05 15:23:24 +0800
---

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

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.

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

> ___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._

Expand All @@ -39,11 +39,39 @@ In this case, we provide a domain, "local.dynamsoft.com", which points to "127.0

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

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

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

- Method 3. You can also generate the certificate by yourself. Check out this [post](/_articles/faq/change-dynamsoft-service-certificate.md).
- Method 1.Use the following links to download and install the new Dynamic Web TWAIN Service Installer.
- For Windows
> Choose between Admin (requires admin privileges) or Personal (for individual users).
- Version 19.2
- [Windows Installer (Admin)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.msi)
- [Windows Installer (Personal)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.exe)
- Version 18
- [Windows Installer (Admin)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.msi)
- [Windows Installer (Personal)](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.exe)
- For macOS
> Use the installer matching your SDK version.
- [macOS Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.pkg)
- [macOS Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.pkg)
- For Linux
> Select the installer format based on your distribution type.
- RPM Packages (Red Hat, Fedora, CentOS, etc.)
- [Linux RPM Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.rpm)
- [Linux RPM Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.rpm)
- DEB Packages (Ubuntu, Debian, etc.)
- [Linux DEB Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup.deb)
- [Linux DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup.deb)
- ARM64 Architecture
- [Linux ARM64 DEB Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup-arm64.deb)
- [Linux ARM64 DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup-arm64.deb)
- MIPS Architecture
- [Linux MIPS DEB Installer v19.2](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/19.2/DynamicWebTWAINServiceSetup-mips64el.deb)
- [Linux MIPS DEB Installer v18](https://download2.dynamsoft.com/Demo/DWT/Resources/dist/18.5.2/DynamsoftServiceSetup-mips64el.deb)

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

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

- Method 4. You can also generate the certificate by yourself. Check out this [post](/_articles/faq/change-dynamsoft-service-certificate.md).

<!--

Expand Down
13 changes: 6 additions & 7 deletions _articles/faq/http-insecure-websites-in-chromium-browser.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,23 +2,22 @@
layout: default-layout
noTitleIndex: true
needAutoGenerateSidebar: true
title: How to resolve Dynamic Web TWAIN SDK doesn't work on insecure public websites in Chrome v94+
title: How to Resolve Dynamic Web TWAIN Issues on Insecure Websites in Chrome v94–v141
keywords: Dynamic Web TWAIN, Project Deployment and End-user Installation, Chrome 94 issue, HTTP website, Edge 94 issue
breadcrumbText: How to resolve if Dynamic Web TWAIN doesn't work on insecure public websites in Chrome v94+
description: How to resolve if Dynamic Web TWAIN doesn't work on insecure public websites in Chrome v94+
breadcrumbText: How to Resolve Dynamic Web TWAIN Issues on Insecure Websites in Chrome v94–v141
description: How to Resolve Dynamic Web TWAIN Issues on Insecure Websites in Chrome v94–v141
date: 2021-09-24 07:56:47 +0800
last_modified: 2022-12-22 10:44:01 +0800
last_modified: 2025-11-05 10:44:01 +0800
---

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

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

### Symptom

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

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

Expand Down
4 changes: 2 additions & 2 deletions _articles/faq/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,7 @@ description: Dynamic Web TWAIN SDK Documentation FAQ
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)
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)
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)
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)
17. [How to Resolve Dynamic Web TWAIN Issues on Insecure Websites in Chrome v94–v141](/_articles/faq/http-insecure-websites-in-chromium-browser.md)
18. [How to resolve Dynamic Web TWAIN issue in Chrome 101?](/_articles/faq/private-network-access-in-chrome101.md)
19. [Dynamic Web TWAIN – Content-Security-Policy violated](/_articles/faq/content-security-policy-violated.md)
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)
Expand Down Expand Up @@ -206,7 +206,7 @@ description: Dynamic Web TWAIN SDK Documentation FAQ
30. [How to debug on Dynamic Web TWAIN online demo?](/_articles/faq/debug-on-online-demo.md)
31. [Dynamic Web TWAIN prompts the .deb installer for Windows](/_articles/faq/incorrect-installer-for-windowsARM64.md)
32. [Why am I unable to load the TIFF file into Dynamic Web TWAIN?](/_articles/faq/unable-to-load-4-bit-tiff.md)
33. [Error message - Permission was denied for this request to access the unknown address space](/_articles/faq/chromium-142-local-network-access-issue.md)
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)

## Licensing and Purchase

Expand Down
Binary file modified assets/imgs/DWT_installer.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/imgs/local-network.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.