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.

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