Book Home Java Security Search this book

5.4. Protection Domains

A protection domain is a grouping of a code source and permissions--that is, a protection domain represents all the permissions that are granted to a particular code source. In the default implementation of the Policy class, a protection domain is one grant entry in the file. A protection domain is an instance of the ProtectionDomain class (java.security.ProtectionDomain) and is constructed as follows:

public ProtectionDomain(CodeSource cs, PermissionCollection p) figure

Construct a protection domain based on the given code source and set of permissions.

When associated with a class, a protection domain means that the given class was loaded from the site specified in the code source, was signed by the public keys specified in the code source, and should have permission to perform the set of operations represented in the permission collection object. Each class in the virtual machine may belong to one and only one protection domain, which is set by the class loader when the class is defined.

However, not all class loaders have a specific protection domain associated with them: classes that are loaded by the primordial class loader have no protection domain. In particular, this means that classes that exist as part of the system class path (that is, the Java API classes) have no explicit protection domain. We can think of these classes as belonging to the system protection domain.

A protection domain is set for a class inside the defineClass() method. A protection domain is assigned to a class depending upon one of the following cases:

There are three utility methods of the ProtectionDomain class:

public CodeSource getCodeSource() figure

Return the code source that was used to construct this protection domain.

public PermissionCollection getPermissions() figure

Return the permission collection object that was used to construct this protection domain.

public boolean implies(Permission p) figure

Indicate whether the given permission is implied by the permissions object contained in this protection domain.



Library Navigation Links

Copyright © 2001 O'Reilly & Associates. All rights reserved.