atg.security
Interface PrincipalUserAuthority

All Superinterfaces:

UserAuthority

public interface PrincipalUserAuthority
extends UserAuthority

An extension to the UserAuthority interface that provides a mapping between the security system Persona objects and any object that implements java.security.Principal.

Even though Persona implements Principal, the two may not be interchangeable; a Persona may be a higher-performance version of the Principal, and the Principal may be more flexible than a Persona.

Field Summary

static java.lang.String

CLASS_VERSION

Method Summary

Persona	getPersonaForPrincipal(java.security.Principal principal) Given a Principal, return the Persona that represents it.
java.security.Principal	getPrincipalForPersona(Persona persona) Given a persona, return the Principal that it represents.

Methods inherited from interface atg.security.UserAuthority

addAuthenticationFailedListener, addAuthenticationSucceededListener, getPersona, getUserAuthorityName, removeAuthenticationFailedListener, removeAuthenticationSucceededListener, userDestroyed

Field Detail

CLASS_VERSION

static final java.lang.String CLASS_VERSION

See Also:

Constant Field Values

Method Detail

getPrincipalForPersona

java.security.Principal getPrincipalForPersona(Persona persona)
                                               throws SecurityException

Given a persona, return the Principal that it represents. This will throw a security exception if the value cannot be found for some reason (e.g. the Persona was not produced by this UserAuthority).

Throws:

SecurityException

getPersonaForPrincipal

Persona getPersonaForPrincipal(java.security.Principal principal)
                               throws SecurityException

Given a Principal, return the Persona that represents it. This will throw a security exception if the value cannot be found for some reason (e.g. the supplied Principal is not related to this UserAuthority).

Throws:

SecurityException