[jira] [Created] (MJAVADOC-565) web proxy not configured for https

["Bill Shannon (JIRA)" <ji...@apache.org>]

Bill Shannon created MJAVADOC-565:
-------------------------------------

             Summary: web proxy not configured for https
                 Key: MJAVADOC-565
                 URL: https://issues.apache.org/jira/browse/MJAVADOC-565
             Project: Maven Javadoc Plugin
          Issue Type: Bug
    Affects Versions: 3.0.1
            Reporter: Bill Shannon


There seems to be some disagreement about how to configure web proxy servers.

Maven seems to think that the "protocol" element specifies the protocol to use when talking to the web proxy server, and thus allows only one proxy to be configured in settings.xml.  (Or rather, only the first configured proxy is used.)  That's not the way proxy servers work.

The JDK configures web proxy servers based on the protocol that's being proxied.

For example, when using a <link> to access the JDK javadocs, https is needed.  The maven-javadoc-plugin invokes the external javadoc command with these arguments:

{{-J-Dhttp.proxySet=true -J-Dhttp.proxyHost=<proxy-host> -J-Dhttp.proxyPort=<proxy-port>}}

That only configures the proxy for the http protocol, not the https protocol, and thus the linked resource can not be accessed.  To configure the proxy to be used for the https protocol, the following arguments are needed:

{{-J-Dhttps.proxySet=true -J-Dhttps.proxyHost=<proxy-host> -J-Dhttps.proxyPort=<proxy-port>}}

 



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)