Chat now with support
Chat with Support

Identity Manager 8.0.1 - Administration Guide for Connecting to Active Directory

Managing Active Directory Environments Setting up Active Directory Synchronization Base Data for Managing Active Directory Active Directory Domains Active Directory User Accounts Active Directory Contacts Active Directory groups Active Directory Security IDs Active Directory Container Structures Active Directory computer Active Directory Printers Active Directory Locations Reports about Active Directory Objects Appendix: Configuration Parameters for Managing Active Directory Appendix: Default Project Template for Active Directory Appendix: Authentication Modules for Logging into the One Identity Manager

Automatic Assignment of Employees to Active Directory User Accounts

Automatic Assignment of Employees to Active Directory User Accounts

Table 53: Configuration Parameters for Automatic Employee Assignment
Configuration parameter Meaning

TargetSystem\ADS\PersonAutoFullsync

This configuration parameter specifies the mode for automatic employee assignment for user accounts added to or updated in the database through synchronization.

TargetSystem\ADS\PersonAutoDefault

This configuration parameter specifies the mode for automatic employee assignment for user accounts added to the database outside synchronization.

TargetSystem\ADS\PersonExcludeList

List of all user accounts for which automatic employee assignment should not take place. Names given in a pipe (|) delimited list that is handled as a regular search pattern.

Example:

ADMINISTRATOR|GUEST|KRBTGT|TSINTERNETUSER|IUSR_.*|IWAM_.*|SUPPORT_.*|.*\$

TargetSystem\ADS\
PersonAutoDisabledAccounts

This configuration parameters specifies whether employees are automatically assigned to disable user accounts. User accounts do not obtain an account definition.

When you add a user account, an existing employee can be assigned automatically or added if necessary. In the process, the employee master data is created based for existing user master data. This mechanism can follow on after a new user account has been created manually or through synchronization. Define criteria for finding employees to apply to automatic employee assignment. If a user account is linked to an employee through the current mode, the user account is given, through an internal process, the default manage level of the account definition entered in the user account's target system. You can customize user account properties depending on how the behavior of the manage level is defined.

If you run this procedure during working hours, automatic assignment of employees to user accounts takes place from that moment onwards. If you disable the procedure again later, the changes only affect user accounts added or updated after this point in time. Existing employee assignment to user accounts remain intact.

NOTE: It is not recommended to assign employees using automatic employee assignment in the case of administrative user accounts. Use the task Change master data to assign employees to administrative user account for the respective user account.

Run the following tasks to assign employees automatically.

  • If employees can be assigned by user accounts during synchronization, set the parameter "TargetSystem\ADS\PersonAutoFullsync" in the Designer and select the required mode.
  • If employees can be assigned by user accounts outside synchronization, set the parameter "TargetSystem\ADS\PersonAutoDefault" in the Designer and select the required mode.
  • Specify the user accounts in the configuration parameter "TargetSystem\ADS\PersonExcludeList" which must not be assigned automatically to employees.

    Example:

    ADMINISTRATOR|GUEST|KRBTGT|TSINTERNETUSER|IUSR_.*|IWAM_.*|SUPPORT_.*|.*\$

  • Use the configuration parameter "TargetSystem\ADS\PersonAutoDisabledAccounts" to specify whether employees can be automatically assigned to disabled user accounts. User accounts do not obtain an account definition.
  • Assign an account definition to the domain. Ensure the manage level to be used is entered as default automation level.
  • Define the search criteria for employees assigned to the domain.

NOTE:

The following applies for synchronization:

  • Automatic employee assignment takes effect if user accounts are added or updated.

The following applies outside synchronization:

  • Automatic employee assignment takes effect if user accounts are added.

NOTE: Following synchronization, employees are automatically created for user accounts in the default installation. If there are no account definitions for the domain at the time of synchronization, user accounts are linked to employees. However, account definitions are not assigned. The user accounts are, therefore, in a "Linked" state.

To select user accounts through account definitions

  1. Create an account definition.
  2. Assign an account definition to the domain.
  3. Assign the account definition and manage level to the user accounts in a "linked" state.
    1. Select the category Active Directory | User accounts | Linked but not configured | <Domain>.

      - OR -

      Select the category Active Directory | Contacts | Linked but not configured | <Domain>.

    2. Select the task Assign account definition to linked accounts.

For more detailed information about assigning employees automatically, see the One Identity Manager Target System Base Module Administration Guide.

Related Topics

Editing Search Criteria for Automatic Employee Assignment

Criteria for employee assignment are defined in the domain. In this case, you specify which user account properties must match the employee’s properties such that the employee can be assigned to the user account. You can limit search criteria further by using format definitions. The search criteria are written in XML notation in the column "Search criteria for automatic employee assignment" (AccountToPersonMatchingRule) of the ADSDomain table.

Search criteria are evaluated when employees are automatically assigned to user accounts. Furthermore, you can create a suggestion list for assignments of employees to user accounts based on the search criteria and make the assignment directly.

NOTE: When the employees are assigned to user accounts on the basis of search criteria, user accounts are given the default manage level of the account definition entered in the user account's target system. You can customize user account properties depending on how the behavior of the manage level is defined.

It is not recommended to make assignment to administrative user accounts based on search criteria. Use the task Change master data to assign employees to administrative user account for the respective user account.

NOTE: One Identity Manager supplies a default mapping for employee assignment. Only carry out the following steps when you want to customize the default mapping.

To specify criteria for employee assignment

  1. Select the category Active Directory | Domains.
  2. Select the domain in the result list.
  3. Select Define search criteria for employee assignment in the task view.
  4. Specify which user account properties must match with which employee so that the employee is linked to the user account.
    Table 54: Default Search Criteria for User Accounts and Contacts
    Apply to Column on Employee Column on User Account/Contact
    Active Directory user accounts Central user account (CentralAccount) Login name (pre Win2000)(SAMAccountName)
    Active Directory contacts Central user account (CentralAccount) Identifier (Cn)
  5. Save the changes.
Direct Assignment of Employees to User Accounts Based on a Suggestion List

You can create a suggestion list in the "Assignments" view for assignments of employees to user accounts based on the search criteria. User accounts are grouped in different views for this.

Table 55: Manual Assignment View
View Description
Suggested assignments This view lists all user accounts to which One Identity Manager can assign an employee. All employees are shown who were found using the search criteria and can be assigned.
Assigned user accounts This view lists all user accounts to which an employee is assigned.
Without employee assignment This view lists all user accounts to which no employee is assigned and for which no employee was found using the search criteria.

TIP: By double-clicking on an entry in the view, you can view the user account and employee master data.

To apply search criteria to user accounts

  • Click Reload.

    All possible assignments based on the search criteria are found in the target system for all user accounts. The three views are updated.

To assign employees directly over a suggestion list

  1. Click Suggested assignments.
    1. Click Select for all user accounts to be assigned to the suggested employee. Multi-select is possible.
    2. Click Assign selected.
    3. Confirm the security prompt with Yes.

      The selected user accounts are assigned to the employees found using the search criteria.

    – OR –

  2. Click No employee assignment.
    1. Click Select employee... for the user account to which you want to assign the employee. Select an employee from the menu.
    2. Click Select for all user accounts to which you want to assign the selected employees. Multi-select is possible.
    3. Click Assign selected.
    4. Confirm the security prompt with Yes.

      This assigns the selected user accounts to the employees shown in the "Employee" column.

To remove assignments

  1. Click Assigned user accounts.
    1. Click Select for all user accounts whose employee assignment you want to remove. Multi-select is possible.
    2. Click Delete selected.
    3. Confirm the security prompt with Yes.

      The assigned employees are deleted from the selected user accounts.

For more detailed information about defining search criteria, see the One Identity Manager Target System Base Module Administration Guide.

Related Topics

Updating Employees When Active Directory User Account are Modified

Updating Employees When Active Directory User Account are Modified

Table 56: Configuration Parameters for Updating Employees
Configuration parameter Meaning

TargetSystem\ADS\PersonUpdate

This configuration parameter specifies whether employees are updated if their user accounts are changed. This configuration parameter is set to allow ongoing update of employee objects from associated user accounts.

In One Identity Manager, modifications to employee properties are forwarded to the associated user accounts and subsequently provisioned in Active Directory. In certain circumstances, it may be necessary to forward user account modifications in One Identity Manager to employee properties in Active Directory.

Example

During testing, user accounts from Active Directory are only read into One Identity Manager and employees created. User account administration (creating, modifying and deleting) should be done later through the One Identity Manager. During testing, user accounts are modified further in Active Directory, which can lead to drifts in user account properties and employee properties. Due to this, user account modifications loaded on resynchronization should be temporarily published to employees who are already created. This means data is not lost when user account administration is put into effect through the One Identity Manager.

To update employees when user accounts are modified

  • Set the configuration parameter "TargetSystem\ADS\PersonUpdate" in the Designer.

Modifications to user accounts are loaded into the One Identity Manager during synchronization. These modifications are forwarded to the associated employees through subsequent scripting and processing.

NOTE: Employees are updated due to modifications on user accounts only when the user accounts have the manage level "unmanaged" and are linked to an employee.

NOTE: Only the employee created by the modified user account is updated. The data source from which the employee was created is shown in the property Import data source. If other user accounts are assigned to the employee, changes to these user accounts do not cause the employee to be update.

User account properties are mapped to employee properties using the script VI_PersonUpdate_ADSAccount. Contact properties are mapped to employee properties using the script ADS_PersonUpdate_ADSContact. The scripts are defined as writable to make it simpler to customize the mapping.

To customize, create a copy of the respective script and start the script coding follows:

Public Overrides Function ADS_PersonUpdate_ADSAccount(ByVal UID_Account As String,OldAccountDN As String, ProcID As String)

This redefines the script and overwrites the original. The process does not have to be changed in this case.

Automatically Creating Departments and Locations based on User Account Information

Automatically Creating Departments and Locations based on User Account Information

Table 57: Configuration Parameters for Automatically Creating Departments and Locations
Configuration parameter Meaning

TargetSystem\ADS\AutoCreateDepartment

This configuration parameter specifies whether departments are automatically created when user accounts are modified or synchronized.

TargetSystem\ADS\AutoCreateLocality

This configuration parameter specifies whether locations are automatically created when user accounts are modified or synchronized.

You can create new departments and locations in the One Identity Manager based on user account department and location data. Furthermore, departments and locations are assigned to employees of the user accounts as primary department and primary location. These employees can obtain their company resources through these assignments if the One Identity Manager is configured correspondingly.

Prerequisites for using this Method

Employees must be created automatically when user accounts are added or modified. At least one of the following configuration parameters must be activated and the corresponding method implemented.

Table 58: Configuration Parameters for Automatic Employee Assignment
Configuration Parameter Effect when Set

TargetSystem\ADS\PersonAutoDefault

Automatic employee assignment for user accounts added to the database outside synchronization based on the given mode.

TargetSystem\ADS\PersonAutoFullsync

Automatic assignment of employees depends on the given mode for user accounts that are created or updated in the database by synchronization.

TargetSystem\ADS\PersonUpdate

This configuration parameter is set to allow ongoing update of employee objects from associated user accounts.

To implement this method

  • Set the configuration parameter "TargetSystem\ADS\AutoCreateDepartment" in the Designer to create departments from user account data.
  • Set the configuration parameter "TargetSystem\ADS\AutoCreateLocality" in the Designer to create locations from user account data.
Related Topics
Related Documents