Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
72:ldap_optional_attributes [2018/07/16 13:54] – [Optional Attributes] bkkr | 72:ldap_optional_attributes [2024/02/15 00:00] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 34: | Line 34: | ||
The referrals attribute can be used to configure the handling of LDAP referrals. Possible behavior and values are “follow“ or “ignore“. By default, Stages will follow referrals. | The referrals attribute can be used to configure the handling of LDAP referrals. Possible behavior and values are “follow“ or “ignore“. By default, Stages will follow referrals. | ||
+ | |||
+ | === The ignorePartialResultExeption Attribute === | ||
+ | |||
+ | When enabled, this attribute causes the PartialResultException to be ignored if the referrals attribute is set to " | ||
+ | The ignorePartialResultException attribute is configured on the ldap-provider. | ||
=== The searchFilter Attribute === | === The searchFilter Attribute === | ||
Line 45: | Line 50: | ||
|(sn=sm*)|All entries with a surname that starts with " | |(sn=sm*)|All entries with a surname that starts with " | ||
|(& | |(& | ||
- | |(& | + | |(& |
+ | ( |(sn=smith)(sn=wright)))|All entries that are users having surname set to " | ||
- | **NOTE**: In the <font inherit/ | + | **NOTE**: In the |
+ | | ||
- | There is a special memberOf keyword available on many LDAP directory servers. In the case of Microsoft Active Directory, groups are represented via entries of object class “group“ by default. The distinguished names of the group members are set in the member attributes of the group entry. On the other hand, the distinguished name of every group a user is part of is automatically set in a <font inherit/ | + | There is a special memberOf keyword available on many LDAP directory servers. In the case of Microsoft Active Directory, groups are represented via entries of object class “group“ by default. The distinguished names of the group members are set in the member attributes of the group entry. On the other hand, the distinguished name of every group a user is part of is automatically set in a |
+ | memberOf | ||
The following search filter example shows how to filter users according to a certain group membership using the memberOf attribute: | The following search filter example shows how to filter users according to a certain group membership using the memberOf attribute: | ||
- | '' | + | '' |
If the memberOf attribute is not available on your LDAP directory server, it is possible to retrieve the members of a certain group by querying the member attribute of a group entry. | If the memberOf attribute is not available on your LDAP directory server, it is possible to retrieve the members of a certain group by querying the member attribute of a group entry. | ||
- | The following search filter example shows how to query the users of a group without using the <font inherit/ | + | The following search filter example shows how to query the users of a group without using the |
+ | | ||
+ | |||
+ | '' | ||
+ | |||
+ | The filter specifies that the distinguished name of the (group) entry has to be | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | A complete example for retrieving group members without using the | ||
+ | memberOf | ||
+ | |||
+ | '' | ||
+ | groupMemberAttribute=" | ||
+ | |||
+ | === The ondemandFilter Attribute === | ||
+ | |||
+ | This attribute is required for user auto-creation and/or on-demand synchronization mode. It allows the Stages system to query the LDAP server for specific users by their Stages login name. The attribute | ||
+ | |||
+ | The ondemandFilter must contain the placeholder character “%” that will be replaced by the username when queries on the LDAP repository are made. | ||
+ | |||
+ | Example: '' | ||
+ | === The matchUsersMode Attribute === | ||
+ | |||
+ | The matchUserMode attribute specifies how LDAP user entries are matched to Stages users when no mapping can be performed using the special _KEY attribute. | ||
+ | |||
+ | Possible values for the matchUserMode attribute are: | ||
+ | |||
+ | * username | ||
+ | * fullname | ||
+ | |||
+ | |||
+ | If no explicit value is set for that attribute then the username will be used for that purpose. | ||
+ | |||
+ | === The adoptUsers attribute === | ||
+ | |||
+ | Stages distinguishes between local user accounts and LDAP user accounts in its user database. The adoptUsers attribute can be used to convert a local user account to an LDAP account if the user can be identified via the matchUserMode attribute. To enable the user account conversion the adoptUser attribute has to be set to “true“. The conversion is disabled by default. | ||
- | ''< | + | === The generateDN attribute |
- | The filter specifies that the distinguished name of the (group) entry has to be <font inherit/ | + | If the directory server does not provide a distinguished name attribute |
- | A complete example for retrieving group members without using the <font inherit/ | + | === The defaultLicenseType |
- | ''< | + | The defaultLicenseType attribute specifies which license type shall be granted to a newly created LDAP user. Possible values for that attribute are: |
- | groupMemberAttribute=" | + | |
- | === | + | |
+ | * Stages Process Modeler (named): **PersonalQM** | ||
+ | * Stages Project Manager (floating:) **FloatingPM** | ||
+ | * Stages Project Manager (named): **PM** | ||
+ | * Stages Process Participant (floating): **FloatingDev** | ||
+ | * Stages Process Participant (named): **Dev** | ||
+ | * Stages Process Contributor (floating): **FloatingADev** | ||
+ | * Stages Process Contributor (named): **ADev** | ||
+ | * Stages Process Viewer (floating only): **AuthPsReader** | ||
+ | * None: **none** | ||
- | \\ | + | The specified license type is only assigned if the corresponding license limit (named licenses only) for that type is not reached. If the defaultLicenseType attribute is not specified then the value of the configuration property license.types.initialType is used for that purpose. The default value of this property is " |