Documentation

The Java™ Tutorials
Hide TOC
Grant the Required Permission
Trail: Security Features in Java SE
Lesson: Creating a Policy File
Section: Set up a Policy File to Grant the Required Permission

Grant the Required Permission

To create a new entry, click the Add Policy Entry button in the main Policy Tool window. This displays the Policy Entry dialog box as shown in the following figure.

the Policy Entry dialog

A policy entry specifies one or more permissions for code from a particular code source - code from a particular location (URL), code signed by a particular entity, or both.

The CodeBase and the SignedBy text boxes specify which code you want to grant the permission(s) you will be adding in the file.

If you have both a CodeBase and a SignedBy entry, the permission(s) are granted only to code that is both from the specified location and signed by the named alias.

You can grant permission to all code from the location (URL) where examples are stored.

Type the following URL into the CodeBase text box of the Policy Entry dialog box:

https://docs.oracle.com/javase/tutorial/security/tour1/examples/

Note: This is a URL. Therefore, it must always use slashes as separators, not backslashes.

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


Note: To grant the permission to any code (.class file) not just from the directory specified previously but from the security directory and its subdirectories, type the following URL into the CodeBase box:
https://docs.oracle.com/javase/tutorial/security/

You have specified where the code comes from (the CodeBase), and that the code does not have to be signed (since there is no SignedBy value).

You have now specified this policy entry, so click the Done button in the Policy Entry dialog. The Policy Tool window now contains a line representing the policy entry, showing the CodeBase value.

the PolicyTool window, showing the new policy entry

Note: We will be granting permissions to this new policy entry in the next lesson.


Previous page: Start Policy Tool
Next page: Save the Policy File