Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-5064684

Missing documentation for SSL RMI Socket Factories.

    Details

    • Subcomponent:
    • Resolved In Build:
      b108
    • CPU:
      sparc
    • OS:
      solaris_2.5.1
    • Verification:
      Verified

      Description

      The new standard SSL/TLS-based RMI Socket Factory classes should be documented
      as part of the new RMI and Security features.

      The following pages in the doc set need to be updated to reflect this fact:

      1/ --------------------------------------------------------------------------
      Add an entry in the Security Enhancements in the Java 2 SDK, v1.5.0 and point
      to the SSL/TLS RMI Socket Factories javadoc.

      URL: http://java.sun.com/j2se/1.5.0/docs/guide/security/enhancements15.html

      Text: Support for the SSL/TLS-based RMI Socket Factories. For details see the
            SSL/TLS-based RMI Socket Factory classes. (link to javadoc javax.rmi.ssl)
      -----------------------------------------------------------------------------

      2/ --------------------------------------------------------------------------
      Add an entry in the Security API Specification section named
      "SSL/TLS RMI Socket Factories" with the javax.rmi.ssl package.

      http://java.sun.com/j2se/1.5.0/docs/guide/security/index.html
      -----------------------------------------------------------------------------

      3/ --------------------------------------------------------------------------
      The RMI tutorials about "Using Java RMI with SSL" publish a link to a JSSE
      example that uses custom SSL RMI socket factories.

      URL: http://java.sun.com/j2se/1.5.0/docs/guide/rmi/socketfactory/SSLInfo.html

      Append at the end of A3 as part of the answer to Q3 the following text:

      Beginning with v1.5, the Java 2 SDK provides a standard implementation of
      SSL/TLS-based RMI Socket Factories. See the javax.rmi.ssl package javadoc
      (link) for more detailed information on the features of these new factories.
      -----------------------------------------------------------------------------

      4/ --------------------------------------------------------------------------
      In http://java.sun.com/j2se/1.5.0/docs/guide/security/jsse/samples/index.html
      modify the README.txt file
      (http://java.sun.com/j2se/1.5.0/docs/guide/security/jsse/samples/README.txt)
      to add at the end of the rmi example section the following text:

      This example can be easily updated to run with the new standard SSL/TLS-based
      RMI Socket Factories. In order to do that modify the HelloImpl.java file to use

          javax.rmi.ssl.SslRMIClientSocketFactory
          javax.rmi.ssl.SslRMIServerSocketFactory

      instead of

          RMISSLClientSocketFactory
          RMISSLServerSocketFactory

      and supply the system properties

        -Djavax.net.ssl.keyStore=testkeys -Djavax.net.ssl.keyStorePassword=passphrase

      in the command-line when running the HelloImpl java application.
      -----------------------------------------------------------------------------

        Attachments

          Activity

            People

            • Assignee:
              sharonz Sharon Zakhour (Inactive)
              Reporter:
              lmalvent Luis-Miguel Alventosa (Inactive)
            • Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:
                Imported:
                Indexed: