org.acegisecurity.providers.jaas
Interface AuthorityGranter

public interface AuthorityGranter

The AuthorityGranter interface is used to map a given principal to role names.

If a Windows NT login module were to be used from JAAS, an AuthrityGranter implementation could be created to map a NT Group Principal to a ROLE_USER role for instance.

Version:

$Id: AuthorityGranter.java,v 1.6 2005/11/17 00:55:52 benalex Exp $

Author:

Ray Krueger

Method Summary

Set	grant(Principal principal) The grant method is called for each principal returned from the LoginContext subject.

Method Detail

grant

Set grant(Principal principal)

The grant method is called for each principal returned from the LoginContext subject. If the AuthorityGranter wishes to grant any authorities, it should return a java.util.Set containing the role names it wishes to grant, such as ROLE_USER. If the AuthrityGranter does not wish to grant any authorities it should return null.
The set may contain any object as all objects in the returned set will be passed to the JaasGrantedAuthority constructor using toString().

Parameters:

principal - One of the principals from the LoginContext.getSubect().getPrincipals() method.

Returns:

A java.util.Set of role names to grant, or null meaning no roles should be granted for the principal.