1. Grouper Training Developers and Architects Client - Part 1 Chris Hyzer Internet2 University of Pennsylvania This work licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License.

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

3. 3 Introduction to Grouper Client

4. 4 Introduction Grouper client is: One jar (no dependencies), WS Rest-like XML Need Java6, any OS (e.g. Win, Mac, *nix) grouper.client.properties config file classpath or grouperClient.jar directory grouper.client.usage.txt for command line usage on classpath or grouperClient.jar directory Several libraries in grouperClient.jar, but edited classpath, no conflicts with other jars Backwards compatible As WS server is upgraded, it will still work

5. 5 Configuration grouper.client.properties At a minimum configure: WS end-point URL WS authentication LDAP end-point URL (if needed) LDAP authentication (if needed) Could also configure: Failover, discovery, password encryption Logging, LDAP operations, timeout, XMPP

6. 6 Command line Ad hoc Non-java applications Scheduled tasks See example XML requests/responses Every feature in the Java API is exposed through command line options Can save results to file Can format output as needed (e.g. list of netIds) java -jar grouperClient.jar (gives usage)

7. 7 Command line (continued) Any missing argument or extra arguments cause an error Arguments in form --argName=argValue Put argValue in double quotes if spaces or special chars: --argName="some value"

8. 8 Command line (continued)

9. 9

10. 10 Command line (continued)

11. 11 Quiz Click on the quiz link in the video description to reinforce your knowledge of this topic

12. 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. 12