Here is an overview of the system requirements for Consignor including ports, webservices and IP addresses used.
- Consignor system requirements
- Label size
- Network requirements and ports
- Secure data transfer
- SPF record
- Folder security
- Printer requirements
- Portal DNS Servers to be whitelisted
- Consignor and webservices
Consignor system requirements
|Platform||Windows Edition||Minimum hardware||Software requirements|
Windows 8 - 10
Windows Server 2012 R2
Windows Server 2016
PC versions (enterprise / pro):
Windows 8 - 10
It is possible to install Consignor on a shared server but we recommend using a dedicated server for Consignor. This will ensure a more stable performance. We also do not recommend installing Consignor on a domain controller.
Labels in Consignor are optimized for themal labels sized 100x192 mm. Larger sized labels will also do but please note that if you are using smaller sized labels, only the labels from selected carriers will be printed correctly.
Network requirements and ports
Ports in use by Consignor externally:
TCP 80/443 (HTTP/HTTPS - Consignor uses a handful of webservices, read more in this section: Consignor and webservices.
TCP 21 (FTP/FTPS - Consignor may be configured to use FTP/FTPS, if you are uncertain about your configuration please contact your local Customer Service department)
TCP 9999 (SFTP - Consignor may be configured to use SFTP, if you are uncertain about your configuration please contact your local Customer Service department-)
TCP 25 (SMTP - Consignor may be configured to use SMTP (Mail), if you are uncertain about your configuration please contact your local Customer Service department.)
Local ports in use by Consignor:
52346 (In use by client to connect to Consignor server).
52345 (In use by clients when fetching updates from Consignor server).
52347 (In use by Consignor server for a local process "import.exe" running an integration module).
52348 (In use by Consignor server for a local process "JobExecutor.exe" running multiple tasks).
Note: These local ports can be configured, contact your local Customer Service department if this is needed.
Note that Consignor is a software that uses MS SQL Server for its database, the database communication is done by both CONSIGNOR server and CONSIGNOR client. See Microsoft's site for details on network requirements: https://support.microsoft.com/en-us/kb/287932.
Secure data transfer
We have secure data transfer (HTTPS) between all Consignor internal web services.
Exceptions are 3rd party web services, which does not support secure connections, i.e. transmit of data to carriers (EDI).
All web services called from Consignor On-premises can use HTTPS if the option is activated in Consignor On-premises settings. FTP depends on configuration. We support FTP, FTPS and SFTP.
SMTP depends on configuration (e.g. mailback).
Consignor Ticket/Shipment Server API
The communication protocol is HTTPS (port 443).
Data upload to Consignor Portal
The communication protocol is HTTP (port 80).
HTTPS is not yet supported on this (work in progress).
Drop Zone always uses port 80 and 443 or 8089. It is a configuration choice to use either port 443 with SSL/TLS protocol, or port 8089 without. Port 8089 may be configured to another number.
Consignor Portal API (data web services)
Available both with HTTP (port 80) and HTTPS (port 443).
Some customers are using Consignor’s SMTP server along with their own email server on their own domain. It may be necessary to add an SPF record to your domain, to avoid emails sent through Consignor’s SMTP server being classified as spam.
An SPF record is a txt record added to your domain’s DNS and is specific for each domain.
Example of a SPF record including Consignor’s IP addresses and SMTP server :
v=spf1 a mx ip4:22.214.171.124 ip4:126.96.36.199 mx:edi-soft.no include:spf.protection.outlook.com ~all
Our domain names: mail.edisoft.no and smtpspare.edi-soft.com
Read more about SPF here.
Folder security on Consignor On-premises server:
When installing Consignor server, it is required that the user executing the installation package is a local administrator. Following that it is expected that the user (or 'Local System account' running our local service "Consignorserver" have local administrator rights. If the Consignorserver service is not run with local administrator rights not all functionalities will run properly.
Folder security on Consignor On-premises client:
The user logged on to Windows needs to have access to read the local folder where Consignor On-premises client is installed (by default: C:\Program Files (x86)\Consignor client\
Every user that opens up Consignor client will try to create a folder with configuration files under C:\Users\<username>\appdata\roaming\Consignor\Consignor - to be able to create and maintain these configuration files the Windows user account should have proper access here.
NOTE: After an update on Consignor server, Consignor will run the proces UpdateClient.exe (found in the Consignor client installation folder). The user that opens up the client needs to have read and write access to the Consignor client installation folder.
Folder security for Consignor file drop integration:
When using file drop integration it is required that the service Consignorserver have access to read and write to the configured folders.
Printer requirements on Consignor client:
The user logged on to Windows needs to have the "Print" permission to the printer driver - Consignor by default tries to check printer status which requires the security permission "Manage this printer". This status check can be turned off if needed.
Printer requirements on Consignor server:
Regular printing requirements on server. This method have the same printer requirements as CONSIGNOR client have.
Automated printing requirements on server:
The automated printing (auto print etc) are executed by the local service 'Consignorserver', and this service needs the proper rights. Read more here: Printer setup in Consignor On-premises.
Portal DNS Servers to be whitelisted
Some customers need to whitelist DNS/IPs in their firewall or FTP. Here's an overview of the IP addresses used:
Portal Gateway (ReturnData & ExportData)
Consignor webservices and URLs
Consignor uses several webservices, we recommend that the webservices mentioned underneath are whitelisted in firewalls etc.
Our servers runs mainly on these sites for webservices outgoing on port 80/ 443:
Our webservices support TLS 1.2
Adress lookups, drop point validation etc:
Automatic refill of shipment numbers:
Resource Center for AutoUpdates
Upload of shipments to Consignor Portal:
Some carriers might also have specific webservices to function properly.
You might also see all our webservices and their functions in the configuration file located at: C:\Consignor\Consignor\LiveUpdate\Config\FactorySettings\WebServerConfiguration.xml
Our webservices might run from both client and server.
See also how to setup Proxy settings here.
How to check connectivity towards our webservices:
- Open an internet browser
- Copy one of the URLs into the adress bar and hit enter.
- If one of the screenshots below are shown the webservice should be open.
NB: Even if you can access the webservice through your browser but not Consignor it could be proxy settings in the browser.