How the scanner works in the browser
The QR reader in the browser uses the native code detector, and when it is missing, it loads a decoding library only when needed. It does not use resources from external CDN networks, because the plant firewall drops such traffic silently. The library therefore comes from the same server as the application.
For IT this means the tablet in the training room needs access to only one address: the installation server. There is no need to open exceptions for external domains, which simplifies the review of firewall rules.
Four error messages you need to know
The scanner shows four separate error messages. Without them the operator sees only a black image and does not know where to start. Each message points to a different action for the IT department or the tablet administrator.
No camera permission
The browser asked for camera access, and the user refused, or the device settings block the permission. Fix it in the site settings: allow the camera for the installation address and remember the choice.
No camera
The device has no camera, or the camera is not available to the browser. Check the tablet model, the lens cover, and whether the camera is occupied by another app.
Insecure context
Browsers provide the camera only on encrypted pages. Over plain HTTP access is blocked, so the scanner does not start. The fix is an address with a certificate trusted by the tablet, including on the internal network.
Unsupported browser
The browser does not support the required features, for example it is very old or runs in a restricted mode. Update the browser or switch to one supported in the plant.
Example order of scanner diagnosis (number of minutes, example calculation)
Network: what to check in the firewall
In an on-premise plant the tablet usually connects to the server on the internal network. Check three things: whether the tablet has a route to the server from the training room, whether the firewall blocks the HTTPS port, and whether the server name is resolved by DNS for this network.
For problems with loading the decoding library, look at the browser console: the error usually concerns a block on loading a file from the same server, for example by content filter rules.
- a route from the tablet to the installation server,
- an open HTTPS port,
- the server name in the DNS of the training network,
- no content filter blocking script files.
Scan security: a scan logs nothing in
A QR scan on the tablet logs nothing in: the tablet shows the first name, last name and company of the code owner, and training starts after confirmation "Is this you?". The system's response never returns the scanned code or token, so a photo of the tablet screen does not reveal the code.
For IT this means the tablet stores no secrets and does not require administrator login. When the tablet is left unsupervised, the kiosk uses a link with a rotated access token.
Procedure for accepting the tablet before training
Before the first training, run a short acceptance test: scan a test badge, check the identity confirmation, start the material and the test. Repeat on a second tablet if the room has more than one. Record the results, so that when a fault is reported you know what worked on the day of acceptance.
Video
Frequently asked questions
Why does the scanner show a black screen over plain HTTP?
Browsers provide the camera only in a secure context. Over HTTP the scanner shows a message about an insecure context, and the fix is an address with a trusted certificate.
Do we need to open the firewall to external domains?
No. The scanner uses no external CDN, and it loads the decoding library from the installation server.
What if the browser has a native code detector?
Then it uses it without additional files. The decoding library is loaded only when the detector is missing.
Setting up a training tablet on the plant network?
We will give the IT department a list of network requirements and an acceptance test for the QR scanner. Book a meeting.
Let's talk