{"id":1830,"date":"2016-06-17T21:19:18","date_gmt":"2016-06-17T21:19:18","guid":{"rendered":"\/?post_type=ht_kb&p=1830"},"modified":"2018-03-10T21:10:05","modified_gmt":"2018-03-10T21:10:05","slug":"debugging-user-connections-with-a-closed-caster","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/debugging-user-connections-with-a-closed-caster\/","title":{"rendered":"Debugging User Connections with a closed caster"},"content":{"rendered":"

This article covers the various errors and reporting messages that can occur when SNIP<\/strong><\/span> is operating in a closed<\/strong> <\/span>mode such that every new user (every NTRIP Client) must present a valid account and a password in order to log in.<\/p>\n

If SNIP<\/strong><\/span> is operating in an open<\/strong> <\/span>mode, the messages described here will not apply.\u00a0 Under open mode connections all that a user (an NTRIP Client) needs to do is request a mountPt that matches to those in the current Caster table.\u00a0 A similar article dealing with the general debugging of client connections (operating in the open mode) can be found here<\/a>.<\/p>\n

\u00a0It should also be noted that mountPt strings are\u00a0always<\/span> case sensitive and consist of a single word. [So: NEAR3<\/em>, NEAR-3<\/em>, Near3<\/em> are three different mountPts]<\/p>\n

Background Articles<\/h3>\n

Adding new users is covered in general terms in this article<\/a>.\u00a0\u00a0 This article may be of use in understanding how to operate the various console filters<\/a> which SNIP<\/strong> <\/span>provides. Effective filtering is of great benefit when trying to debug a problem connection in the presence of many other server events in the log.<\/p>\n

Closing the SNIP Caster<\/h3>\n

The critical check box\u00a0Allow Anonymous access for Users<\/strong> which is used to enable or disable the open\/closed mode of the SNIP<\/strong> <\/span>Caster is described in this<\/a> article.<\/p>\n

Watching User Connections as they Occur<\/h3>\n

The console log can be used to view each NTRIP Client dialog as it occurs.\u00a0 The critical check box which MUST be set is labeled\u00a0 Display New User Connection Details<\/strong> which found on the Caster and Clients <\/a>tab.\u00a0 Be sure to also set the Log threshold to “minor” and enable client message types in order to see these details.\u00a0 When checked, after each connection is processed, a report of its outcome is presented in the console log. Additional analysis details are provided when the Caster is closed and the connection attempt failed.<\/p>\n

A Typical NTRIP Client connection<\/h3>\n

Will look like the below console log entry when all goes well. In these examples we presume that we have created an account which has been setup with the credentials of: \u00a0user:password<\/em> \u00a0 (all lower case).\u00a0 When the user:password pair sequence is sent, they are encoded in a Base64<\/a> format.\u00a0 The NTRIP Client will connect to a mountPt which is called:\u00a0 MOUNTPT.\u00a0 The values [Cxx] are the sequential count of new client connections on this machine.\u00a0 So a line like: “Client #C09<\/span><\/b> [69.75.31.227:63149]”<\/span> informs you that this was the ninth client connection since SNIP<\/strong><\/span> was started and the IP and port that it came from.<\/p>\n

Working NTRIP Client connection, with good user and good password<\/span><\/h4>\n
[C09<\/span><\/b>]:\u00a0\u00a0Client [#C09] appears to an NTRIP Client<\/b> connecting with:\r\n[C09<\/span><\/b>]:\u00a0\u00a0An NTRIP Client sent: ======================\r\n[C09]:\r\n<\/span>GET \/MOUNTPT HTTP\/1.0\r\nUser-Agent: NTRIP RTKLIB\/2.4.2\r\nAuthorization: Basic dXNlcjpwYXNzd29yZA==\r\n<\/span>[C09<\/span><\/b>]:\u00a0 ======================\r\n[MOUNTPT<\/span><\/b>]:\u00a0\u00a0MountPt [ MOUNTPT ] is a match<\/b> - allow connection IF<\/strong><\/span> credentials match a user entry\r\n[MOUNTPT<\/span><\/b>]:\u00a0\u00a0Credentials for user accepted<\/b><\/span>.\r\n<\/span>[MOUNTPT<\/span><\/b>]:\u00a0\u00a0Client #C09<\/span><\/b> [69.75.31.227:63149] Connected to MOUNTPT<\/b> at 12:21:58 PM (local)<\/span><\/pre>\n
The user name and password are “dXNlcjpwYXNzd29yZA==<\/span><\/b>” and encoded in Base64<\/a> in the above (this is how it is sent over the internet) and, because SNIP<\/strong><\/span> has accepted the user, there is no further analysis information provided.<\/p>\n
Non-Working NTRIP Client connection, no user<\/span> and no password<\/span><\/h4>\n
 [C10<\/span><\/b>]:\u00a0\u00a0Client [#C10] appears to an NTRIP Client<\/b> connecting with:\r\n [C10<\/span><\/b>]:\u00a0\u00a0An NTRIP Client sent: ======================\r\n [C10]:\r\n <\/span>GET \/MOUNTPT HTTP\/1.0\r\n User-Agent: NTRIP RTKLIB\/2.4.2\r\n Accept: *\/*\r\n Connection: close\r\n <\/span>[C10<\/span><\/b>]:\u00a0 ======================\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Mount Pt [ MOUNTPT ] is a match<\/b> - allow connection IF credentials match a user entry.\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0No credentials were extracted from request (Caster is closed), Disconnected<\/b>.\r\n <\/span>[MOUNTPT<\/span><\/b>]:\u00a0\u00a0Client #C10<\/span><\/b> [69.75.31.227:64944] Disconnect from , 89 Bytes in, 959 Bytes out, Connected: 005 mSec<\/b><\/span><\/pre>\n
Non-Working NTRIP Client connection, good user and bad password<\/span><\/span><\/h4>\n
 [C11<\/span><\/b>]:\u00a0\u00a0Client [#C11] appears to an NTRIP Client<\/b> connecting with:\r\n [C11<\/span><\/b>]:\u00a0\u00a0An NTRIP Client sent: ======================\r\n [C11]:\r\n GET \/MOUNTPT HTTP\/1.0\r\n User-Agent: NTRIP RTKLIB\/2.4.2\r\n Authorization: Basic dXNlcjpCYWRQYXNzd29yZA==\r\n <\/span>[C11<\/span><\/b>]:\u00a0\u00a0 \u00a0 ======================\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Mount Pt [ MOUNTPT ] is a match <\/b>- allow connection IF credentials match a user entry.\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Credentials for user did not match<\/b> an entry;\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Detailed Report:\r\n Analysis of User: user<\/b> and PW: BadPassword<\/b> is:\r\n The user: user<\/b> is a valid entry in the tables<\/span>\r\n The password: BadPassword<\/b> is NOT <\/b>Valid for this user<\/span> (good user, bad password)\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Client #C11<\/span><\/b> [69.75.31.227:65331] Disconnect from, 104 Bytes in, 959 Bytes out, Connected: 004 mSec<\/b><\/pre>\n
Non-Working NTRIP Client connection, unknown user<\/span>
\n<\/span><\/h4>\n
 [C12<\/span><\/b>]:\u00a0\u00a0Client [#C12] appears to an NTRIP Client<\/b> connecting with:\r\n [C12<\/span><\/b>]:\u00a0\u00a0An NTRIP Client sent: ======================\r\n [C12]:\r\n GET \/MOUNTPT HTTP\/1.0\r\n User-Agent: NTRIP RTKLIB\/2.4.2\r\n Authorization: Basic QmFkVXNlcjpCYWRQYXNzd29yZA==\r\n <\/span>[C12<\/span><\/b>]:\u00a0\u00a0 \u00a0 ======================\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Mount Pt [ MOUNTPT ] is a match <\/b>- allow connection IF credentials match a user entry.\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Credentials for user did not match<\/b> an entry;\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Detailed Report:\r\n Analysis of User: BadUser<\/b> and PW: BadPassword<\/b> is:\r\n The user name: BadUser<\/b> is NOT <\/b>a Valid Entry in the tables<\/span> (this is an unknown user)\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Client #C12<\/span><\/b> [69.75.31.227:65408] Disconnect from, 108 Bytes in, 959 Bytes out, Connected: 001 mSec<\/b><\/pre>\n
Non-Working NTRIP Client connection, too many connections<\/span>\u00a0<\/span><\/h4>\n
 [C14<\/span><\/b>]:\u00a0\u00a0Client [#C14] appears to an NTRIP Client<\/b> connecting with:\r\n [C14<\/span><\/b>]:\u00a0\u00a0An NTRIP Client sent: ======================\r\n [C14]:\r\n GET \/MOUNTPT HTTP\/1.0\r\n User-Agent: NTRIP RTKLIB\/2.4.2\r\n Authorization: Basic dXNlcjpwYXNzd29yZA==\r\n <\/span>[C14<\/span><\/b>]:\u00a0\u00a0 \u00a0 ======================\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Mount Pt [ MOUNTPT ] is a match <\/b>- allow connection IF credentials match a user entry.\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Credentials for user did not match<\/b> an entry;\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Detailed Report:\r\n Analysis of User: user<\/b> and PW: password<\/b> is:\r\n The user: user<\/b> is a valid entry in the tables<\/span>\r\n The password: password<\/b> is the valid for this user<\/span>\r\n This account currently has 1<\/b> connections, and is allowed as many as 1<\/b>\r\n This account is currently using All <\/b>its allowed connections<\/span> (too many connections)\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Client #C14<\/span><\/b> [69.75.31.227:49327] Disconnect from , 100 Bytes in, 959 Bytes out, Connected: 007 mSec<\/b><\/pre>\n
Note that you set the number of active connections each user can have at one time when you create the account. Some Caster operators allow only one active connection per user at a time. The default value in\u00a0SNIP<\/strong><\/span> is five, but you can set this for each user. If a user account may connect to more than one stream, and from more than one device, (all at the same time) you will need to set the value to accommodate both.\u00a0 [Aside: Some of SNIP<\/strong><\/span> owners use it to make the single connection to a site and then redistribute the stream data to others on the work team. SNIP<\/strong><\/span> is very useful for this, but please confirm that your data provider allows this use.]<\/p>\n
Non-Working NTRIP Client connection, bad user (capitation)<\/span> and good password
\n<\/span><\/h4>\n
 [C15<\/span><\/b>]:\u00a0\u00a0Client [#C15] appears to an NTRIP Client<\/b> connecting with:\r\n [C15<\/span><\/b>]:\u00a0\u00a0An NTRIP Client sent: ======================\r\n [C15]:\r\n GET \/MOUNTPT HTTP\/1.0\r\n User-Agent: NTRIP RTKLIB\/2.4.2\r\n Authorization: Basic VXNlUjpwYXNzd29yZA==\r\n <\/span>[C15<\/span><\/b>]:\u00a0\u00a0 \u00a0 ======================\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Mount Pt [ MOUNTPT ] is a match <\/b>- allow connection IF credentials match a user entry\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Credentials for user did not match<\/b> an entry;\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Detailed Report:\r\n Analysis of User: UseR<\/b> and PW: password<\/b> is:\r\n The user name: UseR<\/b> is NOT <\/b>a Valid Entry in the tables<\/span> (this is an unknown user)\r\n [MOUNTPT<\/span><\/b>]:\u00a0\u00a0Client #C15<\/span><\/b> [69.75.31.227:49782] Disconnect from , 100 Bytes in, 959 Bytes out, Connected: 005 mSec<\/b><\/pre>\n
Here one can observe that the user is \u201cUseR\u201d here and not \u201cuser\u201d as used elsewhere. Note that user and passwords\u00a0ARE<\/span> case sensitive, but that (unlike near matches for mountPts) you are not informed when a user gets the capitalization incorrect.<\/p>\n
Non-Working NTRIP Client connection, due to a bad mountPt<\/span>
\n<\/span><\/h4>\n
 [C16<\/span><\/b>]:\u00a0\u00a0Client [#C16] appears to an NTRIP Client<\/b> connecting with:\r\n [C16<\/span><\/b>]:\u00a0\u00a0An NTRIP Client sent: ======================\r\n [C16]:\r\n GET \/BAD_MOUNTPT HTTP\/1.0\r\n User-Agent: NTRIP RTKLIB\/2.4.2\r\n Authorization: Basic dXNlcjpwYXNzd29yZA==\r\n <\/span>[C16<\/span><\/b>]:\u00a0\u00a0 \u00a0 ======================\r\n [BAD_MOUNTPT<\/span><\/b>]:\u00a0\u00a0No matching mount point, requested: [BAD_MOUNTPT], sending caster table and disconnecting.\r\n [BAD_MOUNTPT<\/span><\/strong>]:\u00a0\u00a0Client #C16<\/span> [69.75.31.227:50138] Disconnect <\/strong>(tried to mount BAD_MOUNTPT, but not in table), 104 Bytes in, 959 Bytes out, Connected: 004 mSec<\/pre>\n
Here, because the requested mountPt is matched to the current caster table entries\u00a0before<\/em> the user credentials, you will receive a console notice of this fact and the user\u2019s credentials will not be checked.<\/p>\n
Non-Working NTRIP Client connection, due to a \u201cnear miss\u201d mountPt<\/span>
\n<\/span><\/h4>\n
 [C17<\/span><\/b>]:\u00a0\u00a0Client [#C17] appears to an NTRIP Client<\/b> connecting with:\r\n [C17<\/span><\/b>]:\u00a0\u00a0An NTRIP Client sent: ======================\r\n [C17]:\r\n GET \/MOUNTpt HTTP\/1.0\r\n User-Agent: NTRIP RTKLIB\/2.4.2\r\n Authorization: Basic dXNlcjpwYXNzd29yZA==\r\n <\/span>[C17<\/span><\/b>]:\u00a0\u00a0 \u00a0 ======================\r\n [MOUNTpt<\/span><\/b>]:\u00a0\u00a0No matching mount point, requested: [MOUNTpt], sending caster table and disconnecting.\r\n [MOUNTpt<\/span><\/b>]:\u00a0\u00a0Note:<\/b> The mountPt requested: [MOUNTpt], almost matches an entry but differs in capitalization<\/b>.\r\n [MOUNTpt<\/span><\/b>]:\u00a0\u00a0Client #C17<\/span><\/b> [69.75.31.227:50374] Disconnect (tried to mount MOUNTpt<\/b>, but not<\/u> in table), 100 Bytes in, 959 Bytes out, Connected: 006 mSec<\/b><\/pre>\n
Here The requested mountPt is matched to the current caster table entries\u00a0before<\/em> the user credentials, and if the mountPt string matched except<\/u> for differences in capitalization, a slightly different console entry is produced noting this. The user is disconnected (the caster table is returned in the normal way) and the user\u2019s credentials will not be checked.<\/p>\n
 <\/p>\n
This article has served to demonstrate console log entries for the the most common NTRIP Client user errors when the Caster is closed.<\/p>\n","protected":false},"excerpt":{"rendered":"
This article covers the various errors and reporting messages that can occur when SNIP is operating in a closed mode such that every new user (every NTRIP Client) must present a valid account and a password in order to log in. If SNIP is operating in an open mode, the […]<\/p>\n","protected":false},"author":13,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"ht-kb-category":[112,283],"ht-kb-tag":[227,229,226,228],"class_list":["post-1830","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-general","ht_kb_category-managing-user-accounts","ht_kb_tag-bad-password","ht_kb_tag-closed-caster","ht_kb_tag-debug","ht_kb_tag-unknown-user"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/1830","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/comments?post=1830"}],"version-history":[{"count":31,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/1830\/revisions"}],"predecessor-version":[{"id":5065,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/1830\/revisions\/5065"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=1830"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=1830"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=1830"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}