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