Chat now with support
Chat with Support

Identity Manager 9.2.1 - Administration Guide for Connecting to SharePoint

Managing SharePoint environments Setting up SharePoint farm synchronization Basic data for managing a SharePoint environment SharePoint farms SharePoint web applications SharePoint site collections and sites SharePoint user accounts SharePoint roles and groups
SharePoint groups SharePoint roles and permission levels
Permissions for SharePoint web applications Reports about SharePoint objects Configuration parameters for managing a SharePoint environment Default project template for SharePoint

Creating a formatting rule for IT operating data

An account definition specifies which rules are used to form the IT operating data and which default values will be used if no IT operating data can be found through the identity's primary roles.

The following IT operating data is used in the One Identity Manager default configuration for automatically creating user accounts for an identity in the target system and modifying them.

  • SharePoint authentication mode

  • SharePoint Online authentication mode

  • Groups can be inherited

  • Roles can be inherited

  • Identity

  • Privileged user account.

To create a mapping rule for IT operating data

  1. In the Manager, select the SharePoint > Basic configuration data > Account definitions > Account definitions category.

  2. Select an account definition in the result list.

  3. Select the Edit IT operating data mapping task.

  4. Click Add and enter the following information:

    • Column: User account property for which the value is set. In the menu, you can select the columns that use the TSB_ITDataFromOrg script in their template. For more information about this, see the One Identity Manager Target System Base Module Administration Guide.

    • Source: Specifies which roles to use in order to find the user account properties. You have the following options:

      • Primary department

      • Primary location

      • Primary cost center

      • Primary business roles

        NOTE: The business role can only be used if the Business Roles Module is available.

      • Empty

        If you select a role, you must specify a default value and set the Always use default value option.

    • Default value: Default value of the property for an identity's user account if the value is not determined dynamically from the IT operating data.

    • Always use default value: Specifies whether the user account property is always set with the default value. IT operating data is not determined dynamically from a role.

    • Notify when applying the default: Specifies whether an email is sent to a specific mailbox when the default value is used. The Identity - new user account with default properties created mail template is used.

      To change the mail template, in the Designer, adjust the TargetSystem | SharePoint | Accounts | MailTemplateDefaultValues configuration parameter.

  5. Save the changes.

Collecting IT operating data

To create user accounts for an identity with the Full managed manage level, you need to know which IT operating data is required. The operating data required for each specific target system is defined with its business roles, departments, locations, or cost centers. An identity is assigned a primary business role, primary location, primary department, or primary cost center. The necessary IT operating data is ascertained from these assignments and used in creating the user accounts. Default values are used if valid IT operating data cannot be found over the primary roles.

You can also specify IT operating data directly for a specific account definition.

Example:

In the IT operating data mapping rule for the account definitions A and B, specify the Department property in order to determine the valid IT operating data.

This IT operating data is used for standard user accounts. In addition, for department A, specify the effective IT operating data of account definition B. This IT operating data is used for administrative user accounts.

To define IT operating data

  1. In the Manager, select the role in the Organizations or Business roles category.

  2. Select the Edit IT operating data task.

  3. Click Add and enter the following data.

    • Effects on: Specify an IT operating data application scope. The IT operating data can be used for a target system or a defined account definition.

      To specify an application scope

      1. Click next to the field.

      2. Under Table, select the table that maps the target system for select the TSBAccountDef table or an account definition.

      3. Select the specific target system or account definition under Effects on.

      4. Click OK.

    • Column: Select the user account property for which the value is set.

      In the menu, you can select the columns that use the TSB_ITDataFromOrg script in their template. For more information about this, see the One Identity Manager Target System Base Module Administration Guide.

    • Value: Enter a fixed value to assign to the user account's property.

  4. Save the changes.

Modify IT operating data

If IT operating data changes, you must transfer the changes to the existing user accounts. To do this, templates must be rerun on the affected columns. Before you can run the templates, you can check what effect a change to the IT operating data has on the existing user accounts. You can decide whether the change is transferred to the One Identity Manager database in the case of each affected column in each affected database.

Prerequisites
  • The IT operating data of a department, a cost center, a business role, or a location have been changed.

    - OR -

  • The default values in the IT operating data template were modified for an account definition.

NOTE: If the assignment of an identity to a primary department, cost center, to a primary business role or to a primary location changes, the templates are automatically run.

To run the template

  1. In the Manager, select the SharePoint > Basic configuration data > Account definitions > Account definitions category.

  2. Select an account definition in the result list.

  3. Select the Run templates task.

    This displays a list of all user accounts that were created with the selected account definition and whose properties were changed by modifying the IT operating data. That means:

    • Old value: Value of the object property before changing the IT operating data.

    • New value: Value of the object property after changing the IT operating data.

    • Selection: Specifies whether the new value is copied to the user account.

  4. Mark all the object properties in the selection column that will be given the new value.

  5. Click Apply.

    The templates are applied to all selected user accounts and properties.

Assigning account definitions to identities

Account definitions are assigned to company identities.

Indirect assignment is the default method for assigning account definitions to identities. Account definitions are assigned to departments, cost centers, locations, or roles. The identities are categorized into these departments, cost centers, locations, or roles depending on their function in the company and thus obtain their account definitions. To react quickly to special requests, you can assign individual account definitions directly to identities.

You can automatically assign special account definitions to all company identities. It is possible to assign account definitions to the IT Shop as requestable products. Department managers can then request user accounts from the Web Portal for their staff. It is also possible to add account definitions to system roles. These system roles can be assigned to identities through hierarchical roles or added directly to the IT Shop as products.

In the One Identity Manager default installation, the processes are checked at the start to see if the identity already has a user account in the target system that has an account definition. If no user account exists, a new user account is created with the account definition’s default manage level.

NOTE: If a user account already exists and is disabled, then it is re-enabled. In this case, you must change the user account manage level afterward.

NOTE: As long as an account definition for an identity is valid, the identity retains the user account that was created by it. If the account definition assignment is removed, the user account that was created from this account definition, is deleted. User accounts marked as Outstanding are only deleted if the QER | Person | User | DeleteOptions | DeleteOutstanding configuration parameter is set.

Prerequisites for indirect assignment of account definitions to identities
  • Assignment of identities and account definitions is permitted for role classes (departments, cost centers, locations, or business roles).

For more information about preparing role classes to be assigned, see the One Identity Manager Identity Management Base Module Administration Guide.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating