This page explains how to create, edit, and delete identity groups, and how to specify identity groups in policies.
Overview
Once you create identity groups, you can specify the target users of a policy by selecting from your existing groups. For the types of identity groups and how members are determined, see "What Are Identity Groups?"
Intended Audience
IT administrators
Steps
1. Create an Identity Group
- In the left sidebar, click "Identities" and then "Identity Groups".
- Click "New Group" in the upper-right corner of the screen.
- On the "New Identity Group" screen, enter the "Identity Group Name".
- Under "Select Identities or Conditions to form the Identity Group:", choose how members are determined from the following options:
- Condition Based: Filters identities using a combination of custom conditions.
- Fixed: Lets you select specific identities individually.
- All Identities: Consists of all identities in Josys.
- Depending on your selection, configure the settings described below under "For Condition Based" or "For Fixed". If you select "All Identities", no additional settings are required.
- Click "Create Group". The process is complete when a message appears confirming that the identity group has been created.
For Condition Based
- Select a field under "Condition". The available fields are "Employment Status", "Identity Type", "Department", "Location", and "Job Title".
- Select "is" or "is not" as the operator.
- Select the target values under "Value". You can select multiple values.
- To add another condition, click "Add Condition" and repeat steps 1–3.
If you specify multiple values for one condition, the condition is met if any of the values matches.
If you add two conditions for the same field, an error message appears saying that this condition type is already in use. Specify all values for the same field in a single condition.
If there are no conditions, a message asking you to add at least one condition appears, and the group cannot be created.
For Fixed
- In the identity selection field, select the identities to include in the group.
- Select at least one identity. If none is selected, a message asking you to select at least one identity appears.
2. Edit an Identity Group
- In the left sidebar, click "Identities" and then "Identity Groups".
- Open the menu at the right end of the row for the identity group you want to edit, and click "Edit".
- Make your changes on the edit screen, and then click "Save Changes".
System groups ("Employees", "External", and "System") cannot be edited this way. To change their mapping, see "4. Edit the System Group Mapping".
3. Delete an Identity Group
- In the left sidebar, click "Identities" and then "Identity Groups".
- Open the menu at the right end of the row for the identity group you want to delete, and click "Delete".
- In the confirmation dialog, click "Delete".
System groups cannot be deleted.
4. Edit the System Group Mapping
You can change which identity types are mapped to the system groups "Employees", "External", and "System". For example, use this when you want to treat "Contractor" identities as "Employees".
- In the left sidebar, click "Identities" and then "Identity Groups".
- Open the menu at the right end of the "System Categories" row, and click "Edit Mapping".
- On the "Update System Identity Group Mapping" screen, drag and drop the identity type cards to assign each one to "Employees", "External", or "System".
- Click "Save Changes".
- When you are asked to confirm the changes, click the button to confirm them. To continue editing, click the button to go back to editing.
To restore the default mapping, click "Reset to Default" in the lower-left corner of the screen in step 3, and then click "Reset to Default" in the confirmation dialog. Then save your changes by following steps 4–5.
5. Check Group Membership in the Identity List
- In the left sidebar, click "Identities" and then "All Identities".
- The "Identity Group" column shows the identity groups each identity belongs to. If an identity belongs to three or more groups, up to two are shown, and you can see the rest in a tooltip.
- To go to the identity group list, click the "⋯" menu in the upper-right corner of the screen and select the option to manage identity groups.
- Using filters, you can filter identities by the identity groups they belong to. You can also filter for identities that do not belong to any group.
Notes
- After a group is created, you cannot change how its members are determined (Condition Based, Fixed, or All Identities).
- Identity groups that are in use by a policy, as well as system groups, cannot be deleted.
- If an identity's department or identity type changes through synchronization with an external system, such as External Data Sources, the change is reflected in identity group membership by an update process that runs once a day. It may take some time for changes to be reflected.