diff --git a/_articles/faq/chromium-142-local-network-access-issue.md b/_articles/faq/chromium-142-local-network-access-issue.md index 12230daa..97c832a0 100644 --- a/_articles/faq/chromium-142-local-network-access-issue.md +++ b/_articles/faq/chromium-142-local-network-access-issue.md @@ -3,7 +3,7 @@ layout: default-layout noTitleIndex: true needAutoGenerateSidebar: true title: Error message - Permission was denied for this request to access the unknown address space -keywords: Dynamic Web TWAIN, Error Troubleshooting, CORS, unknown address space, chrome, 142 +keywords: Dynamic Web TWAIN, Error Troubleshooting, CORS, unknown address space, Chromium, 142 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 @@ -19,9 +19,15 @@ last_modified: 2025-11-04 17:21:42 +0800 ### Symptom -When using browsers based on Chromium version 142 (released on October 28th, 2025) or later (including but not limited to Edge, Brave, and Opera), the Dynamsoft Web TWAIN Service installation cannot be detected, prompting the Dynamsoft Web TWAIN Service installation modal. Installing the service does not fix the issue. +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: -You may also encounter the following error message in the browser console: +- Phenomenon 1: the browser prompts users to download the service installer even though it is already installed. + +![DWT_installer.png](/assets/imgs/DWT_installer.png) + +- Phenomenon 2: the initialization succeeds, but scanning or loading images results in blank images. + +Open the browser console (press F12, then go to the Console tab), you should see the following error message: ```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. @@ -29,28 +35,26 @@ Access to fetch at 'https://127.0.0.1:18623/fa/VersionInfo?ts=1761893667670' fro ### Cause -In Chromium 142 Google introduced a new Local Network Access security policy. Requests from web pages hosted within iframes to local addresses such as 127.0.0.1 or localhost get blocked unless explicit permission is granted. +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. This affects the Dynamic Web TWAIN Service which relies on local services for communication. -### Solution +### Resolution -
+***Step 1: (For All End Users)*** -- [Quick Solution for End Users](#Quick Solutions for End Users) -- [Solutions for Developers](#Solutions for Developers) +- 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. -**Enable Local Network Access** - -Make sure your website has Local Network Access enabled. +- 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)*** **Option 1:** @@ -73,11 +77,7 @@ If the permission is not granted, prompt users to manually enable it (Chrome set **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/) - -
- -
+Refer to: [Chrome Enterprise Policy List & Management | Documentation](https://chromeenterprise.google/policies/#LocalNetworkAccessAllowedForUrls) ### Planning diff --git a/_articles/faq/index.md b/_articles/faq/index.md index 14dd1592..2bd3bb36 100644 --- a/_articles/faq/index.md +++ b/_articles/faq/index.md @@ -206,8 +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/chrome-142-local-network-access-issue.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) ## Licensing and Purchase diff --git a/_articles/faq/service-prompting-to-install-repeatedly.md b/_articles/faq/service-prompting-to-install-repeatedly.md index cadd03cd..845be77f 100644 --- a/_articles/faq/service-prompting-to-install-repeatedly.md +++ b/_articles/faq/service-prompting-to-install-repeatedly.md @@ -20,7 +20,7 @@ https://www.dynamsoft.com/web-twain/docs/faq/#project-deployment-and-end-user-in > [!NOTE] > "Local network access permission is not granted" is a **newly developing issue** -1. The local network access permission is not granted (required starting Chromium 142). See [Chromium local network access issue](/_articles/faq/chromium-142-local-network-access-issue) for details and corrective action. +1. The local network access permission is not granted (required starting Chromium 142). 2. The Dynamic Web TWAIN Service (previously called "Dynamsoft Service") is not installed properly. @@ -40,22 +40,23 @@ https://www.dynamsoft.com/web-twain/docs/faq/#project-deployment-and-end-user-in #### The respective fixes are listed below -1. Check the service's [installation folder](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-folder) and make sure you have [the correct files](/_articles/extended-usage/dynamsoft-service-configuration.md#related-files-and-folders){:target="_blank"}. +1. See [Chromium local network access issue](/_articles/faq/chromium-142-local-network-access-issue.md) for details and corrective actions. -2. Check `Local Services` and make sure the Dynamic Web TWAIN Service is listed and Running. +2. Check the service's [installation folder](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-folder) and make sure you have [the correct files](/_articles/extended-usage/dynamsoft-service-configuration.md#related-files-and-folders){:target="_blank"}. -3. On IE, go to `Internet Options` --> `Security` tab, select `Local Intranet`, then click `Sites`, uncheck 'Include all sites that bypass the proxy server' +3. Check `Local Services` and make sure the Dynamic Web TWAIN Service is listed and Running. + +4. On IE, go to `Internet Options` --> `Security` tab, select `Local Intranet`, then click `Sites`, uncheck 'Include all sites that bypass the proxy server' ![why-is-the-browser-prompting-me-to-install-dynamsoft-service-repeatedly-1](/assets/imgs/why-is-the-browser-prompting-me-to-install-dynamsoft-service-repeatedly-1.png) ![why-is-the-browser-prompting-me-to-install-dynamsoft-service-repeatedly-2](/assets/imgs/why-is-the-browser-prompting-me-to-install-dynamsoft-service-repeatedly-2.png) -4. Check your anti-virus software or any other software that can block local ports and make sure the ports 18622, 18623, 18625 and 18626 are not blocked. +5. Check your anti-virus software or any other software that can block local ports and make sure the ports 18622, 18623, 18625 and 18626 are not blocked. -5. Disable all the extensions or plugins in the browser, refresh and try again. +6. Disable all the extensions or plugins in the browser, refresh and try again. -6. On your Linux client machine, visit https://127.0.0.1:18626 and https://127.0.0.1:18623 separately in Chrome and FireFox, manually add both certificates to the exception lists. +7. On your Linux client machine, visit https://127.0.0.1:18626 and https://127.0.0.1:18623 separately in Chrome and FireFox, manually add both certificates to the exception lists. -7. See the solution [here](/_articles/faq/http-insecure-websites-in-chromium-browser.md){:target="_blank"} +8. See the solution [here](/_articles/faq/http-insecure-websites-in-chromium-browser.md){:target="_blank"} -8. Set [`IfCheckCORS`](/_articles/info/api/Dynamsoft_WebTwainEnv.md#ifcheckcors) to `true` in `dynamsoft.webtwain.config.js` file. +9. Set [`IfCheckCORS`](/_articles/info/api/Dynamsoft_WebTwainEnv.md#ifcheckcors) to `true` in `dynamsoft.webtwain.config.js` file. -9. Ask the user to grant the local network access permission manually. See this [webpage](https://chromestatus.com/feature/5152728072060928) for details. diff --git a/assets/imgs/DWT_installer.png b/assets/imgs/DWT_installer.png new file mode 100644 index 00000000..7a16f2b2 Binary files /dev/null and b/assets/imgs/DWT_installer.png differ