An interface that defines the required methods for assigning and
retrieving information about the authenticated principal (user). Providers
requiring additional principal information should extend this interface
rather than replacing it.
author: Andrew Newman, newman@yale.edu version: $Revision: 34783 $
Returns the human-readable name of the principal. This should be either
their first and last name or whatever local convention dicates should be
returned by the CommonName (CN) attribute for those security contexts
using X.509 style naming.
Returns the globally unique user identifier for this principal. This
identifier should be maximally unique within the scope of the deployed
security mechanism.
Sets the locally unique username in preparation for authentication. Note
that post-authentication, an attempt to set a UID may either fail or
reset the authentication status of the security context container.
Parameters: UID - The desired locally unique UID value.