Overview
Not all users identified by Torii are actually company employees, some of them are contractors, some are service accounts, and others are test/integration accounts, AI agents or automations.
This article explains the Employee user type in Torii, what it represents, why you should define it, how it is defined, and how this affect what you see across Torii.
Employees in Torii
Employees in Torii are users that represent your actual company employees, and not other independent people that may have access to your systems but are not directly related to the company, such as vendors, contractors etc.
To provide you with better visibility and organizational management, Torii enables you to discover and classify your actual employees.
Classifying users as employees can be done based on your HR management system configuration and/or based on your IDP, and you can filter these configurations to fine-tune your employee count.
Employees are shown in the Employees tab in the Users page and are marked on the single-user page.
You can read more about user categories in Torii and the user page breakdown here.
Why classify Employees?
Classifying Employees helps you define the core population you manage day to day.
By identifying your employees, you can:
Focus user management activities on the users that represent your internal workforce
Maintain a consistent employee count based on your HR system and/or IDP definition
Reduce confusion caused by accounts that aren’t employees (e.g., contractors, service accounts, test users)
Define Employees in Torii
Torii pulls Employees from the HR management system or the IDP you define in Settings.
Go to Settings >> Users & Employees and click Add source under the Employee definition section.
Select the Employee source of truth, as well as any relevant filters on that system. Once selected, you will see an indication for the number of current and past employees found.
At this stage you can also select whether to update the recipient for the Automatically Reassign Stakeholders feature based on your Employee definition system.
Click Preview changes, and another indication will be displayed for the number of employees changed.
Please note, when configuring an Employee Source of Truth, the displayed count of current and past users refers specifically to the number of employees derived from that particular source.
In the case of setting up multiple employee SOT sources, the cumulative employee count from all sources is depicted only in the Preview changes view.
You can also download a full list of changes from the preview screen to verify that the presented changes match your expectations.
Notes
If the HR management system or IDP configured as the employee source of truth was removed as a source, the employee classification will be removed from the users.
If the HR management system or IDP configured as the employee source of truth was disconnected, employee classification will remain until the change takes place in the employee definition source.
You can configure multiple employee sources of truth — Torii will take all selected sources into account when determining whether a user is an employee.
As both Employee and Non-Human are a user type, a user can't belong to both groups. In case a both user type definitions overlap for a user, they will be considered an employee (and not an NHI).
As External is not a user type, a user can both an External user and an Employee.
if Merge Users is enabled, the user's type is determined by their primary email address.
Q&A
- Q: Can I select a custom app as the source for my employee definition?
-
A: Yes. You can select any custom app that has an integration built with Torii's integration builder as your employee definition source.