150 likes | 261 Views
Grouper Training - Admin - WS - Part 1. Chris Hyzer Internet2 University of Pennsylvania. This work licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License. Contents. Introduction Download Install Upgrade Authentication WS-* security App servers. Introduction.
E N D
Grouper Training - Admin - WS - Part 1 Chris Hyzer Internet2 University of Pennsylvania This work licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License.
Contents Introduction Download Install Upgrade Authentication WS-* security App servers
Download • Grouper download sitehttp://www.internet2.edu/grouper/software.html • Via Grouper Installer • Unzip 4
Install • Grouper Installer can install it • Manually you need Java6, ant, and a servlet container • Edit grouper-ws/build.propertiesgrouper.dir=C:/mchyzer/grouper/v2_1/grouper • Run "ant dist" 5
Upgrade • If you are upgrading an existing WS install • Download the new version • Merge in any configuration changes to new version • Point to an updated copy of Grouper API • Build, deploy 6
Authentication • Ships with servlet container authn • Configure user/pass in tomcat-users.xml (for example if using tomcat) • If you need other authn, disable this by editing WEB-INF/web.xml • Remove the security-constraint, login-config, and security-role sections • Build again 7
Authentication (continued) • You could use web server authn • There are other authns built in • To use kerberos user/pass configure grouper-ws/conf/grouper-ws.properties • Note, user/pass is in HTTP basic auth • Set ws.security.non-rampart.authentication.class 8
WS-* security • You can use WS-* security with SOAP • Set this in the build.properties#if we should build the rampart war, or the regularwebapp.authentication.use.rampart=true • Build again • In the build, WEB-INF/services you see either normal aars or wssec aars renamed as "ondeck" • Note: you cannot run WS-* and non WS-* in the same warfile, you could deploy both though 9
WS-* security (continued) • Normal aars 10
WS-* security (continued) • WS-* aars 11
App servers • Grouper WS runs in Servlet 2.5 container • Generally institutions use Tomcat 6 • Takegrouper-ws\build\dist\grouper-ws.war • Install in servlet container • In Tomcat, e.g. drop it in the webapps dir 12
Test the deployment • Run the grouper client (see the Grouper Client training for details) • Hit the status servlethttp://localhost:8090/grouper-ws/status?diagnosticType=sources 13
Test the deployment (continued) • Hit a REST HTTP params service • Note: URL encode the group namegrouper-ws/servicesRest/xml/v2_1_000/groups/etc%3Asysadmingroup/members 14
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.