Grouper Training Developers and Architects Client - Part 2 Chris Hyzer Internet2 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

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.: Grouper demo server: grouperdemo.internet2.edu/ 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