1. 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. 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. 3 Introduction to Grouper Client

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

5. 5 Documentation (continued)

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

7. 7 Debugging (continued)

8. 8

9. 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. 10 Use from java program (continued) Example add member:

11. 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. 12 Quiz Click on the quiz link in the video description to reinforce your knowledge of this topic

13. Thanks! Further information: Infosheets, mailing lists, wiki, downloads, etc.: www.internet2.edu/grouper www.internet2.edu/grouper 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