JDK-6840516 : The javaws.cfg.jauthenticator property is undocumented and misleading
  • Type: Bug
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 6u10
  • Priority: P4
  • Status: Closed
  • Resolution: Fixed
  • OS: windows_vista
  • CPU: x86
  • Submitted: 2009-05-13
  • Updated: 2011-03-07
  • Resolved: 2011-03-07
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
7 b110Fixed
Description
A DESCRIPTION OF THE PROBLEM :
The javaws.cfg.jauthenticator property must be set in a JNLP file to disable the built-in javaws HTTP authentication dialogue.

The property is not fully documented and the value you need is misleading.  I would expect set the property to "false" to disable the authentication dialogue.  Instead I had to set it to "true".

The code in com.sun.deploy.config.Config which tests the property is:

            String value = "" + (!auth.equalsIgnoreCase("all") &&
                        !auth.equalsIgnoreCase("true"));
            p.setProperty (SEC_AUTHENTICATOR_KEY, value);

The value for SEC_AUTHENTICATOR_KEY becomes "false" if javaws.cfg.jauthenticator is set to "true" or "all".

This is confusing.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
Something - especially why the property needs to be set to "true", since the meaning cannot be changed in future releases
ACTUAL -
Nothing.

URL OF FAULTY DOCUMENTATION :
http://java.sun.com/javase/6/docs/technotes/guides/javaws/developersguide/syntax.html

Comments
EVALUATION The page, "Properties that affect behavior of RIAs", describes the usage of the javaws.cfg.jauthenticator property. The properties page is linked from the "JNLP File Syntax page" (near where the secure properties are listed). Per Andy Herrick, this is sufficient. See urls below: Properties that affect behavior of RIAs page in jdk 7 repo - http://closedjdk.sfbay.sun.com/jdk7/build/pubs/raw-file/336a9b971b05/docs/technotes/guides/jweb/riaJnlpProps.html JNLP file syntax page in jdk7 repo - http://closedjdk.sfbay.sun.com/jdk7/build/pubs/raw-file/336a9b971b05/docs/technotes/guides/javaws/developersguide/syntax.html#resources
2010-09-14

EVALUATION we should document the property as is, since existing application may rely on this as is, we should not change the property value.
2009-05-22