home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / Rhapsody / connectivity / www / bundle / HTTPS.1.0.m.PI.README next >
Encoding:
Text File  |  1998-01-22  |  5.2 KB  |  161 lines
  1. HTTPS v1.0 Package for OmniWeb 3.x (Rhapsody)
  2. ===============================================
  3. Jürgen Möllenhoff (jm@oic.de), January 19, 1998
  4.  
  5. Description
  6. ===========
  7.  
  8. This Package allows you to use https-URLs (via SSL) with OmniWeb 3.x. 
  9. It uses the free SSLeay-lib (Version 0.8.1) from Eric Young
  10. (eay@cryptsoft.com) and the OmniWeb (http://www.omnigroup.com/)
  11. extensible bundle architecture.
  12.  
  13. This software is supplied without a warranty of any kind.  I am not
  14. responsible for any damage that may occur as a result of using this
  15. software. Please keep in mind that this is work in progress. Also,
  16. please bear with the incomplete nature of the package.
  17.  
  18. Installation
  19. ============
  20.  
  21. Use "installer.sh" to install the Packages.
  22.  
  23. ATTENTION:
  24. Before you can install this Package you must install the SSL.pkg which
  25. includes two Frameworks (SSLCrypto, SSL) to /LocalLibrary/Frameworks, 
  26. without these Frameworks the bundle doesn't work. 
  27.  
  28. To enable the HTTPS protocol, install the ./HTTPS.omniweb 
  29. bundle anywhere in the OmniWeb 3.x bundle path. Then, restart OmniWeb.app.
  30. The recommended location for personal installation is ~/Library/Components
  31. for system-wide installation /LocalLibrary/Components.
  32.  
  33. If you use a proxy server, you MUST include at least one protocol 
  34. for your proxy server (http, ftp, etc. but not https) in the 
  35. protocol section of the Proxy-Preferences Panel or add the "https"
  36. protocol to the NonProxiableSchemes like 
  37.  
  38. defaults write OmniWeb NonProxiableSchemes "(file, mailto, omniweb, rlogin, telnet, tn3270, https)"
  39.  
  40. Without these "workarounds" OmniWeb wraps https calls to http!!!
  41.  
  42. CONNECT-Protocol (Proxy Support for https)
  43. ==========================================
  44.  
  45. To enable proxy support for https (SSL tunneling) you need another entry in
  46. the Proxy-Preferences Panel. Add a server to the "Proxy Server URL" section
  47. like this: "https:\\whatever-cache:1234\" and add the https protocol to the
  48. "Protocols" section. IMPORTANT: The https proxy MUST be the first server in 
  49. the list, because the list of proxy servers is an ordered list.
  50.  
  51. For example my proxy defaults look like this:
  52.  
  53. ProxyServers = "(\n    {\n        destinations = (oic.de); \n        proxyURL = \"(non-proxied protocols and destinations)\"; \n    }, \n    {proxyURL = \"https://www-cache.oic.de:3128/\"; schemes = (https); }, \n    {proxyURL = \"http://www-cache.oic.de:
  54. 3128/\"; }\n)";
  55.  
  56. History
  57. =======
  58.  
  59. 1.0
  60. - Changed the Proxy-Support. If you need proxy support add the
  61.   proxy server now with the  Proxy-Preferences Panel of OmniWeb.
  62. - Created a Version for OmniWeb 3.x (OpenStep/Rhapsody) AND OmniWeb 2.x
  63. - The name of the bundle for OmniWeb 3.x (OpenStep/Rhapsody) is "HTTPS", for
  64.   OmniWeb 2.x "HTTPSExtension".
  65.  
  66. 0.9 (Beta)
  67. - Added Proxy authentication for the CONNECT-Protocol.
  68. - Fixed a bug in the Hostname resolver. Now it should be possible to 
  69.   use this bundle without any DNS if you use a proxy server.
  70.  
  71. 0.8 (Beta)
  72. - Adapted the bundle for OmniWeb 3.x
  73. - SSLeay-lib is now located in two Frameworks (SSLCrypto, SSL)
  74. - Renamed it (sorry for that) from HTTPSExtension.omniweb to HTTPS.omniweb,
  75.   because the "new" bundle is not compatible with OmniWeb2.x, it works
  76.   ONLY for OmniWeb3.x. So it is easier for me to figure out which bundle
  77.   you mean if you have some questions about it.
  78.     
  79. 0.7
  80. - It's now SSLeay-lib in version 0.8.1.
  81. - Supports SSLv2 and SSLv3
  82. - Added a Preferences Panel
  83. - Added Proxy-Support (CONNECT-Protocol) (see HTTPS Preferences)
  84. - Added an Installer Package
  85. - Renamed it from https.omni to HTTPSExtension.omniweb
  86. - Fixed some bugs
  87. - Removed the source code
  88.  
  89. 0.6
  90. - Internal version
  91.  
  92. 0.5a
  93. - It's now SSLeay-lib in version 0.5.2a. 
  94. - Fixed a little (not important) bug.
  95. - Included the source code
  96.  
  97. 0.5
  98. - First version, which uses the SSLeay-lib in version 0.5.1b
  99.  
  100. Bugs?
  101. =====
  102.  
  103. Yes, if you use a proxy server. You MUST include at least one protocol 
  104. for your proxy server (http, ftp, etc. but not https) in the 
  105. protocol section of the Proxy-Preferences Panel or add the "https"
  106. protocol to the NonProxiableSchemes.
  107.  
  108. ATTENTION: Without any protocols, OmniWeb wraps https calls to http!!
  109.  
  110. Send bug reports, suggestions or comments to the address below.
  111.  
  112. Architectures
  113. =============
  114.  
  115. ALL Architectures are supported.
  116.  
  117. Warning!
  118. =======
  119.  
  120. It is illegal to use this software inside of the USA.  The PKP has
  121. exclusive patent rights in the USA on all aspects of public key
  122. cryptography.  Sorry, but this is not my fault.  If you are interested
  123. in learning more about this, read the documentation for the SSLeay-lib
  124. package.
  125.  
  126. Copyright
  127. =========
  128.  
  129. This bundle is free for commercial and non-commercial use.
  130.  
  131. ToDo
  132. ====
  133.  
  134. - Client certification??
  135. - Display an Icon when a SSL-Connection is in progress??
  136.  
  137. Source Code
  138. ===========
  139.  
  140. To compile this bundle you need the SSLeay-lib in version 0.8.1 and
  141. the API (Headers) for OmniWeb 3.x.  If you modify the source code,
  142. please send a copy of the modifications to me <jm@oic.de>. Thank you.
  143.  
  144. Thanks
  145. ======
  146.  
  147. Thanks to 
  148.     "Stefanie R. Herzer <herzer@apple.com>"
  149.     "Stephen J. Perkins <perkins@netmass.com>"
  150.     "Ken Case <kc@omnigroup.com>"
  151.     "Eric Young <eay@cryptsoft.com>"
  152.     "Tim Hudson <tjh@cryptsoft.com>"
  153.  
  154. Contact Information
  155. ===================
  156.  
  157. Jürgen Möllenhoff
  158. OIC - Object Innovation Center
  159. Bochum, Germany 
  160. EMail:    jm@oic.de    (ASCII, NEXT and MIME-Mail)
  161.