User Admin

The setup of users in the Kentik portal is discussed in the following topics:

• About Users
• Users Page
• User Admin Dialogs
• Add or Edit User

Note: If you would like assistance with any aspect of registering a user, please email us at support@kentik.com.

A user is anyone at your company that is given authorization to access Kentik. Kentik supports two levels of users:

• Administrator: Can perform all actions.
• Member: Can view all data but have no access to the Admin menu (e.g. cannot add or edit users or devices).

Note: An Administrator can apply a filter in the user settings of any other user (see User Filters).

The Users page is home to the User List, which lists the users that are currently registered for your organization. To open the Users page, choose Admin from the Kentik navbar, then Users from the sidebar at left. Details of the Users page are covered in the following topics:

• Users Page UI
• User List

Note: The Users page is visible only to users whose level is Administrator.

The Users page has the following main elements:

• Filter field: Enter text to filter the User List. The Full Name and Email columns are checked for a match on the string entered in this field.
• Add User button: Opens the Add User dialog (see User Admin Dialogs).
• User List: A table listing your organization’s currently registered users (see User List).

The User List is a table that lists all existing users for a given customer. The table provides the following information and actions for each user:

• ID: The system-generated unique ID assigned when the user was registered.
• Full name: The user’s full name.
• Email: The user’s email address.
• Level: The user’s level: Administrator or Member (see About Users).
• Last login: The date of the user’s most recent login.
• Delete: Opens a confirming dialog that allows you to remove the user from Kentik.

Click on a column heading to sort the list (ascending or descending).

Note: To see additional information about a given user, click anywhere in the row for that user, which opens an Edit User dialog in which you can review and edit settings (see Editing a User).

Adding or editing a user via the Kentik portal involves specifying information in the fields of the user admin dialogs, which are covered in the following topics.

• About User Dialogs
• User Dialogs UI
• User Field Definitions
• User Filters

Note:
- User admin dialogs are visible only to users whose level is Administrator.
- Users can also be added and edited with the User API.

The Kentik portal uses user admin dialogs to collect and display user information. The required information is entered into the fields of either of the following dialogs:

• Add User when registering a new user with Kentik.
• Edit User when editing an already registered user.

The Add User and Edit User dialogs share the same layout and the following common UI elements:

• Close button: Click the X in the upper right corner to close the dialog. All elements will be restored to their values at the time the dialog was opened.
• Remove button (Edit User dialog only): Remove the user from your organization’s collection of Kentik-registered users. This button is only present if the user being edited was manually added.
• Cancel button: Cancel the add user or edit user operation and exit the dialog. All elements will be restored to their values at the time the dialog was opened.
• Add User button (Add User dialog only): Save settings for the new user and exit the dialog.
• Save button (Edit User dialog only): Save changes to user settings and exit the dialog.

User admin dialogs (Add User and Edit User) contain the elements shown in the following table.

User-based filtering allows the application of one or more filters that restrict the data that can be queried by a given user. Because the Admin menu is not available for Members, only Administrators can set user filters. The intent is to enable control by Administrators over the data that can be accessed by specific Member users.

User filters are set from a dialog accessed via the Add Filters button on the Add User or Edit User dialog. The interface for setting a user filter is the same as the Filtering dialog accessed via the sidebar on portal pages such as Data Explorer (see Filtering Pane Settings). Both Saved Filters and Filter Groups can be applied.

Once a user-filter is associated with a given user it is systematically appended (ANDed) with any query run by that user, including:

• Data Explorer or Dashboard queries in the Kentik Detect portal.
• SQL queries from the portal’s Query Editor or via PostgreSQL clients.
  Note: Both the Query Editor and psql access to KDE are now deprecated. For additional information, contact Kentik support.
• Queries via Kentik APIs (see Query API).

One use case for a user filter would be to allow certain Members to only query data from routers whose description contains “backbone.” Another use case would be to allow certain Members to only query data for interfaces whose description contains CUSTOMER and that have been assigned to the sites Ashburn DC3 and Ashburn DC4 (see About Sites).

Users are added and edited via the Users page of the Kentik Detect portal (choose Admin from the Kentik navbar, then Users from the sidebar at left). Adding and editing users is covered in the following sections:

• Adding a User
• Editing a User

Note: The Users page is visible only to users whose level is Administrator.

To register a new user on Kentik Detect:

1. Open the Users page (choose Admin from the Kentik navbar, then Users from the sidebar at left).
2. Click the Add User button to open the Add User dialog.
3. Specify the values of the fields in the dialog (see User Field Definitions).
4. If the new user is a Member, specify any desired User Filters.
5. Save the new user by clicking the Add User button (lower right).

To edit the settings for an existing user:

1. In the User List, click in the row of the user that you’d like to edit. The Edit User dialog will open.
2. Edit the user settings:
   - Change any fields that you’d like to modify (see User Field Definitions).
   - If the user level is Member, change any User Filters.
   - To reset the API token, click the Reset API Token button. A new token will appear in the field.
3. To save changes, click the Save button (lower right).

To remove the user from your organization’s collection of Kentik users, click Remove (lower left).