DeviceHub Networking Requirements and Technical Specifications for PitneyShip Pro

DeviceHub is a program that connects your printers and scales to PitneyShip Pro. The following are required in order for DeviceHub to work properly on your network.

• Technical Specifications
• Operating System Requirements
• Whitelist
• Technical Architecture

Technical Specifications

Ports

The following ports are used for the communication with AWS IoT and AWS API Gateway:

External ports:

• 8883 - MQTT
• 443 - HTTPS / MQTT

Internal ports:

• 443 - Websocket
• 8091 - HTTP for activation
• 10001, 10002, 10003 (whichever is open) - Secure Websocket

Inputs

• AWS IoT messages with small JSON payloads
• Jobs
  • Print - GIF file for INDICIA and PDF file for sheet
  • Scale

Outputs

• Events
  • Heartbeats with Health checks
  • Notifications: if the upgrade is available.
  • USB and Job (print) details
• Scale Data
• Scanned address (ASCII format) using Optical Character Recognition (OCR) scanner

Storage

• x.509 certificates or root certificate authority (CA) - device certificates (.crt, .pem, and root CA)
• Configurations: number of devices, registered devices, scale, and last shadow state
• Logs for diagnosis & troubleshooting
• HTML pages for Out of Box (OOB) process
• No PII info is stored within DeviceHub
• No local database

Communications

Localhost or 127.0.0.1 is used for device activation.

DeviceHub supports IPV4 only.

Operating System Requirements

Windows

• DeviceHub is verified on 64-bit versions of Windows 10 and Window 11.
• The latest version updates must be installed.
• DeviceHub must be installed on the C drive.

Mac

DeviceHub is verified on the following Mac OS versions:

• MacOS v.13.2.1 Ventura
• MacOS Sonoma v14
• DeviceHub only supports Macs with Apple processors, not Intel processors.

Whitelist

The following address must be whitelisted.DeviceHub does not support SSL packet inspection, and all domains should bypass that inspection.

• a2dflzkdcuxckx-ats.iot.us-east-1.amazonaws.com
• a2dflzkdcuxckx-ats.iot.us-west-2.amazonaws.com
• *.sendpro360.pitneycloud.com
• devicehub.pitneybowes.com (MQTT connections)
• Used to determine if internet connectivity is available or if proxy server may be needed:
  • devicehub.pitneybowes.com (443)
  • www.pitneybowes.com
• devicehubsetuppackages.s3.amazonaws.com
• *.s3.amazonaws.com (for downloading documents to print)

Technical Architecture

• A print request from PitneyShip Pro is sent to DeviceHub for shipping labels, stamp rolls, stamp sheets, and barcodes.
• The print request is submitted to AWS API Gateway/Lambda.
• The request is verified using a unique device signature from Mongo DB.
• AWS API Gateway submits the print job to DeviceHub Agent through AWS IoT core via a secure channel with x.509.
• DeviceHub Agent prints the INDICIA (gif) & Sheet (PDF) using the job information and passes the print confirmation to AWS IoT core.

Related topics

• Networking Requirements for PitneyShip Pro