README.md

JAAS LoginModule for Crowd

---

This repository contains a JAAS LoginModule for Jetty which integrates with Atlassian Crowd. The need is to run Rundeck against Crowd. But it should be usable for any other application compatible with JAAS/Jetty

Please also have a look in the other branches for a closer match to the Rundeck version you use.

1. Clone the source

   $ git clone -v --progress https://github.com/flopma/crowd-jaas.git /your/working/folder

2. Build the jar from the source

   cd jetty/jaas-jetty-crowd
   mvn package
   

3. Uncompress the zip target/jaas-jetty-crowd--jar-with-dependencies-packed.zip
4. Setup JAAS LoginModule to contain the following settings

   be.greenhand.jaas.jetty.CrowdLoginModule sufficient
   	applicationName="your jetty app"
   	applicationPassword="a password"
   	crowdServerUrl="https://example.com/crowd/"
   	httpMaxConnections="20"
   	httpTimeout="5000";
   

   If your web app needs to connect to Crowd through a proxy, use the following settings

   be.greenhand.jaas.jetty.CrowdLoginModule sufficient
   	applicationName="your jetty app"
   	applicationPassword="a password"
   	crowdServerUrl="https://example.com/crowd/"
   	httpMaxConnections="20"
   	httpTimeout="5000"
   	httpProxyHost="yourproxyhostname"
   	httpProxyPort="proxyportnumber"
   	httpProxyUsername="proxyusername - if authentication required"
   	httpProxyPassword="proxypassword - if authentication required";
   

5. Setup Crowd to accept requests from this application
6. Setup Crowd and your appplication to allow authorization to happen (Crowd groups / Servlet Security Roles) - this is application specific