{"id":8844,"date":"2023-08-08T19:41:28","date_gmt":"2023-08-08T19:41:28","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&p=8844"},"modified":"2023-08-08T20:09:58","modified_gmt":"2023-08-08T20:09:58","slug":"adding-staff-accounts","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/adding-staff-accounts\/","title":{"rendered":"Adding Staff Accounts"},"content":{"rendered":"

This article describes how to add or edit Staff Accounts<\/strong> in the SNIP<\/strong><\/span> NTRIP Caster. \u00a0A summary of Staff Accounts can be found here<\/a>.<\/p>\n

Staff Accounts are created and edited from within the Edit a Customer Entry<\/strong> dialog.\u00a0 Editing the Staff is accomplished by pressing the Staff Accounts<\/strong> button.\u00a0 [This dialog is reached using the menu command Setup<\/strong> \u21d2 Manage Customer Accounts\u2026<\/strong>]<\/p>\n

When pressed, a dialog listing the current staff is then presented.\u00a0\u00a0 From this dialog the staff entries can be edited, created, and removed using the buttons Edit\u2026<\/strong>\u00a0 Add an Entry\u2026<\/strong> and Remove<\/strong> in the normal way.<\/p>\n

Note<\/strong><\/span>: Changes made in the dialog Edit a Customer Entry <\/strong>are not immediately saved when the dialog itself is saved.\u00a0 They are only saved to the permanent storage when BOTH the parent dialog (the Staff Accounts Dialog<\/a>) and it’s parent dialog (the Edit Customer Dialog<\/a>) are saved.\u00a0 This is one of the few multiple modal dialogs used in SNIP<\/strong><\/span>.<\/p>\n

Below are two representative Staff entries, the one on the left is a new Staff entry without any content, while the one of the right is completed with suitable and has acceptable content to be saved.<\/p>\n

\"\"<\/a><\/p>\n

The icons displayed on the right side (the check box, the X, and the question mark) are used to indicate the validity of the textual entry to the left.\u00a0 The question mark icon is used in cases where only partial input is present and should be read as \u201cthis input may<\/em> be valid, depending on further input received\u201d \u00a0Hover the mouse over each icon to see a tool tip with any problems found and advice on how to correct it.<\/p>\n

When all the required fields have valid entries, the OK<\/strong> <\/span>button is enabled and the Staff Account can then be saved.\u00a0 The Cancel<\/strong><\/span> button closes the dialog with no changes made.\u00a0 The Reset<\/strong><\/span> button restores all entries to the text initially shown.<\/p>\n

If the Staff entry has been used in the past, the date and time of the last connection is shown along with the IP from which the connection came.\u00a0 A count of all connections from the creation of the entry is also shown.<\/p>\n

Entering the Details<\/strong><\/h3>\n

The Account is Active<\/strong><\/span> checkbox is a master on\/off switch for this Staff Account. When UNchecked the account cannot be used.<\/p>\n

The Name<\/strong> <\/span>is a required short name which is used in various reports to identify and greet this staff member.\u00a0 It must be one word (no white space) and it MUST be UNIQUE within the scope of that Customer (that realm).<\/p>\n

The eMail<\/strong> <\/span>requires a valid email that is used to uniquely identify the Staff Account when logging into the Web API and for sending emails.\u00a0 The email used must be valid (well-formed) and UNIQUE within the scope of the current Customer (realm).\u00a0 Comparison of emails to ensure uniqueness is not case sensitive, so the following are all considered to be the same email:\u00a0 Me@gmail.com, me@Gmail.com, me@GMAIL.COM\u00a0 [Aside:<\/em> The same email can be used as a staff entry in another Customer if desired.]<\/p>\n

The Contact#<\/strong><\/span> is an optional field used to hold a phone number for the Staff member.<\/p>\n

The Allow Read-Write Access<\/strong><\/span> checkbox is a master on\/off switch for this Staff Account to access the Web API using read-write<\/em><\/strong> privileges. When checked, and when the Staffer has logged in with the correct email, realm, and the password value below, access is granted to the same read-write commands the Customer account is allowed to use.\u00a0 Such a connection can edit and change basic User Account details for users owned by the Customer, such as resetting passwords. \u00a0When Un<\/strong>checked, the staff account cannot access the Web API using read-write<\/em><\/strong> privileges.<\/p>\n

The Password<\/strong> <\/span>under this is used for read-write<\/em><\/strong> privileges. A valid password must be at least 4 characters in length, and have no white space.\u00a0 The \u201cG<\/strong><\/span>\u201d button (generate) can be used to create a unique password.\u00a0 \u00a0If there is no valid password present when the dialog is saved, the Allow Read-Write Access<\/strong> checkbox will be set as Un<\/strong>checked.<\/p>\n

The Allow Read-Only Access<\/strong><\/span> checkbox is a master on\/off switch for this Staff Account to access the Web API using read-only<\/em><\/strong> privileges. When checked, and when the Staffer has logged in with the correct email, realm, and the password value below, access is granted to the read-only commands the Customer account is allowed to use.\u00a0 Such a connection can NOT<\/strong> edit and change basic User Account details for users owned by the Customer. It can however see various details such as user account passwords. \u00a0When Un<\/strong>checked, the staff account cannot access the Web API using read-only<\/em><\/strong> privileges.<\/p>\n

The Password<\/strong><\/span> under this is used for read-only<\/em><\/strong> privileges. A valid password must be at least 4 characters in length, and have no white space.\u00a0 The \u201cG<\/strong><\/span>\u201d button (generate) can be used to create a unique password.\u00a0 \u00a0If there is no valid password present when the dialog is saved, the Allow Read-Only Access<\/strong> checkbox will be set as Un<\/strong>checked.<\/p>\n

Note that the fundamental purpose of a Staff account is to give Web access to the staffer, so at least one of these two check boxes would normally be checked.<\/p>\n

 <\/p>\n

Using Staff Accounts on the Web<\/h2>\n

Using a Staff Account with the Web API log-in<\/a> process is the same as for the Customer Account or for the Admin account. The Staff account logs in with its assigned email as the name, the Customer nickname as the \u201crealm\u201d and the correct password.\u00a0\u00a0 See this article<\/a> for further details.<\/p>\n","protected":false},"excerpt":{"rendered":"

This article describes how to add or edit Staff Accounts in the SNIP NTRIP Caster. \u00a0A summary of Staff Accounts can be found here. Staff Accounts are created and edited from within the Edit a Customer Entry dialog.\u00a0 Editing the Staff is accomplished by pressing the Staff Accounts button.\u00a0 [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":[539,518],"class_list":["post-8844","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-managing-user-accounts","ht_kb_tag-staff-accounts","ht_kb_tag-web-api"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8844","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=8844"}],"version-history":[{"count":5,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8844\/revisions"}],"predecessor-version":[{"id":8851,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8844\/revisions\/8851"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=8844"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=8844"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=8844"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}