Legacy Documentation for Statseeker version 5.5.3

Index


Overview

Statseeker user accounts provide access to the Statseeker web interface and the Statseeker RESTful API. A Statseeker installation comes with a single admin user account which is configured during the installation process (see Installation Guide for details). Initially, the admin account is the only account that will have access to the Statseeker Administration Tool which is used to configure and manage your Statseeker installation. You can assign additional Statseeker user accounts the Admin role to allow other accounts this same functionality.

Additional Statseeker user accounts can be created, and these accounts can be tailored to a purpose by associating the user account with groups. Grouping allows you to control the visibility of, and access to, elements of your network and specific functionality within Statseeker, for more information on this see Users and Grouping.

[top]

Default Settings

The default settings for user access to dashboards, and dashboard permissions can be managed in the Admin Tool:

  • Select Admin Tool > Reporting / Scheduling > Console Options

Global Settings - default settings applied to all Statseeker user accounts

  • Enable Dashboards - toggle Dashboards tab availability
  • Set Dashboards User Role (non-admin) - applies to non-admin accounts, admin users always have edit permission
  • Enable Custom Reporting Console - toggle Reporting tab availability
  • Default Tab - set the default tab when accessing the Statseeker server via the web GUI
  • NIM Console Default - set the default Console tab layout (Removed in Statseeker v5.5.3)

The User Overrides section allows you to configure user-specific overrides to each of the global settings.

[top]


Creating New Users

To create a new Statseeker user account:

  • Select Administration Tool > User Profile/Grouping > Add / Edit Users

This will open the Add / Edit Users page with the Administration Tool.

  • Enter a username into the text field and click Add

The New User Configuration screen is displayed.

Field Description
Is Admin Set the flag to provide the account the same rights and access as the default admin account

Note: the Is Admin role is not sufficient to update the server root user account password from within the Admin Tool, this can only be done by the admin user.
Email Email address used when Statseeker emails reports\alerts to the Statseeker user
API Access Level of API access to be granted to the user account
Authentication Method

- This field is only visible when the server has been set to utilize LDAP or Radius authentication -

  • File - authenticated directly with the Statseeker server
  • LDAP - use your existing Active Directory/LDAP authentication to manage access to Statseeker
  • RADIUS - use your existing RADIUS server to manage access to Statseeker
Password

- This field is only visible when the user account has been set to utilize FILE authentication -

The password required for the user account to access the web interface. This password can be updated by the user after login.
Timezone The default timezone used by reports when viewed by the user
Top N The default number of rows returned by reports for that user (overridden by settings in Custom Reports)
Report Row Spacing Specify the amount of vertical whitespace used when presenting tabular reports

  • Standard - default layout
  • Compact - reduce vertical whitespace to a minimum to present more data rows in a given view
Export Date Format Date format to be used when exporting report data as *.csv


To configure the user account:

  • Specify an email address for the account
  • Optionally, flag the user as Is Admin to provide the account the same rights and access as the default admin account
Note: The admin account comes with access to the All Groups group, giving the account visibility of all entities and groups on your Statseeker server. New accounts assigned the Admin role do not have default access to any entity or group. See Users and Grouping for details on assigning user accounts visibility to entities and groups. By being selective to which elements of your network an account has visibility, you can create accounts with full Admin privileges to a subset of your network.
  • Set the level of API Access for the account
Note: the Authentication Method field is only visible if Statseeker has been configured to use either LDAP or RADIUS authentication, otherwise all accounts are considered to be using basic file authentication and the field is hidden. For more information see User Authentication.
  • Specify an authentication method
  • If the account is configured to use File authentication, then the Password field will be displayed, enter a password for the account
  • Set the required Time Zone for the account, this will be used when displaying reports to the user within Statseeker
  • Set the default Top N for the user
  • Set the default Export Date Format for the user
  • Click Add User

The user account has been saved and can be used immediately.

Note: by default, a new user account has no visibility of your network via Statseeker. To allow the user to use Statseeker to view data collected from your network you need to associate the user account with one or more groups. See Users and Grouping for more information.

[top]


Editing Users and Updating Preferences

A user with the Admin Role can edit any user account from the Administration Tool, and all users can edit their own account from the main navigator.

Note: non-Admin users can edit their own basic account details (email, password, reporting defaults, etc.), but cannot assign themselves the admin role or alter their level of API access.

To edit the current user account:

  • Select User Configuration from the main navigator

To edit any user account (requires the Admin role):

  • Select Administration Tool > User Profile/Grouping > Add / Edit Users
  • Select the user from the list and click Edit

  • Make the required changes and click Save User

[top]

Log Out or Switch the Current User

To log out or switch the current user:

  • Select Log Out from the main navigator


[top]


Deleting A User

To delete an existing user account:

  • Select Administration Tool > User Profile/Grouping > Add / Edit Users
  • Select the user from the list and click Delete
  • You will be prompted to confirm this action, click OK to delete the user account

[top]


Users and Grouping

By default, a new user account has no visibility of your network via Statseeker. To allow the user to use Statseeker to view data collected from your network you need to associate the user account with one or more groups. A group may be a subset of all devices on your network, or a group of other users.

For example, our new user Minerva logs into the Statseeker server but has no visibility of any device or associated report.

We now link Minerva's user account to the London Hardware group, containing all devices related to the London office.

  • We select Administration Tool > User Profile/Grouping > Groups to an Entity
  • Select an entity type of Users
  • Select Minerva from the list of users
  • Select London Hardware and Engineer_Reports from the list of groups and click >> to add the group to the include column

Minerva refreshes her browser and can now see the devices and reports contained within the two groups that her user account has been associated with.

When Minerva runs a report, or views a dashboard, the content will be filtered to only those devices that Minerva has permission to view, in this instance the contents of the London Hardware group. To give Minerva access to data from the entire network, instead of adding the London Hardware group, we would instead add the All Groups option.

For more information on grouping see Grouping Devices, Interfaces, Users and Reports.

[top]