Using whitelisting to control which devices can connect

Article ID: 21984655

Issue / Question

How to use the whitelisting feature of Link-OS starting  with v5.0

Issue Details

whitelist, whitelisting,  Link-OS v5, networking,  firewall, network

Applicable To

Link-OS v5

Resolution / Answer

Starting with Link-OS v5, Zebra printers allow for the whitelisting of devices allowed to connect. 


The whitelisting capability is to ensure that only authorized hosts can connect to the printer. The parameters that you set are the IP addresses that are permitted toconnect and can be single IP address or ranges. 

The whitelist capability is controlled by the ip.firewall.whitelist_in command

Examples of usage: 
! U1 setvar "ip.firewall.whitelist_in" "192.168.1.20"
! U1 setvar "ip.firewall.whitelist_in" "192.168.1.20, 192.168.100.21"
! U1 setvar "ip.firewall.whitelist_in" "192.168.1.20-192.168.1.100"

To confirm the command is set:   ! U1 getvar "ip.firewall.whitelist_in"
The printer should respond with the current setting value, or “?” if not supported

To Default the command:    ! U1 setvar "ip.firewall.whitelist_in" ""

Note:  This command allows up to 256 characters that define what IP’s or ranges of IP’s can connect to the printer. If the IP address is not listed the connection will be refused. To reset this list, you will need to connect to a local port and send this command if the IP you are trying to connect with is not in the allowed range.

Examples: Single IP address:    ! U1 setvar "ip.firewall.whitelist_in" "192.168.1.20"

Multiple IP addresses:    ! U1 setvar "ip.firewall.whitelist_in" "192.168.1.20, 192.168.1.21"

IP address ranges:     ! U1 setvar "ip.firewall.whitelist_in" "192.168.1.20-192.168.1.40"

IP ranges and Single/Multiple IPs ! U1 setvar "ip.firewall.whitelist_in" "192.168.1.20-192.168.1.40, 192.168.1.50, 192.168.1.75" 

ZPL Manual Read More>>

+ Applicable Products

  • QLn Series Healthcare Mobile Printers
  • QLn Series Mobile Printers
  • QLn220 Healthcare
  • QLn220 Mobile Printer
  • QLn320 Healthcare
  • QLn320 Mobile Printer
  • QLn420 Mobile Printer
  • ZE500 Print Engines
  • ZE500 Print Engines
  • ZQ500 Series Mobile Printers
  • ZQ510 Mobile Printer
  • ZQ520 Mobile Printer
  • ZT200 Series Industrial Printers
  • ZT210 Industrial Printer
  • ZT220 Industrial Printer
  • ZT230 Industrial Printer
  • ZT400 Series Industrial Printers
  • ZT410 Industrial Printer
  • ZT420 Industrial Printer
  • ZT500 Industrial Printers
  • ZT510 Industrial Printer
  • ZT600 Series Industrial Printers
  • ZT610 Industrial Printer
  • ZT620 Industrial Printer