The Confluence Group Expansion accepts group expansion request containing a username and provides a list of groups to which the user belongs in a group expansion result.

This component uses the SOAP/XML API from Confluence to fetch user group information. Multiple calls are made - one for the incoming user and one for the groups from Confluence. All group information is cached, so further group expansion requests won't make unnecessary calls to the Confluence server.

Additionally, if LDAP Group Expansion was performed before this component, Confluence Group Expansion will attempt to fetch group information for any LDAP groups. LDAP (or Active Directory) groups can be stored in Confluence as regular groups.

This component is based on the Simple Group Expander

Atlassian Confluence Group Expansion (Aspire 2)
Factory Name com.searchtechnologies.aspire:aspire-confluence-scanner
subType groupExpansion
Inputs A Job containing a group expansion request
Outputs A Job containing a group expansion result

Configuration

ElementTypeDefaultDescription
groupPrefixSeparatorstring
Prefix used to separate users and groups on ACL's file.
defaultUsernamestring
Username with admin privileges to access all Confluence content.
defaultPasswordstring
Password.
confluencePublicAclstring
ACL that will be used to indicate that a page have public access.
defaultConfluenceUrlstring
Confluence instance to connect with.



Example Configurations

<!--Group Expansion -->
<component name="GroupExpansionScheduler" subType="default" factoryName="aspire-scheduler" enable="${useGE}">
  <debug>true</debug>
  <schedules>
    <schedule name="GECache" enabled="true">
      <cron>0 0 * * * ?</cron>
      <event>onGECache</event>
      <job>
      <![CDATA[
        <doc actionProperties="cacheGroups">
          <connectorSource>
            <debug>${debug}</debug>
            <groupPrefixSeparator>|</groupPrefixSeparator>
            <defaultUsername>admin</defaultUsername>
            <defaultPassword>encrypted:B39D6E9181FBBEBDF7C880CBEF98F</defaultPassword>
            <confluencePublicAcl>confluence-public</confluencePublicAcl>
            <defaultConfluenceUrl>http://myConfluenceServer:8090/</defaultConfluenceUrl>
          </connectorSource>
	  <displayName>Confluence</displayName>
        </doc>
      ]]>
      </job>
    </schedule>
  </schedules>
  <branches>
    <branch event="onGECache" pipelineManager="Main" />
  </branches>
</component>



<component name="GroupExpansionPipelineManager" subType="pipeline" factoryName="aspire-application">
  <debug>true</debug>
  <gatherStatistics>true</gatherStatistics>
  <pipelines>
    <pipeline name="group-expansion-pipeline" default="true">
      <stages>
        <stage component="IncomingJobDebug" />
        <stage component="ConfluenceGroupExpansion" />
      </stages>
    </pipeline>
  </pipelines>
  <components>
    <component name="IncomingJobDebug" subType="jobLogger"
      factoryName="aspire-tools">
      <debug>true</debug>
      <logFile>log/confluence/GroupExpansionPipelineManager/incoming.jobs</logFile>
    </component>
    <component name="ConfluenceGroupExpansion" subType="expansionClient" factoryName="aspire-simple-group-expander">
      <debug>true</debug>
      <server>../Main/Scanner</server>
    </component>
  </components>
</component>


  • No labels