{"id":7412,"date":"2021-02-13T21:33:09","date_gmt":"2021-02-13T21:33:09","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&p=7412"},"modified":"2021-03-06T21:30:48","modified_gmt":"2021-03-06T21:30:48","slug":"adding-user-accounts","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/adding-user-accounts\/","title":{"rendered":"Adding User Accounts"},"content":{"rendered":"

This article describes how to quickly add new user accounts to the SNIP<\/strong><\/span> NTRIP Caster.\u00a0\u00a0 Every NTRIP Client<\/a> connection to the Caster (every user), requires a valid user name and password to connect (unless you are running your Caster in an open mode where no user account is required to connect).<\/p>\n

When a new user is created (or an existing user account is edited) the below dialog is presented. The initial tab (“Basic Settings”) is used to enter the key data needed to create the user account.\u00a0 Like other SNIP<\/strong><\/span> dialogs, extensive tool tips are used; simply hover over the graphical element in question to see additional information about its use.<\/p>\n

\"\"<\/a>Complete the dialog by entering these three values (click image to enlarge).<\/p>\n

User Name:<\/strong><\/span>\u00a0 The name of the user. Only valid NTRIP user names are allowed (no spaces, some characters are not allowed).<\/p>\n

Password:<\/strong><\/span> The password. Press the Generate button, or enter a value. Only valid NTRIP passwords are allowed (no spaces, a few characters are not allowed).<\/p>\n

Connections:<\/strong><\/span>\u00a0 Enter as many concurrent connections as this user account is allowed to have at any given time.<\/p>\n

The other tabs along the left side of dialog allow access to various connection restrictions<\/strong><\/a> which can be placed on the user account to control access to the Caster’s Base Stations.<\/p>\n

Important:\u00a0<\/strong><\/span> Capitalization matters! In NTRIP the user names, passwords, and Base Station mountPts are all case sensitive.<\/p>\n

The new user account is created when you press the OK<\/strong> button.\u00a0 Depending on how you have set up your Caster, an email<\/a> may be issued to the customer account you have associated with this user account.\u00a0 This information is CCed to the Caster administrator by email as well.\u00a0 In the user’s NTRIP Client equipment, they will enter this user name and password.<\/p>\n

[If you have also set a time of use restriction<\/a> (a point in time when this account can no longer be used to connect) additional reminder eMails<\/a> may be sent to the customer account and to the Caster administrator as the expiration time draws near.\u00a0 This process allows the caster operator back office to coordinate renewal billing events.]<\/p>\n

The small green info<\/em> button<\/span> will bring up this help page when pressed.<\/p>\n

The next section, entering or assigning a customer account to be associated with this user, is discussed further in another article.<\/p>\n

Because this action is creating a new user, there is no prior connection data to be displayed.\u00a0 When an existing user account is being edited, a summary of prior and active (if connected) data is also shown:<\/p>\n

\"\"<\/p>\n

 <\/p>\n

The object model; Users<\/strong> versus Customers<\/strong> \/ Clients<\/h3>\n

There are two fundamental ‘account’ concepts used in the SNIP<\/strong><\/span> Caster.\u00a0 The user account<\/strong>, and the customer account<\/strong>.\u00a0 The user account<\/em> is used by NTRIP Client devices to connect-to (log in to) the SNIP<\/strong><\/span> Caster. The customer account<\/em> holds details, such as the contact eMail or billing address, about a real world object such as the person or a firm who ‘owns’ that\u00a0 user account.\u00a0 Every user account is owned by one (and only one) customer account.\u00a0 A customer account may have one or more user accounts.\u00a0 This provides great flexibility regarding how you choose to set up your users; a few common examples are provided below.<\/p>\n

[Aside<\/strong><\/span>: Customer accounts are also used with Base Station Reservations]<\/p>\n

Every user account<\/strong> consists of a unique user name<\/em> and a password<\/em>, and also an allowed number<\/em> of simultaneous (concurrent) connections.\u00a0\u00a0 Each individual user account can connect simultaneously as many times as you allow.\u00a0 Some SNIP<\/strong><\/span> deployments will set this value to one; in which case a given user account can make one only connection at a time.\u00a0 Such a deployment might create three user accounts for a customer who required corrections for three different devices.\u00a0\u00a0 Another deployment might create only a single user account and allow all three concurrent connections using that single account.<\/p>\n

The various connection restrictions<\/strong><\/a> which can also be associated with any user account provide further control. For example; a given user account may also restricted that it can only connect to a specified list of Base Stations or that a specific type of NTRIP equipment must be used.<\/p>\n

Note<\/strong><\/span>: The “Enhanced User Management” Plug-In is required to create customer accounts and to add restrictions to user accounts.\u00a0 In the absence of this Plug-In (for Lite<\/strong><\/em><\/span> and Basic<\/strong> <\/em><\/span>users of SNIP<\/strong><\/span>) all user accounts are assigned to a common customer account.<\/p>\n

Examples<\/h4>\n

Consider as a fictitious example a farmer named “Martin” who needs to be set up with corrections for four tractors.\u00a0 Let’s presume these four devices are called John, Paul, George, and Ringo.<\/p>\n

In any event Martin<\/strong> would have a customer account created for him.\u00a0 This would contain his full name and contact details (address, phone, email, etc.) and well as various bits of information needed to manage the business relationship between the two firms.\u00a0 Other Plug-Ins, such as eMail or monitoring, will likely also be of value in managing the client relationship aspect of this.\u00a0 This customer account would then own<\/em> the user accounts that were created.<\/p>\n

The user account setup(s) for the four tractors would likely be created in one of the two ways below:<\/p>\n