Download Introduction to Grouper Client

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.
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)
2
Introduction to Grouper Client
3
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
4
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
5
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)
6
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"
7
Command line (continued)
8
Command line (continued)
9
Command line (continued)
10
Quiz
• Click on the quiz link in the video
description to reinforce your knowledge of
this topic
11
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