Upload
meryl-harris
View
219
Download
2
Tags:
Embed Size (px)
Citation preview
Grouper TrainingDevelopers 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
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
Introduction to Grouper Client
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
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
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
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
Command line (continued)
9
Command line (continued)
10
Command line (continued)
11
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. 12