Skip to main content

Enabling Local Access Permissions for Apteryx Online Capture

Michael Satterfield
Updated

Overview

Starting with Apteryx release (v5.12.0), Google Chrome and Microsoft Edge now require users to grant “Local Network Access” permissions for Apteryx Online Capture to function properly. This change applies to Chrome version 142 and above and Edge version 143 and above, and is essential for initiating image capture workflows within Apteryx.

Why This Change?

Google Chrome and Microsoft Edge have both introduced stricter security measures to protect local resources. Apteryx Online Capture relies on local network communication between your browser and the capture service (Ambassador) installed on your workstation. Without this permission, Apteryx Online Capture cannot start or connect to imaging devices.

What Users Will See

When launching Apteryx Online Capture in Edge or Chrome:

  • A permission prompt will appear asking to allow access to local network resources. Click Proceed to allow the browser to display the Local Network Access prompt.

    Click Allow to allow Apteryx Online Capture access to your local area network.

  • If Allowed, Apteryx Online Capture will start normally.

  • If Blocked, users will see an error message dependent on the browser in use, and capture will not proceed.

    • Microsoft Edge:

    • Google Chrome:

46605144997147466051069737234353771153346743537740010779

Steps to Enable Local Access

Google Chrome:

  1. Open Google Chrome and navigate to your Apteryx site.

  2. When prompted, click Allow for “Local Network Access.”

  3. If Apteryx Online Capture Connection failed, or you previously blocked this permission:

    • Click View Site Information (icon to the left of the address bar) 

    • Click Site Settings

    • Scroll down to the bottom of the Sites Settings page, and set both "Local Network" and "Apps on device" to Allow

      If you do not see the above permissions, set "Sites can ask to connect to any device on your local network" to Allow instead

  4. Refresh the Apteryx page and relaunch Apteryx Online Capture.

46857343999899468573439983634685734399490746857336708763

Microsoft Edge:

  1. Open Microsoft Edge and navigate to your Apteryx site.

  2. When prompted, click Allow for “Local Network Access.”

  3. If Apteryx Online Capture Connection failed, or you previously blocked this permission:

    • Click View Site Information (icon to the left of the address bar) 

    • Click Permissions for this site

    • Scroll down to the bottom of the Sites Settings page, and set both "Local Network" and "Apps on device" to Allow

    • If you do not see the above permissions, set "Sites can ask to connect to any device on your local network" to Allow instead

  4. Refresh the Apteryx page and relaunch Apteryx Online Capture.

46857343999899468573439983634685733672489146857336722203

Troubleshooting

  • If the permission prompt does not appear, ensure your browser is up to date.

  • Verify that your Apteryx Online Capture installation is up to date.

  • If issues persist, check for blocked ports or firewall rules that may prevent local communication. 

Additional Notes

  • For enterprise environments, the client’s IT can consider updating Chrome/Edge policies to pre-allow local network access for Apteryx sites.