Bosch PRAESENSA PRA-CSLD - Optional: Using the Open Interface

132 en | Optional: Using the Open Interface PRAESENSA
2020-09 | V1.20 | PRAESENSA 1.20 Configuration manual Bosch Security Systems B.V.
16 Optional: Using the Open Interface
TCP/IP devices can access the system through the Open Interface. A maximum of twenty (20)
TCP/IP devices with Open Interface access can be used. This includes connection to Logging
Servers (see Optional: Install the Logging Server, page 22 ). The configuration web browser
uses a different port (port80 forwarded to HTTPS493) for the connection and is not part of
this limitation.
The PRAESENSA Open Interface is based on a C# implementation and on .NET framework
technology, as described by Microsoft.
Many programming languages recognize .NET, which makes development of user interfaces
(e.g. PC call stations) by third parties easier.
The PRAESENSA Open Interface is described in the PRAESENSA Open Interface programming
instructions manual:
– Open Interface programming instructions.pdf
– Download the manual from www.boschsecurity.com > PRAESENSA product document
section (e.g. the system controller). See also Related documentation, page 7 .
– It is not possible to derive any rights from this PRAESENSA Open Interface programming
instructions manual regarding the programming interface.
– Extensions and improvements on the Open Interface can be implemented when new
versions of PRAESENSA are introduced. See (Mandatory) software, page 16 .
– Since the Open Interface programming instructions manual is intended for programmers,
it is only available in English.
TCP/IP connection and ports
After PRAESENSA has been started, the system controller listens to port 9401 and 9403. The
set‑up of the TCP/IP connection must originate from your system using the control hostname
address of the PRAESENSA system controller (see Logon the application, page 35 ) and port
9401 or port 9403. The connection between the PRAESENSA system and your system is based
on a stream connection. This implies that messages may be transferred using multiple
packets.
IMPORTANT: Port 9401 is used for non‑secure connections and port 9403 is used for secure
connections. For secure connections, TLS1.2 is used.
Safety precautions
The Open interface connection (i.e. an Internet connection) is regarded as an open connection
that requires extra safety precautions. For example, a firewall to prevent unauthorized persons
using the PRAESENSA system. Therefore install and run the PRAESENSA Open Interface
certificate. Also the application connecting to the Open Interface needs to validate the
certificate. See Open interface, page 114 .
– PRAESENSA can also limit the access of TCP/IP devices. See System settings, page 69
– Use of the Open Interface can lead to situations in which PRAESENSA does not comply
anymore to the evacuation standards.
Scope
As mentioned before, the PRAESENSA Open Interface Programming Instructions manual
describes how to use the PRAESENSA Open Interface in combination with C# and .NET. To
understand this manual, knowledge in the following fields is necessary:
– The C# programming language and its development environment.
– The principle of .NET.
– PRAESENSA and its installation and functionality. See Related documentation, page 7 .