Resource wizard: Association type configuration

Last modified 28 Nov 2025 13:47 +01:00
Since 4.9
This functionality is available since version 4.9.
Table of Contents

This page describes how to configure association types in the resource wizard.

Introduction

Associations enable you to configure the resource for object type relations. Typically, this is used to configure how account/group membership is defined and processed.

For more details, refer to the following pages:

Configure association types

The configuration of association types is done in the resource wizard during the resource creation or modification.

  1. Access the wizard:

    • When creating a new resource, click Configure Association Types.

    • When modifying an existing resource, click:

      • Schema handling > Association types, or

      • Accounts > Configure > Create association.

        This shows you a table that lists association types.

        association type table
        Figure 1. Table listing association types

  2. Click Add association type to start configuring a new association type.

  3. Select an association type, which is predefined by capabilities or the connector, by clicking on it.

    100%
    Figure 2. Select an association type

  4. After selecting the association, you will see a four-step wizard. In the first step, configure the basic settings:

    • Name and Display name are used for naming purposes.

    • Description enables you to enter a short description.

    • Lifecycle state enables you to define the lifecycle state, e.g., Proposed for a simulation of the association configuration.

      100%
      Figure 3. Basic configuration

  5. Click Next: Subjects to continue in the association type definition wizard.

  6. In the second step, select the subject (i.e., an object type of the resource) of the association. If there is only one option, it will be preselected and you can proceed to the next step.

    100%
    Figure 4. Select the subject for the association

  7. Click Next: Objects to continue in the association type definition wizard.

  8. Select the object (i.e., an object type of the resource) of the association.

    100%
    Figure 5. Select the object for the association

  9. Click Next: Data for association to continue in the association type definition wizard.

  10. Specify the reference attribute to define the data corresponding to the association, and the association tolerance:

    • The Reference attribute is predefined by default but you can customize it. For example, instead of group, you can use ldapGroup. MidPoint automatically resolves duplicate reference attribute names: if you defined multiple association types, the reference attributes would become group, group1, etc. by default.

    • tolerant enables you to specify how midPoint tolerates associations (membership) with objects other than those associated via midPoint. The default value Undefined is the same as True and makes midPoint keep the membership even if not defined via midPoint. False removes such associations when the resource object is reprocessed, e.g., during reconciliation.

      When in doubt, use Undefined or True.
      Object Marks can redefine association (membership) tolerance.
      100%
      Figure 6. Specify the data for association

  11. Click Save settings to save the association type configuration.

  12. After creating the new association type, you will see a page with the following options:

    • Basic Attributes tile represents a two-step wizard that you have already seen during the creation of the association type, enabling you to access the first and the last step without having to select the subject and object of the association.

    • Subject tile opens the Subject wizard.

    • Object tile returns back to the object selection.

      100%
      Figure 7. Association wizard

Configuration of Resource Wizard Panels

Some wizard panels are configurable. See Wizard panels for more information.

How to Use Lifecycle States

You can use different lifecycle states for resources, object types, attributes, mappings, synchronization situations, and other aspects of resource configuration. You can use the lifecycle state property for simulations. Resources are created in the Proposed lifecycle state by default, and don’t work in normal deployment before switching the state to Active.

You can use the Proposed lifecycle state to test (simulate) the configuration without causing any damage to your target system data. When the simulation results are satisfactory, you can switch the lifecycle state to Active.

You can set different lifecycle states for various configuration items, which lets you put specific parts of configuration to production incrementally.

For example, after you switch your resource to the Active lifecycle state, you can add new mappings in Proposed lifecycle state first. You can simulate the new mapping safely and switch it to Active when it’s ready.

See also:

Limitations

Resource wizard has several limitations, such as:

MidPoint resource wizard can’t show or edit these features but tolerates them and keeps them untouched if you configure them in XML.

Was this page helpful?
YES NO
Thanks for your feedback