This project is an extension for JBoss Enterprise Application Server that enables PicketLink for deployments.

The extension provides a set of services and deployment behaviours for most of the PicketLink projects, such as:

• PicketLink IDM, for Identity Management related services
• PicketLink Core, for Authentication and Authorization services for CDI applications

• PicketLink Federation, for Single Sign-On, SAML and WS-Trust services for JEE applications

The extension is currently designed and implemented considering the following requirements:

• Java 1.6

• JBoss EAP 6.1 (AS 7.2.0.Final-SNAPSHOT)

• Maven 3.0.3 or newer, to build and install the extension

  Important note The extension requires a specific organization for the PicketLink libraries inside the JBoss EAP modules directory. While the application server is not update, you must configure your installation in order to use the extension. See the JBoss Application Server Configuration section for more details.

You can build this project in several ways, depending of your objectives.

The simplest way to build this project and to generate the artifacts is executing the following command:

mvn clean install

In this case, only the unit tests will be executed.

If you want to perform a full build, running also the integration tests you need to execute the following command:

mvn -Pintegration-tests clean install

The most simple and fast way to get the subsystem up and running is using the JBoss Application Server installation used during the integration tests. After executing the following command:

mvn -Pintegration-tests clean install

Navigate to the target/integration-tests/containers/jboss-eap-6.1/ directory and use this installation to deploy your applications.

You can use the PicketLink Installer. Follow the instructions there.

Important Note: Only versions 2.5.2.Final and later support the subsystem installation on EAP.

Change your standalone.xml to add an extension for the PicketLink module:

      <extensions>
                ...
              <extension module="org.picketlink.as.extension"/>
      </extensions>

Now, you can configure the PicketLink Subsystem using the subsystem's domain model:

<profile>
    <subsystem xmlns="urn:jboss:picketlink:1.0">
    	
    	<!-- Use the domain model schema to configure the subsystem -->
    	
    </subsystem>

You can get some examples about how to configure the PicketLink Subsystem from the following file:

https://github.com/picketlink/picketlink-as-subsystem/blob/master/src/test/resources/picketlink-subsystem.xml

Please, follow the documentation at http://docs.jboss.org/picketlink/2/latest/reference/html/ch10.html.

Please, follow the documentation at https://docs.jboss.org/author/display/PLINK/PicketLink+AS7+Subsystem.

First, import the project into your IDE.

Follow the instructions at [Using a Pre-configured JBoss AS Installation] (#) to get a pre-configured JBoss AS installation with all configuration required to run the integration tests.

Go to the Maven configurations for your Eclipse project and activate the following profile:

arquillian-remote

Now, start your server and run one of the integration tests.