OpenSSL 1.0.1g 7 Apr 2014
Copyright (c) 1998-2011 The OpenSSL Project Copyright (c) 1995-1998 Eric A. Young, Tim J. Hudson 保留所有权利。
OpenSSL 项目是一项协作努力,旨在开发一个健壮、 商业级、功能完备的开源工具包,实现了 安全套接字层(SSL v2/v3)和传输层安全(TLS v1)协议, 以及一个功能强大的通用密码学库。 该项目由遍布全球的志愿者社区管理,他们通过 互联网进行沟通、规划并开发 OpenSSL 工具包及其 相关文档。
OpenSSL 基于优秀的 SSLeay 库,该库由 Eric A. Young 和 Tim J. Hudson 开发。 OpenSSL 工具包采用双重许可证( OpenSSL 许可证和 SSLeay 许可证)方式授权,这基本上意味着 你可以自由获取和使用它,用于商业和非商业 目的,只要你满足两个许可证的条件。
OpenSSL 工具包包括:
libssl.a: SSLv2、SSLv3、TLSv1 的实现以及支持这些协议所需的代码, 在同一服务器和客户端中同时支持 SSLv2、SSLv3 和 TLSv1。
libcrypto.a: SSL/TLS 所需的常规加密和 X.509 v1/v3 内容,但 实际上并不逻辑上属于其一部分。它包括以下例程:
密码
libdes - EAY 的 libdes DES 加密包,它曾
在网上流传了几年,后来由他重新授权为
SSLeay 的一部分。它包含 15 种 DES 的“模式/变体”
(ecb、cbc、cfb 和 ofb 的 1、2 和 3 密钥版本;
pcbc 以及 cfb 和 ofb 的更通用形式),包括 desx
(cbc 模式)、快速的 crypt(3),以及
从键盘读取密码的例程。
RC4 加密,
RC2 加密 - 4 种不同的模式:ecb、cbc、cfb 和 ofb。
Blowfish 加密 - 4 种不同的模式:ecb、cbc、cfb 和 ofb。
IDEA 加密 - 4 种不同的模式:ecb、cbc、cfb 和 ofb。
摘要
MD5 和 MD2 消息摘要算法,快速实现,
SHA(SHA-0)和 SHA-1 消息摘要算法,
MDC2 消息摘要。一种基于 DES 的哈希,在智能卡上很流行。
公钥
RSA 加密/解密/生成。
位数没有限制。
DSA 加密/解密/生成。
位数没有限制。
Diffie-Hellman 密钥交换/密钥生成。
位数没有限制。
X.509v3 证书
X509 编码/解码为/自二进制 ASN1 和 PEM
基于 ASCII-二进制编码,支持使用
私钥进行加密。用于生成 RSA 和 DSA 证书请求的
程序,以及生成 RSA 和 DSA 证书。
系统
常规数字信封例程和 base64 编码。更高级别的
按名称访问密码和摘要。新的密码可以在运行时
加载。BIO IO 系统是一个简单的非阻塞
IO 抽象。当前支持的方法包括文件描述符、
套接字、套接字接受、套接字连接、内存缓冲区、缓冲、SSL
客户端/服务器、文件指针、加密、摘要、非阻塞测试
和空。
数据结构
动态增长的哈希系统
简单的栈。
使用与 MS .ini 文件类似格式的配置加载器。
openssl: 可用于以下用途的命令行工具: 创建 RSA、DH 和 DSA 密钥参数 创建 X.509 证书、CSR 和 CRL 计算消息摘要 使用密码进行加密和解密 SSL/TLS 客户端和服务器测试 处理 S/MIME 签名或加密邮件
各公司在世界各地对多种算法持有各种专利。 你 有责任确保你对任何算法的使用是合法的, 请检查你的国家是否有相关专利。 本文件包含一些我们已知或据传存在的专利。 这不是一份确定的清单。
RSA Security 对 RC5 算法持有软件专利。如果你 打算使用该密码,你必须联系 RSA Security 以获取 许可条件。他们的网页是 http://www.rsasecurity.com/。
RC4 是 RSA Security 的商标,因此这个标签的使用或许 只有在获得 RSA Security 许可的情况下才能使用。
IDEA 算法由 Ascom 在奥地利、法国、德国、意大利、 日本、荷兰、西班牙、瑞典、瑞士、英国和美国持有专利。如果需要使用该算法, 应联系他们;他们的网页是 http://www.ascom.ch/。
NTT 和三菱拥有 Camellia 算法的专利和待批专利, 但允许免费使用,无需明确 许可协议:http://info.isl.ntt.co.jp/crypt/eng/info/chiteki.html
要在 Unix 衍生系统上安装此软件包,请阅读 INSTALL 文件。对于 Win32 平台,请阅读 INSTALL.W32 文件。对于 OpenVMS 系统,请阅读 INSTALL.VMS。
阅读 doc/ 目录中的文档。虽然内容比较粗略,但它列出了函数; 你可能需要查看代码才能弄清楚 如何使用它们。请查看示例程序。
对于某些平台,存在一些可能影响用户 或应用程序作者的问题。我们试图将这些收集在 doc/PROBLEMS 中,并附上当前 关于如何在 OpenSSL 的未来版本中解决这些问题的思考。
请参阅 OpenSSL 网站 www.openssl.org,了解如何获得 商业技术支持的详细信息。
如果你在使用 OpenSSL 时遇到任何问题,请采取以下步骤 首先:
- 从 ftp://ftp.openssl.org/snapshot/ 下载当前快照
以查看问题是否已得到解决
- 移除库的 ASM 版本
- 移除编译器优化标志
如果你想报告错误,请在 任何错误报告中包含以下信息:
- 在 Unix 系统上:
由 'make report' 生成的自检报告
- 在其他系统上:
OpenSSL 版本:执行 'openssl version -a' 的输出
操作系统名称、版本、硬件平台
编译器详情(名称、版本)
- 应用程序详情(名称、版本)
- 问题描述(如果已知,请提供可重现问题的步骤)
- 堆栈回溯(如果应用程序转储核心)
通过 Request Tracker 向 OpenSSL 项目报告错误 (http://www.openssl.org/support/rt.html),邮件发送至:
请注意,Request Tracker 不应被用于一般帮助 或支持咨询。仅仅因为某些事情没有按预期工作 并不一定意味着这是 OpenSSL 中的错误。
请注意,发送到 [email protected] 的邮件会被记录在公共 可读的 Request Tracker 数据库中,并转发到一个公共 邮件列表。机密邮件可发送至 [email protected] (PGP 密钥可从密钥服务器获取)。
开发工作通过 openssl-dev 邮件列表进行协调(订阅信息请参阅 http://www.openssl.org)。如果你 想提交补丁,请将其发送至 [email protected],并在 主题中包含字符串 "[PATCH]"。请务必附上 关于补丁功能的文字说明。
如果你不确定某个功能是否对 OpenSSL 社区普遍有用, 请先在 openssl-dev 邮件列表中讨论。 也许已经有人在开发同样的功能,或者 该功能未被实现可能有很好的理由。
补丁应尽可能新,最好基于 当前的 Git 或最新的快照。它们应遵循 OpenSSL 的编码风格, 并且在编译时无警告。核心团队的一些开发者目标 可用于测试目的(debug-steve64、debug-geoff 等)。OpenSSL 可以在许多不同的平台上编译:请尽量确保你只使用可移植的 特性。
注意:出于法律原因,只有在美国提交的贡献才能被接受, 前提是将 TSU 通知和补丁副本发送至 [email protected] (前身为 BXA),并抄送 ENC 加密请求协调员; 请花一些时间查看 http://www.bis.doc.gov/Encryption/PubAvailEncSourceCodeNofify.html [原文如此] 和 http://w3.access.gpo.gov/bis/ear/pdf/740.pdf (EAR 第 740.13(e) 节) 以了解详细信息。如果"你的加密源代码太大,无法作为 电子邮件附件发送",他们也很乐意通过传真接收;希望你 有便宜的长途电话套餐。
我们更倾向于使用 "diff -u" 格式的变更输出。你可以 这样生成它: