United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-6840516 : The javaws.cfg.jauthenticator property is undocumented and misleading

Details
Type:
Bug
Submit Date:
2009-05-13
Status:
Closed
Updated Date:
2011-03-07
Project Name:
JDK
Resolved Date:
2011-03-07
Component:
docs
OS:
windows_vista
Sub-Component:
guides
CPU:
x86
Priority:
P4
Resolution:
Fixed
Affected Versions:
6u10
Fixed Versions:

Related Reports

Sub Tasks

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



Hardware and Software, Engineered to Work Together