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.