Chapter 28. Login Modules in a Java Client

This chapter describes how to configure an environment to use login modules with Java clients, and provides an example of this.

28.1. Configuring an Environment to Use Login Modules with Java Clients

The login modules for use by clients are defined in the $JONAS_ROOT/conf/jaas.config file. For example:

jaasclient {
    // Login Module to use for the example jaasclient.

    //First, use a LoginModule for the authentication
    // Use the resource memrlm_1
    org.objectweb.jonas.security.auth.spi.JResourceLoginModule required
    resourceName="memrlm_1"
        ;

    // Use the login module to propagate security to the JOnAS server
    // globalCtx is set to true in order to set the security context
    // for all the threads of the client container instead of only
    // on the current thread.
    // Useful with multithread applications (like Swing Clients)
    org.objectweb.jonas.security.auth.spi.ClientLoginModule  required
    globalCtx="true"
        ;
};

This file is used when a Java client is launched with jclient, as a result of the following property being set by jclient:

-Djava.security.auth.login.config==$JONAS_ROOT/conf/jaas.config

For more information about the JAAS authentication, refer to the JAAS authentication tutorial (see http://java.sun.com/j2se/1.4.1/docs/guide/security/jaas/tutorials/GeneralAcnOnly.html).