1. Background

     The PicketLink Console Project aims to provide a easy way to manage all PicketLink configurations using an AS7 subsystem. Basically, it is a GWT application based on the AS7 Console's architecture and principles providing UIs to manage the PicketLink AS7 Subsystem.

     This project is strongly dependent on the PicketLink Subsystem project, which defines the available configurations that can be used and manipulated. While the subsystem defines the model, the console is a user friendly interface to access it and manage the supported configurations.

     To understand more about the PicketLink AS 7 Subsystem and which configurations are supported, access this thread https://community.jboss.org/thread/196424.

     This project is in development stage, fell free to contribute with ideas and suggestions about the features that should be supported.

2. Non-functional Requirements

     This project has some important non-functional requirements to be considered:

• Be based on the AS7 Console architecture and Ballroom Project:
  • overall layout and structure;
  • logging, notifications, url handling, etc;
  • re-use widgets. most of them build on core GWT API;
  • a .org and product look&feel;
• Aim for a conceptual model that represents the semantics/intentions of the PicketLink's domain model (SAML, WS-Trust, XACML, etc);
• Only interact with the management infrastructure via a subsystem;

      For more information about the requirements above, see:

• AS7 Extension Mechanism: https://github.com/heiko-braun/as7-console/tree/master/example-extension;

• AS 7 Management Console Designs: https://community.jboss.org/wiki/ManagementConsoleDesign;

• AS7 Console Widgets: https://community.jboss.org/wiki/CurrentAS7ConsoleWidgetSet;
• Ballroom Project: https://community.jboss.org/wiki/BallroomLookFeel;
• Heiko Braun's Blog: http://relative-order.blogspot.com/2011/03/contributing-to-jboss-7-management.html;

3. Configure a JBoss AS 7.1.1.Final installation with the PicketLink Subsystem and Console

     First, download and install the JBoss AS 7.1.1.Final.

     Download the file http://dl.dropbox.com/u/67480493/as7-subsystem-config.tar.gz and extract it into your JBoss AS 7.1.1.Final installation root directory.

     To test the installation, try to access the sales application at http://localhost:8080/sales. You should be redirect to the IDP login page.

     To log in, use this credentials:

• Username: admin     
• Password: admin123

     Now the subsystem and the console are installed. The console can be accessed at http://localhost:9990/console.

     To access the PicketLink configuration page do the following (Please, use only the Firefox to access the console):

• Take a look first at https://docs.jboss.org/author/display/PLINK/Management+Console.
• Click in Profile (upper right corner);
• Look at the menu in the left. You will see a item called PicketLink, click it;
• Expand the PicketLink menu item and click in Federation. you should see a page like this one:

4. Documentation

     The documentation is available at https://docs.jboss.org/author/display/PLINK/Management+Console.

5. Source Code

     The source code and instructions about how to build and run the console are available at https://github.com/picketlink/picketlink-console.

6. Conclusions

     If you have any doubt or problem, please leave a comment.

     We are looking for new ideas and suggestions. Please feel free to contribute.

     You can use our freenode to make your suggestions https://community.jboss.org/thread/153911.

     We are working to support more configurations.