Appendix APorts
Every port the program opens or connects to, its default, and how it is chosen. The program reserves no fixed port: each is taken at installation or when it is opened, the first free port after the default if the default is taken, and recorded where it landed.
A.1 Ports listening on the server
| What listens | Protocol | Default | How it is chosen | Who reaches it |
|---|---|---|---|---|
| The program (its screens and requests) | TCP | 8000 | The first free port from 8000, within 200 ports | The server alone, until it is opened to the network's devices; then over an encrypted connection (HTTPS) |
| The PostgreSQL database | TCP | 5439 | The first free port from 5439 | The server alone (127.0.0.1), always |
| The member computers' port | TCP | The program's port + 1 | The first free port after the program's, within 50 ports | Member computers, over an encrypted connection in which each side proves who it is |
| Branch discovery | UDP | Three ports between 20000 and 49000 | Worked out from the branch's link secret, so they differ from one laboratory to another | The branch's computers on the local network |
| A network analyser (TCP) | TCP | 2575 | Typed by the technician on the analyser's card; each analyser has its own | The analyser |
| A network analyser (UDP) | UDP | 20035 | Typed by the technician on the analyser's card | The analyser, only from the address or the networks allowed |
The program's actual port is written in the configuration file clarus-lis.config.json in the program's folder, in the field port. The database's port is the port line of the file postgresql.conf inside pgdata.
A.2 Ports listening inside the computer only
The program opens other ports on the address 127.0.0.1 alone, numbered by Windows at each start: to carry a member computer to its server, and for the remote support service. The network does not reach them, so they have no firewall rule.
A.3 Connections going out of the laboratory
| To | Port | Why |
|---|---|---|
| Clarus's servers | 443 (HTTPS) | Updates, the library of link profiles, the cloud backup, and a member computer's road to its server when the local network does not reach it |
| Clarus's servers | 9443 | Reaching the laboratory from outside it, through Clarus |
| The mail server the laboratory sets | 465 by default | Sending messages and reports by email |
Nothing comes into the laboratory from the internet, so no port is opened for the program on the router.
A.4 Firewall rules
| Rule | Added when | Networks |
|---|---|---|
| The program's port (TCP) | The server is opened to the network's devices | Private and Domain only |
| The member computers' port (TCP) | The server is opened to the network's devices | Private and Domain only |
| Branch discovery (UDP) | The server is opened to the network's devices | Private and Domain only |
| One rule for each network analyser | The analyser is saved, after Windows' permission prompt is accepted | In the group Clarus LIS analyzers |
A Public network is opened for none of them, on purpose.