The Group Expansion Client component is configured as a pipeline stage, and is responsible for receiving a group expansion request and querying a group expansion server (such as a connector or LDAP Cache) and taking the returned groups and constructing a group expansion result message.

This component is typically used inside connectors that perform group expansion, and is sent the group expansion request by the Group Expansion Router in the Group Expansion Service.

However, this generic client can connect to any other Aspire component that implements the GroupExpansionServer interface.

Group Expansion Client
Factory Namecom.searchtechnologies.aspire:aspire-simple-group-expander
subTypeexpansionClient
InputsA Job containing a group expansion request
OutputsA Job containing a group expansion result

Configuration

The following options are supported in the Group Expansion Client

ElementTypeDefaultDescription
serverString The path to the group expansion server (for example /ConnectorName/Main/Scanner)
domain/request/@stripbooleanfalseIf true, any domain on the user given in the group expansion request will be removed before the request is made to the server
domain/request/@addString If given, the given domain will be added to the user given in the group expansion request (overwriting any existing domain) before the request is made to the server
domain/response/@stripbooleanfalseIf true, any domain on the groups returned from the group expansion server will be removed before the group expansion request is returned
domain/response/@addString If given, the given domain will be added to the groups returned from the group expansion server will be removed before the group expansion request is returned
staticGroups/group (multiples allowed)String Any groups added here will be added (exactly as specified here) to the group expansion request before it is returned
addPublicbooleanfalseIf true, the generic public:all group will be added to the group expansion request before it is returned
aclPrefixString If specified, the given prefix will be added to all groups returned from the group expansion server

Example Configuration

    <component name="LDAPExpansionClient" subType="expansionClient" factoryName="aspire-simple-group-expander">
    <debug>true</debug>
    <server>/LDAPService/Main/LdapCache</server>
    <domain>
      <request add="someQueryDomain"/>
      <response add="someResponseDomain"/>
    </domain>
  </component>
 
  • No labels