Grouper TrainingDevelopers and Architects

Client - Part 2

Chris HyzerInternet2

University of Pennsylvania

This work licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License.

2

Contents

• Introduction• Configuration (part 1)• Command line (part 1)• Documentation• Debugging• Using from a Java program• Use as a reference implementation• LDAP client (part 3)• XMPP message consumer (part 3)

3

Introduction to Grouper Client

4

Documentation

• Usage: java -jar grouperClient.jar• Grouper client wiki• Grouper WS documentation and training• Shows operations

5

Documentation (continued)

6

Debugging

• --debug=true will• Log more information• Show request/response formatted• Credentials are cleansed• Shows full error code / message / etc

7

Debugging (continued)

8

Debugging (continued)

9

Use from java program

• Add grouperClient.jar to the library path (e.g. WEB-INF/lib for web applications)

• Add grouper.client.properties to the classpath• Package:

edu.internet2.middleware.grouperClient.api• Java classes start Gc• Method chaining• Throws exception on error• Command-line API uses the Java API

10

Use from java program (continued)

• Example add member:

11

Use as a reference implementation

• --debug=true shows XML request/response• The java is open source, could be cloned in

another programming language• This is not a trivial effort• Need to keep it up to date with new releases

• In Grouper WS the class GrouperClientWsTest has 34k+ lines of tests of the Grouper Client

12

Quiz

• Click on the quiz link in the video description to reinforce your knowledge of this topic

Thanks!

Further information:

•Infosheets, mailing lists, wiki, downloads, etc.:www.internet2.edu/grouper

•Grouper demo server:grouperdemo.internet2.edu/

•Grouper Online Training Home:spaces.internet2.edu/x/IIGfAQ

This work licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License. 13