A browser with JavaScript enabled is required for this page to operate properly.
Trail: Security Features in Java SE
Lesson: Quick Tour of Controlling Applications
Section: Set up the Policy File to Grant the Required Permissions
Grant the Required Permissions
Home Page > Security Features in Java SE > Quick Tour of Controlling Applications

Grant the Required Permissions

To grant the GetProps application permission to read the "user.home" and "java.home" property values, you must create a policy entry granting those permissions. Choose the Add Policy Entry button in the main Policy Tool window. This brings up the Policy Entry dialog box, as shown in the following figure.

the Policy Entry dialog
This figure has been reduced to fit on the page.
Click the image to view it at its natural size.

Type the following file URL into the CodeBase text box to indicate that you are going to be granting a permission to code from the specified directory, which is the directory in which GetProps.class is stored.

file:/C:/Test/
(Note, this is a URL and thus must always have slashes, not backslashes.)

Leave the SignedBy text box blank, since you aren't requiring the code to be signed.

To add permission to read the "user.home" property value, choose the Add Permission button. This brings up the Permissions dialog box.

the Permissions dialog
This figure has been reduced to fit on the page.
Click the image to view it at its natural size.

Do the following.
  1. Choose Property Permission from the Permission drop-down list. The complete permission type name (java.util.PropertyPermission) now appears in the text box to the right of the drop-down list.

  2. Type the following in the text box to the right of the list labeled Target Name to specify the "user.home" property:
    user.home
    
  3. Specify permission to read this property by selecting the read option from the Actions drop-down list.
Now the Permissions dialog box looks like the following.

the Permissions dialog with the text fields filled in
This figure has been reduced to fit on the page.
Click the image to view it at its natural size.

Choose the OK button. The new permission appears in a line in the policy entry window.

the new permission in the Policy Entry window
This figure has been reduced to fit on the page.
Click the image to view it at its natural size.

To add permission to read the "java.home" property value, choose the Add Permission button again. In the Permissions dialog box, do the following:

  1. Choose Property Permission from the Permission drop-down list.

  2. Type the following in the text box to the right of the list labeled Target Name to specify the "java.home" property:
    java.home
    
  3. Specify permission to read this property by choosing the read option from the Actions drop-down list.
Now the Permissions dialog box looks like the following.

the Permissions dialog with the java home property set to read
This figure has been reduced to fit on the page.
Click the image to view it at its natural size.

Choose the OK button. The new permission and the previously added permission appear in lines in the policy entry window, as shown in the following figure.

the new permission appears in the Policy Entry dialog
This figure has been reduced to fit on the page.
Click the image to view it at its natural size.

You are now done specifying this policy entry, so choose the Done button in the Policy Entry dialog. The Policy Tool window now includes a line representing the new policy entry, showing the CodeBase value.


Problems with the examples? Try Compiling and Running the Examples: FAQs.
Complaints? Compliments? Suggestions? Give us your feedback.

Previous page: Open the Policy File
Next page: Save the Policy File