{"id":7434,"date":"2021-02-20T19:03:14","date_gmt":"2021-02-20T19:03:14","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&p=7434"},"modified":"2022-10-24T19:21:01","modified_gmt":"2022-10-24T19:21:01","slug":"user-accounts-adding-restrictions","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/user-accounts-adding-restrictions\/","title":{"rendered":"User Accounts, adding Restrictions"},"content":{"rendered":"

This article describes how to add Restrictions<\/strong> to user accounts<\/a> in the SNIP<\/strong><\/span> NTRIP Caster.\u00a0\u00a0 Every\u00a0 NTRIP Client<\/a> connection to the Caster (every user) requires a valid user account, (a name and password to connect with).\u00a0 And each of these accounts can be further restricted in various ways.\u00a0 Use this feature to achieve a fine level of control over what resources (Base Stations) each user is allowed to connect to. \u00a0 This article summarizes the various ways a user account can be restricted.<\/p>\n

New Users<\/h2>\n

\"\"<\/a>When a new user is created (or an existing user account is edited) a user dialog is presented (click to enlarge image).\u00a0 This article<\/a> describes the basic process to add a new user.\u00a0\u00a0 The Basic Settings<\/strong><\/em> tab is available in all models of SNIP<\/strong><\/span> and is used to create and edit User Accounts.\u00a0 The other tabs are all used to add restrictions to the way in which the user account can connect. Note:<\/strong><\/span> These are all advanced features and depend on the presence of an active \u201cEnhanced User Management\u201d Plug-In to be used.<\/p>\n

Restrictions are cumulative.\u00a0 That is, a user may be blocked from connecting if ANY of the restrictions on that user account are found to be true.\u00a0 In the tabs of the dialog a checkbox icon (\u221a<\/strong>) is displayed for any tab that has active restrictions set.\u00a0 An X<\/strong> is used when the restriction has triggered (such as a user whose allowed connection time has past).\u00a0 Similar visual indicators are used in the table dialog that displays all users.<\/p>\n

Restrictions<\/h2>\n

Each user account can be restricted in a a number of ways.\u00a0 A article which describe in greater detail the use of each restriction type may be found in the links below.<\/p>\n

Restrict by Connection Time<\/strong><\/span><\/a><\/h3>\n

The feature is used to disable a user’s ability to connect past a predetermined date and time. Caster operators who sell access time to their customers can use this feature to control access to paying clients.\u00a0 Use this feature if you wish to grant another party short term access to the Caster or (on conjunction with other restrictions below) access to a specific Base station (or stations) for a predetermined period of time.<\/p>\n

Its use is described further in this article<\/a>.<\/p>\n

Restrict by Base Stations<\/strong><\/span> the User can or cannot use<\/a><\/h3>\n

The feature is used to control the user’s ability to connect to a controlled list of Base Stations.\u00a0 When using this restriction, the user can have either a defined list of Base Stations they are allowed to connect to, or a list of stations they are not allowed (prevented) from connecting to.\u00a0 Use this feature to limit certain user accounts to certain Base Stations.\u00a0 The default state is that all valid user accounts can connect to all valid\/active Base Stations.<\/p>\n

Its use is described further in this article<\/a>.<\/p>\n

Restrict by User Agents<\/strong><\/span>\u00a0 (software) the User can or cannot use<\/a><\/h3>\n

The feature is used to control the user’s ability to connect only with a controlled list of NTRIP Clients<\/a> (in other words the software they use to connect with).\u00a0 This feature uses the “Agent” string which all client devices provide when first connecting.\u00a0 When using this restriction, the user can have either a defined list of Agents they are allowed to connect with, or a list of Agents they are not allowed (prevented) from connecting with.\u00a0 The default state is that all valid Agents can connect to all valid\/active Base Stations.<\/p>\n

Its use is described further in this article<\/a>.<\/p>\n

Restrict by IP Addresses<\/strong><\/span> the User can or cannot use<\/a><\/h3>\n

The feature is used to control the user’s ability to connect from a controlled list of IP addresses.\u00a0 When using this restriction, the user can have either a defined list of IPs they are allowed to connect from, or a list of IPs they are not allowed (prevented) from connecting from.\u00a0 The default state is that all valid IPs (except those on the active IP ban list<\/a>) can connect to all valid\/active Base Stations.<\/p>\n

Its use is described further in this article<\/a>.<\/p>\n

Restrict by MAC Addresses<\/strong><\/span> the User can or cannot use<\/a><\/h3>\n

The feature is used to control the user’s ability to connect from a controlled list of MAC addresses.\u00a0 When using this restriction, the user can have either a defined list of MACs they are allowed to connect from, or a list of MACs they are not allowed (prevented) to connect from.\u00a0 The default state is that all valid MAP addresses may connect to all valid\/active Base Stations.<\/p>\n

Its use is described further in this article<\/a>.<\/p>\n

Restrict by Hourly Usage<\/strong> (total use time)<\/a><\/h3>\n

The feature is used to control the total amount of time the User Account can be connected to the Caster.\u00a0 When using this restriction, the duration of each valid user connection is measured and accumulated.\u00a0 When a preset limit for that user is reached, the user may no longer connect to the Caster.\u00a0 Various email alerts are provided to inform both the account owner and the Caster operators when the time used is nearing its end point.\u00a0 The default state is to disabled this restriction.<\/p>\n

Its use is described further in this article<\/a>.<\/p>\n

Restrict by Geo Fence<\/strong> the User must remain within<\/a><\/h3>\n

The feature is used to control the user’s ability to connect to a predefined region of use.\u00a0 When using this restriction, the user must report a NMEA-183 $GGA location that is within the prescribed region or they will be disconnected.\u00a0 The default state is that any reported NMEA-183 $GGA location may connect.<\/p>\n

Its use is described further in this article<\/a>.<\/p>\n

 <\/p>\n

\n

 <\/p>\n

General Controls for Allow<\/em> & Prohibit<\/em> lists<\/h3>\n

Several of the restrictions tabs use a common set of controls to create the lists of allowed<\/em> and prohibited<\/em> items they apply to a specific user account.\u00a0 These controls all work the same way, although the valid content differs with each tab (the below image is taken from the Base Station restrictions tab).<\/p>\n

\"\"The Select All<\/strong> button checks all the items on the list (including any hidden ones which will also be shown). The list is increased to show all known valid values.\u00a0 This is a convenience button, to be used when more items will be checked than not checked.\u00a0 Logically speaking, there is no point in having a list with all possible choices enabled; it is better to disable the restriction itself (with the ‘activate’ button).<\/p>\n

The Select None<\/strong> button performs the inverse of this, deselecting all items and showing them all (including hidden items).\u00a0 This is also a convenience button, to be used when more items will be UN-checked than checked.<\/p>\n

The Add…<\/strong> button allows the operator to enter a valid value that is not yet present in the Caster.\u00a0 [For example, a Base Station name that is not part of the SNIP<\/strong><\/span> the Caster setup when this dialog was opened.]<\/p>\n

The Restore<\/strong> button return the list to its last stable state.<\/p>\n

A checkbox called Hide Those Not Selected<\/strong> (found at the bottom of the tab) is used to hide items which are not checked.\u00a0 This has value for clutter reduction on Casters with large Base Stations lists so that the operator can clearly see what has been selected.<\/p>\n

\n

Additional Restrictions by geographic area, and by data consumption levels\/limits are also being developed.<\/p>\n

 <\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

This article describes how to add Restrictions to user accounts in the SNIP NTRIP Caster.\u00a0\u00a0 Every\u00a0 NTRIP Client connection to the Caster (every user) requires a valid user account, (a name and password to connect with).\u00a0 And each of these accounts can be further restricted in various ways.\u00a0 Use this […]<\/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":[283],"ht-kb-tag":[494,495],"class_list":["post-7434","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-managing-user-accounts","ht_kb_tag-restrictions","ht_kb_tag-user-accounts"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7434","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=7434"}],"version-history":[{"count":27,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7434\/revisions"}],"predecessor-version":[{"id":8592,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/7434\/revisions\/8592"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=7434"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=7434"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=7434"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}