Installing the QZ Tray Root CA Certificate on a SmartScan Device
1.7 min read
|To print labels from a SmartScan device by using QZ Tray, you must install the QZ Tray root CA certificate on the SmartScan device. Installing the certificate allows SmartScan to trust the QZ Tray print server and communicate with it securely.
Before you begin
Make sure that:
- QZ Tray is installed and running on the machine to be used as a print server. If you don’t have it installed yet, download QZ Tray from their website and follow their installation instructions.
- The printer is configured on the computer to be used as a print server. If you are using Zebra printer, see our article on Configuring Zebra Printer.
- The SmartScan device can reach the QZ Tray server on the same network.
- You know the IP address and port of the QZ Tray server (QZ Tray defaults to 8181 and 8182).
Step 1: Open the QZ Tray server page
- On the SmartScan device, open the web browser.
- In the address bar, enter the QZ Tray server URL using the server’s IP address and port.
Example: https://10.0.0.8:8181
- Use the IP address and port of your QZ Tray host.
- Wait for the QZ Tray page to load.
Step 2: Download the certificates
The Android OS running on your scanner device may require the implementation of security protocols, such as a security PIN, before certificates can be installed or managed. Refer to the documentation for your specific Android version for more information.
- Scroll to the Certificates section on the QZ Tray server page
- Locate the following certificates:
- root-ca (root certificate)
- qz-tray (server certificate)
- Click Download certificate for each.
Step 3: Install the root CA and QZ tray certificate on your SmartScan device.
- On the SmartScan device, go to: Settings > Security > Encryption and Credentials.
- Select Install a certificate.
Root Certificate
- Select CA certificate.
- Browse to and select the downloaded root-ca certificate file.
- Accept any prompts to complete the installation.
QZ Tray Certificate
- Repeat the installation process for the qz-tray certificate.
- Accept any prompts to complete the installation.
Step 4: Print a test label from a SmartScan.
First time connection to QZ Tray
The first time a SmartScan device connects to the QZ Tray print server and searches for printers, a security prompt appears on the QZ Tray host computer. The prompt asks whether to allow connections from Extensiv.
- For silent printing to work correctly, select Allow, enable “Remember this decision”, and then click Accept. This only needs to be completed once per QZ Tray certificate.
- If this prompt is blocked or dismissed, printing from the SmartScan device may fail.
- Click the hamburger menu in the upper-right corner, and then select Settings.
-
Select Print.
- Click Print a Test Label.
The Printer drop-down menu in SmartScan displays all printers available, not just ZPL printers. Only a ZPL printer should be selected or printing will not work.
- Confirm that the label prints successfully through QZ Tray.