javax.security.auth
Class AuthPermission

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by java.security.Permission sample code for java.security.Permission definition code for java.security.Permission 
      extended by java.security.BasicPermission sample code for java.security.BasicPermission definition code for java.security.BasicPermission 
          extended by javax.security.auth.AuthPermission
All Implemented Interfaces:
Serializable sample code for java.io.Serializable definition code for java.io.Serializable , Guard sample code for java.security.Guard definition code for java.security.Guard

public final class AuthPermission
extends BasicPermission sample code for java.security.BasicPermission definition code for java.security.BasicPermission

This class is for authentication permissions. An AuthPermission contains a name (also referred to as a "target name") but no actions list; you either have the named permission or you don't.

The target name is the name of a security configuration parameter (see below). Currently the AuthPermission object is used to guard access to the Policy, Subject, LoginContext, and Configuration objects.

The possible target names for an Authentication Permission are:

        doAs -                  allow the caller to invoke the
                                Subject.doAs methods.

        doAsPrivileged -        allow the caller to invoke the
                                Subject.doAsPrivileged methods.

        getSubject -            allow for the retrieval of the
                                Subject(s) associated with the
                                current Thread.

        getSubjectFromDomainCombiner -  allow for the retrieval of the
                                Subject associated with the
                                a SubjectDomainCombiner.

        setReadOnly -           allow the caller to set a Subject
                                to be read-only.

        modifyPrincipals -      allow the caller to modify the Set
                                of Principals associated with a
                                Subject

        modifyPublicCredentials - allow the caller to modify the
                                Set of public credentials
                                associated with a Subject

        modifyPrivateCredentials - allow the caller to modify the
                                Set of private credentials
                                associated with a Subject

        refreshCredential -     allow code to invoke the refresh
                                method on a credential which implements
                                the Refreshable interface.

        destroyCredential -     allow code to invoke the destroy
                                method on a credential object
                                which implements the Destroyable
                                interface.

        createLoginContext.{name} -  allow code to instantiate a
                                LoginContext with the
                                specified name.  name
                                is used as the index into the installed login
                                Configuration
                                (that returned by
                                Configuration.getConfiguration()).
                                name can be wildcarded (set to '*')
                                to allow for any name.

        getLoginConfiguration - allow for the retrieval of the system-wide
                                login Configuration.

        setLoginConfiguration - allow for the setting of the system-wide
                                login Configuration.

        refreshLoginConfiguration - allow for the refreshing of the system-wide
                                login Configuration.
 

The following target name has been deprecated in favor of createLoginContext.{name}.

        createLoginContext -    allow code to instantiate a
                                LoginContext.
 

javax.security.auth.Policy has been deprecated in favor of java.security.Policy. Therefore, the following target names have also been deprecated:

        getPolicy -             allow the caller to retrieve the system-wide
                                Subject-based access control policy.

        setPolicy -             allow the caller to set the system-wide
                                Subject-based access control policy.

        refreshPolicy -         allow the caller to refresh the system-wide
                                Subject-based access control policy.
 

See Also:
Serialized Form

Constructor Summary
AuthPermission sample code for javax.security.auth.AuthPermission.AuthPermission(java.lang.String) definition code for javax.security.auth.AuthPermission.AuthPermission(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  name)
          Creates a new AuthPermission with the specified name.
AuthPermission sample code for javax.security.auth.AuthPermission.AuthPermission(java.lang.String, java.lang.String) definition code for javax.security.auth.AuthPermission.AuthPermission(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  name, String sample code for java.lang.String definition code for java.lang.String  actions)
          Creates a new AuthPermission object with the specified name.
 
Method Summary
 
Methods inherited from class java.security.BasicPermission sample code for java.security.BasicPermission definition code for java.security.BasicPermission
equals sample code for java.security.BasicPermission.equals(java.lang.Object) definition code for java.security.BasicPermission.equals(java.lang.Object) , getActions sample code for java.security.BasicPermission.getActions() definition code for java.security.BasicPermission.getActions() , hashCode sample code for java.security.BasicPermission.hashCode() definition code for java.security.BasicPermission.hashCode() , implies sample code for java.security.BasicPermission.implies(java.security.Permission) definition code for java.security.BasicPermission.implies(java.security.Permission) , newPermissionCollection sample code for java.security.BasicPermission.newPermissionCollection() definition code for java.security.BasicPermission.newPermissionCollection()
 
Methods inherited from class java.security.Permission sample code for java.security.Permission definition code for java.security.Permission
checkGuard sample code for java.security.Permission.checkGuard(java.lang.Object) definition code for java.security.Permission.checkGuard(java.lang.Object) , getName sample code for java.security.Permission.getName() definition code for java.security.Permission.getName() , toString sample code for java.security.Permission.toString() definition code for java.security.Permission.toString()
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 

Constructor Detail

AuthPermission sample code for javax.security.auth.AuthPermission(java.lang.String) definition code for javax.security.auth.AuthPermission(java.lang.String)

public AuthPermission(String sample code for java.lang.String definition code for java.lang.String  name)
Creates a new AuthPermission with the specified name. The name is the symbolic name of the AuthPermission.

Parameters:
name - the name of the AuthPermission

AuthPermission sample code for javax.security.auth.AuthPermission(java.lang.String, java.lang.String) definition code for javax.security.auth.AuthPermission(java.lang.String, java.lang.String)

public AuthPermission(String sample code for java.lang.String definition code for java.lang.String  name,
                      String sample code for java.lang.String definition code for java.lang.String  actions)
Creates a new AuthPermission object with the specified name. The name is the symbolic name of the AuthPermission, and the actions String is currently unused and should be null.

Parameters:
name - the name of the AuthPermission

actions - should be null.