JDK-7133668 : Remove Sample Master Security Properties file section of JAAS Reference Guide
  • Type: Enhancement
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 8
  • Priority: P4
  • Status: Closed
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2012-01-26
  • Updated: 2013-07-02
  • Resolved: 2013-03-22
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 7 JDK 8
7u40Fixed 8Fixed
Related Reports
Relates :  
Description
In Appendix A of the JAAS reference guide:

http://docs.oracle.com/javase/7/docs/technotes/guides/security/jaas/JAASRefGuide.html#AppendixA

there is a section labeled Sample Master Security Properties file which shows a modified copy of the java.security file. There are a couple of problems with this section:

1. The java.security file is out-of-date and currently includes many new properties.
2. Keeping this in-sync with the java.security file would need to be periodically done
3. Modifications to the java.security file can be overwriten by JRE updates

I recommend removing this section because of the above issues. However, we should mention (probably at the beginning of Appendix A) that any modifications to the java.security file may be overwritten by subsequent JRE updates, and to avoid this, the user should consider specifying an alternate java.security file as described in the suggested fix for CR 7133344.

Finally, there are a couple of references to "Sun Microsystems" in this guide that should be changed to "Oracle".