Hoxhunt offers versatile support for your user data. In addition to built-in user data fields (later referred to as user attributes), you can define up to ten custom user attributes. You can use the user attribute information for training targeting as well as reporting purposes.
Admin Portal > Settings > Technical implementation > User Attribute Mappings
User attributes are divided to two distinct tabs - Standard Attributes and Custom Attributes.
Standard Attributes
Names of the standard attributes cannot be changed. These fields are used widely across Hoxhunt.
| First name Last name Starting date Phone Job title Device Hostnames |
Country City Site Department Manager Disable threat upload Licenses |
Custom Attributes
There are ten custom attributes you can freely rename and utilize as you wish as auxiliary data points. Please note that currently custom attributes are considered strings.
| Custom Attribute 1 Custom Attribute 2 Custom Attribute 3 Custom Attribute 4 Custom Attribute 5 |
Custom Attribute 6 Custom Attribute 7 Custom Attribute 8 Custom Attribute 9 Custom Attribute 10 |
NOTE: Clearing the name field will revert the name back to Custom Attribute [n]. in the user interface (Insights, Admin Portal, etc.)
NOTE: If a custom attribute doesn't contain any data for any of your users, the particular custom attributes may be hidden from the user interface (Insights, Admin Portal, etc.).
TIP: If you want to provision custom user attributes to Hoxhunt, please see Syncing custom user attributes through SCIM.
Available data sources
User Attribute Mappings page has three main data sources to choose from:
- Hoxhunt
- SCIM
- HRIS system
A special data source is only available for license information:
-
Automation
Hoxhunt
By setting user attribute's data source to Hoxhunt you can:
- Set or change the attribute's value for individual users via User Management > User details
- Set or change the attribute's value for your users in bulk via User Management > Actions > Set properties
- Set or change the attribute's value for your users in bulk via CSV user import
TIP: If you ever need to override an attribute's value that is pushed via SCIM or HRIS integration, you can temporarily switch the data source to Hoxhunt, make your edits and switch the data source back. See Tips and tricks section for more information.
User Management view
User Management through User Import Tool or CSV lists
SCIM
By setting user attribute's data source as SCIM, the user attribute will get values only via SCIM integration.
TIP: When setting up SCIM for the first time, all user attributes currently supported by Hoxhunt's SCIM implementation are automatically switched to use SCIM as their data source.
IMPORTANT: Every time you take a new user attribute into use in Hoxhunt, make sure correct data source is selected in Admin Portal > Settings > Technical implementation > User Attribute Mappings.
Automatic user provisioning (SCIM) overview
HRIS system
Hoxhunt supports various HRIS systems as its user data source. Depending on which HRIS integration you have configured, it's name is displayed as one of the data available data sources.
HR Information System integrations
Automation
This special data source is reserved only for automatic license assigning via SCIM Groups.
Dilemma of multiple data sources
It's not uncommon to have user data scattered across multiple user directories, so it's unpractical to expect all data to be consolidated into one place just for Hoxhunt. To address this dilemma, Hoxhunt lets you decide the data source for each user attribute.
You can choose the preferred data source in Admin Portal > Settings > Technical implementation > User Attribute Mappings.
Thank to this flexible approach, you can add and update user data (user attributes) directly via Admin Portal, via CSV user import, via automated user provisioning (SCIM) and from your HR system (HRIS).
After changing the data source
It will take some time to update user's attribute value once the data source of an attribute has been changed. Please wait a moment before targeting training to users or before creating reports based on the changed attributes.
Some users failed to update to the later version
Sometimes user attribute values may not get updated due to invalid values or other issues.
Error: [n] users failed to be updated to the latest version in the previous update
- Locate users whose version has not been updated by going to User Management > Filter by "Needs attribute recalculation".
- Select all users, and then select Actions > Refresh user attributes.
Tip and tricks
Edit automatically provisioned user data manually
By design, user data that has been provisioned to Hoxhunt is locked from manual editing. However if you ever need to override an attribute's value that is pushed via SCIM or HRIS integration, you can temporarily switch the data source to Hoxhunt, make your edits and switch the data source back to what it was. The edited value will remain in Hoxhunt until the value is updated in the data source and automatically pushed to Hoxhunt.
Clear user attribute's value
SCIM doesn't support provisioning empty fields from the source system to target system. This means that even if you clear a certain user attribute in your Entra or Okta, the already provisioned value will not be cleared in Hoxhunt. This is a restriction in SCIM. In such a case, you can temporarily switch the data source to Hoxhunt, clear the value and switch the data source back to what it was. The cleared value will remain empty in Hoxhunt until the value is updated in the data source and automatically pushed to Hoxhunt.
Related articles
Custom user attribute definitions