Changeset 10509 in ntrip for trunk

Timestamp:

Jun 13, 2024, 10:32:26 PM (5 months ago)

Author:

stuerze

Message:

minor changes

Location:

trunk/BNC/src

Files:

• bnchelp.html (modified) (3 diffs)
• bncwindow.cpp (modified) (1 diff)

trunk/BNC/src/bnchelp.html

@@ -1315 +1315 @@
 <p><h4 id="network">2.2 Network</h4></p>
 <p>
-You may need to specify a proxy when running BNC in a protected network. You may also like to use the Transport Layer Security (TLS) and its predecessor, Secure Sockets Layer (SSL) cryptographic protocols for secure Ntrip communication over the Internet.
+You may need to specify a proxy when running BNC in a protected network. You may also like to use the Transport Layer Security (TLS) and its predecessor,
+Secure Sockets Layer (SSL) cryptographic protocols for secure Ntrip communication over the Internet.
 </p>
 <p><h4 id="proxy">2.2.1 Proxy - Usage in a protected LAN</h4></p>
 <p>
-If you are running BNC within a protected Local Area Network (LAN), you might need to use a proxy server to access the Internet. Enter your proxy server IP and port number in case one is operated in front of BNC. If you do not know the IP and port of your proxy server, check the proxy server settings in your Internet browser or ask your network administrator. Without any entry, BNC will try to use the system proxies.</p>
-<p>
-Note that IP streaming is often not allowed in a LAN. In this case you need to ask your network administrator for an appropriate modification of the local security policy or for the installation of a TCP relay to the Ntrip Broadcaster you need to access. If this is not possible, you might need to run BNC outside your LAN on a host that has unobstructed connection to the Internet.
-</p>
+If you are running BNC within a protected Local Area Network (LAN), you might need to use a proxy server to access the Internet.
+Enter your proxy server IP and port number in case one is operated in front of BNC.
+If you do not know the IP and port of your proxy server, check the proxy server settings in your Internet browser or ask your network administrator.
+Without any entry, BNC will try to use the system proxies.</p>
+<p>
+Note that IP streaming is often not allowed in a LAN. In this case you need to ask your network administrator for an appropriate modification
+of the local security policy or for the installation of a TCP relay to the Ntrip Broadcaster you need to access.
+If this is not possible, you might need to run BNC outside your LAN on a host that has unobstructed connection to the Internet.</p>
 
 <p><h4 id="ssl">2.2.2 SSL - Transport Layer Security</h4></p>
-<p>Communication with an Ntrip Broadcaster over Secure Sockets Layer (SSL) as well as the download of RINEX skeleton files when available from HTTPS websites requires the exchange of client and/or server certificates. Specify the path to a directory where you save certificates on your system. You may like to check out <u>http://software.rtcm-ntrip.org/wiki/Certificates</u> for a list of known Ntrip Server certificates. You may also just try communication via SSL to check out whether this is supported by the involved Ntrip Broadcaster. </p>
-<p>SSL communication may involve queries coming from the Ntrip Broadcaster or from a HTTPS website hosting RINEX skeletons. Such a query could show up under BNC's 'Log' tab especially when self-signed SSL certificates are used. Example:
-<pre>
+<p>
+Communication with an Ntrip Broadcaster over Secure Sockets Layer (SSL) as well as the download of RINEX skeleton files when available from HTTPS websites
+requires the exchange of client and/or server certificates.  </p><p>
+Specify the path to a directory where you save CA certificates on your system.
+BNC creates from *.crt and *.pem files a CA certificate database, which is used by the socket during the handshake phase to validate the peer's certificate. </p>
+<p>
+SSL communication may involve queries coming from the Ntrip Broadcaster or from a HTTPS website hosting RINEX skeletons.
+Such a query could show up under BNC's 'Log' tab especially when self-signed SSL certificates are used. Example:
+<pre><p style="font-family:Monospace">
    SSL Error
    Server Certificate Issued by:
@@ -1338 +1349 @@
    No certificates could be verified
 </pre>
-Queries should not be received by a client when a server uses official SSL certificates.
-</p>
-<p>
-Tick 'Ignore SSL authorization errors' if you generally trust the server and do not want to be bothered with this. Note that SSL communication is usually done over port 443.
-</p>
+</p>
+<p>
+Queries should not be received by a client when a server uses official SSL certificates. </p>
+<p>
+You may also just try communication via SSL to check out whether this is supported by the involved Ntrip Broadcaster.
+Note that SSL communication is usually done over port 443.</p>
+<p>
+Two-sided communication with an Ntrip Broadcaster over SSL requires in addition the exchange of client certificates.
+Specify the full path to the client certificates on your system. The file naming convention for client certificates in BNC is as follows:
+<pre>
+   &lt;hostname&gt;.&lt;port&gt;.crt for the certificate and
+   &lt;hostname&gt;.&lt;port&gt;.key for the private key, where &lt;hostname&gt; is without https://.
+</pre>
+</p>
+<p>
+If available, the client or personal authentication certificate is presented to the peer during the SSL handshake process.
+Password protected key files are not supported.
+Don't try communication via two sided SSL if you are not sure whether this is supported by the involved Ntrip Broadcaster. </p>
+<p>
+Tick 'Ignore SSL authorization errors' if you generally trust the server and do not want to be bothered with this. </p>
 <p><img src="IMG/Figure07.png"width=800/></p>
 <p>Figure 7: BNC's 'Network' panel configured to ignore eventually occurring SSL error messages</p>
@@ -1353 +1379 @@
 <p><h4 id="genlog">2.3.1 Logfile - optional</h4></p>
 <p>
-Records of BNC's activities are shown in the 'Log' tab on the bottom of the main window. These logs can be saved into a file when a valid path is specified in the 'Logfile (full path)' field. The logfile name will automatically be extended by a string '_YYMMDD' for the current date. This leads to series of daily logfiles when running BNC continuously. Message logs cover the communication status between BNC and the Ntrip Broadcaster as well as problems that may occur in the communication link, stream availability, stream delay, stream conversion etc. The time stamps within the 'Log' tab are given in UTC. The time stamps within the logfile are given in GPS Time. The default value for 'Logfile (full path)' is an empty option field, meaning that BNC logs will not be saved into a file.
+Records of BNC's activities are shown in the 'Log' tab on the bottom of the main window.
+These logs can be saved into a file when a valid path is specified in the 'Logfile (full path)' field.
+The logfile name will automatically be extended by a string '_YYMMDD' for the current date.
+This leads to series of daily logfiles when running BNC continuously.
+Message logs cover the communication status between BNC and the Ntrip Broadcaster as well as problems
+that may occur in the communication link, stream availability, stream delay, stream conversion etc.
+The time stamps within the 'Log' tab are given in UTC. The time stamps within the logfile are given in GPS Time.
+The default value for 'Logfile (full path)' is an empty option field, meaning that BNC logs will not be saved into a file.
 </p>
 <p>

trunk/BNC/src/bncwindow.cpp

@@ -1407 +1407 @@
   _proxyHostLineEdit->setWhatsThis(tr("<p>If you are running BNC within a protected Local Area Network (LAN), you may need to use a proxy server to access the Internet. Enter your proxy server IP and port number in case one is operated in front of BNC. If you do not know the IP and port of your proxy server, check the proxy server settings in your Internet browser or ask your network administrator. Without any entry, BNC will try to use the system proxies. </p><p>Note that IP streaming is sometimes not allowed in a LAN. In this case you need to ask your network administrator for an appropriate modification of the local security policy or for the installation of a TCP relay to the Ntrip Broadcasters. If this is not possible, you may need to run BNC outside your LAN on a network that has unobstructed connection to the Internet. <i>[key: proxyHost]</i></p>"));
   _proxyPortLineEdit->setWhatsThis(tr("<p>Enter your proxy server port number in case a proxy is operated in front of BNC. <i>[key: proxyPort]</i></p>"));
-  _sslCaCertPathLineEdit->setWhatsThis(tr("<p>Communication with an Ntrip Broadcaster over SSL requires the exchange of server certificates. Specify the path to a directory where you save CA certificates on your system. </p><p>BNC creates from *.crt and *.pem files a CA certificate database, which is used by the socket during the handshake phase to validate the peer's certificate. </p><p>Don't try communication via SSL if you are not sure whether this is supported by the involved Ntrip Broadcaster.</p><p>Note that SSL communication is usually done over port 443. <i>[key: sslCaCertPath]</i></p>"));
+  _sslCaCertPathLineEdit->setWhatsThis(tr("<p>Communication with an Ntrip Broadcaster over SSL requires the exchange of server certificates. Specify the path to a directory where you save CA certificates on your system. </p><p>BNC creates from *.crt and *.pem files a CA certificate database, which is used by the socket during the handshake phase to validate the peer's certificate. </p><p>Note that SSL communication is usually done over port 443. <i>[key: sslCaCertPath]</i></p>"));
   _sslClientCertPathLineEdit->setWhatsThis(tr("<p>Two-sided communication with an Ntrip Broadcaster over SSL requires in addition the exchange of client certificates. Specify the full path to the client certificates on your system.</p><p></p><p>The file naming convention for client certificates in BNC is as follows: &lt;hostname&gt;.&lt;port&gt;.crt for the certificate and &lt;hostname&gt;.&lt;port&gt;.key for the private key, where &lt;hostname&gt; is without https://. </p><p> If available, the client or personal authentication certificate is presented to the peer during the SSL handshake process. Password protected key files are not supported. </p><p>Don't try communication via two sided SSL if you are not sure whether this is supported by the involved Ntrip Broadcaster. </p><p>Note that SSL communication is usually done over port 443. <i>[key: sslClientCertPath]</i></p>"));
   _sslIgnoreErrorsCheckBox->setWhatsThis(tr("<p>SSL communication may involve queries coming from the Ntrip Broadcaster. Tick 'Ignore SSL authorization errors' if you don't want to be bothered with this. <i>[key: sslIgnoreErrors]</i></p>"));