Application: gvSIG desktop » Library: org.gvsig.tools

package org.gvsig.tools.identitymanagement;

import javax.naming.AuthenticationException;

public interface SimpleIdentityManager {

    //

    // http://en.wikipedia.org/wiki/Identity_management

    //

    /**

     * Authenticate the identity in the system and stablish a session with this

     * identity.

     * If the identityid don't exists or the password specified is incorrect, throw

     * a exception.

     *

     * If the domain is not required it can not be null.

     *

     * @param domain, the domain used to authenticate the user

     * @param identityid, identity id to login in the system

     * @param password

     */

    public void login(String domain, String identityid, String password) throws AuthenticationException;

    /**

     * Closes the session stablised with the current identity.

     */

    public void logout();

    /**

     * Return the identity of the current session in the system or null if no has a

     * session stablisehd.

     *

     * @return the current identity

     */

    public SimpleIdentity getCurrentIdentity();

    /**

     * Inform if the login process require a domain name.

     *

     * @return true if a domain name is required.

     */

    public boolean needDomain();

}