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.
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)
2
Introduction to Grouper Client
3
Documentation
• Usage: java -jar grouperClient.jar
• Grouper client wiki
• Grouper WS documentation and training
• Shows operations
4
Documentation (continued)
5
Debugging
• --debug=true will
•
•
•
•
Log more information
Show request/response formatted
Credentials are cleansed
Shows full error code / message / etc
6
Debugging (continued)
7
Debugging (continued)
8
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
9
Use from java program (continued)
• Example add member:
10
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
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
•
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.
13