Grouper

Grouper Toolkit enables project managers, departments, institutions and end users to create and manage institutional and personal groups.

Assuming you have a working install of Grouper below are the steps to configure uPortal to use your Grouper instance. Please refer to the Grouper Wiki for the technical information, installation, configuration, and case studies of the Grouper software.

Step 1: Edit grouper.client.properties

  • Open for editing: uportal-war/src/main/resource/grouper.client.properties
  • To perform the most basic configuration, edit the grouperClient.webSerice.url, grouperClient.webSerice.login, and grouperClient.webSerice.password properties to match your Grouper server.

    ########################################
    ## Web service Connection settings
    ########################################
    # url of web service, should include everything up to the first resource to access
    # e.g. http://groups.school.edu:8090/grouper-ws/servicesRest
    # e.g. https://groups.school.edu/grouper-ws/servicesRest
    grouperClient.webService.url = http://localhost:8180/grouper-ws/servicesRest/
    # kerberos principal used to connect to web service
    grouperClient.webService.login = GrouperSystem
    # password for shared secret authentication to web service
    # or you can put a filename with an encrypted password
    grouperClient.webService.password = 123

Step 2: Edit compositeGroupServices.xml

  • Open for editing: uportal-war/src/main/resource/properties/groups/compositeGroupServices.xml
  • Uncomment the grouper service component

     <service>
        <name>grouper</name>
        <service_factory>org.jasig.portal.groups.ReferenceIndividualGroupServiceFactory</service_factory>
        <entity_store_factory>org.jasig.portal.groups.grouper.GrouperEntityStoreFactory</entity_store_factory>
        <group_store_factory>org.jasig.portal.groups.grouper.GrouperEntityGroupStoreFactory</group_store_factory>
        <entity_searcher_factory>org.jasig.portal.groups.grouper.GrouperEntitySearcherFactory</entity_searcher_factory>
        <internally_managed>false</internally_managed>
        <caching_enabled>true</caching_enabled>
      </service>

Step 3: Rebuild/Redeploy uPortal

ant clean deploy-war

Step 4: Restart Tomcat

Restart your tomcat server.

 

Additional References

  •  Grouper Wiki - This is the primary documentation for Grouper, and is a community-maintained repository consisting of technical information you need to know prior to installing Grouper, installation/configuration guides, and case studies contributed by the Grouper community

Having problems with these instructions?

Please send us feedback at uportal-user@lists.ja-sig.org

Add Feedback content box here.....