![Page 1: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/1.jpg)
Grouper TrainingDevelopers and Architects
Client - Part 1
Chris HyzerInternet2
University of Pennsylvania
This work licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License.
![Page 2: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/2.jpg)
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)
![Page 3: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/3.jpg)
3
Introduction to Grouper Client
![Page 4: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/4.jpg)
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
![Page 5: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/5.jpg)
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
![Page 6: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/6.jpg)
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)
![Page 7: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/7.jpg)
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"
![Page 8: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/8.jpg)
8
Command line (continued)
![Page 9: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/9.jpg)
9
Command line (continued)
![Page 10: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/10.jpg)
10
Command line (continued)
![Page 11: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/11.jpg)
11
Quiz
• Click on the quiz link in the video description to reinforce your knowledge of this topic
![Page 12: Grouper Training Developers and Architects Client - Part 1](https://reader035.vdocuments.net/reader035/viewer/2022081502/5681610b550346895dd05ad8/html5/thumbnails/12.jpg)
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