]>
Commit | Line | Data |
---|---|---|
257e9d03 RS |
1 | Welcome to the OpenSSL Project |
2 | ============================== | |
3 | ||
6c8149df | 4 | [![openssl logo]][www.openssl.org] |
d02b48c6 | 5 | |
b897b353 | 6 | [![github actions ci badge]][github actions ci] |
6c8149df | 7 | [![appveyor badge]][appveyor jobs] |
dac5138e | 8 | |
dac5138e DMSP |
9 | OpenSSL is a robust, commercial-grade, full-featured Open Source Toolkit |
10 | for the Transport Layer Security (TLS) protocol formerly known as the | |
11 | Secure Sockets Layer (SSL) protocol. The protocol implementation is based | |
12 | on a full-strength general purpose cryptographic library, which can also | |
13 | be used stand-alone. | |
651d0aff | 14 | |
5f8e6c50 DMSP |
15 | OpenSSL is descended from the SSLeay library developed by Eric A. Young |
16 | and Tim J. Hudson. | |
dfca822f | 17 | |
6c8149df | 18 | The official Home Page of the OpenSSL Project is [www.openssl.org]. |
dac5138e | 19 | |
dac5138e DMSP |
20 | Table of Contents |
21 | ================= | |
22 | ||
23 | - [Overview](#overview) | |
24 | - [Download](#download) | |
25 | - [Build and Install](#build-and-install) | |
26 | - [Documentation](#documentation) | |
27 | - [License](#license) | |
28 | - [Support](#support) | |
29 | - [Contributing](#contributing) | |
30 | - [Legalities](#legalities) | |
651d0aff | 31 | |
5f8e6c50 DMSP |
32 | Overview |
33 | ======== | |
15133316 | 34 | |
5f8e6c50 | 35 | The OpenSSL toolkit includes: |
651d0aff | 36 | |
dac5138e | 37 | - **libssl** |
6c8149df | 38 | an implementation of all TLS protocol versions up to TLSv1.3 ([RFC 8446]). |
dac5138e DMSP |
39 | |
40 | - **libcrypto** | |
41 | a full-strength general purpose cryptographic library. It constitutes the | |
42 | basis of the TLS implementation, but can also be used independently. | |
43 | ||
44 | - **openssl** | |
45 | the OpenSSL command line tool, a swiss army knife for cryptographic tasks, | |
46 | testing and analyzing. It can be used for | |
257e9d03 RS |
47 | - creation of key parameters |
48 | - creation of X.509 certificates, CSRs and CRLs | |
49 | - calculation of message digests | |
50 | - encryption and decryption | |
51 | - SSL/TLS client and server tests | |
52 | - handling of S/MIME signed or encrypted mail | |
53 | - and more... | |
dac5138e DMSP |
54 | |
55 | Download | |
56 | ======== | |
651d0aff | 57 | |
dac5138e DMSP |
58 | For Production Use |
59 | ------------------ | |
651d0aff | 60 | |
dac5138e DMSP |
61 | Source code tarballs of the official releases can be downloaded from |
62 | [www.openssl.org/source](https://www.openssl.org/source). | |
63 | The OpenSSL project does not distribute the toolkit in binary form. | |
d7f0ab5f | 64 | |
dac5138e | 65 | However, for a large variety of operating systems precompiled versions |
af33b200 TS |
66 | of the OpenSSL toolkit are available. In particular, on Linux and other |
67 | Unix operating systems, it is normally recommended to link against the | |
dac5138e | 68 | precompiled shared libraries provided by the distributor or vendor. |
dfca822f | 69 | |
dac5138e DMSP |
70 | For Testing and Development |
71 | --------------------------- | |
dfca822f | 72 | |
dac5138e DMSP |
73 | Although testing and development could in theory also be done using |
74 | the source tarballs, having a local copy of the git repository with | |
75 | the entire project history gives you much more insight into the | |
76 | code base. | |
77 | ||
6c8149df DMSP |
78 | The official OpenSSL Git Repository is located at [git.openssl.org]. |
79 | There is a GitHub mirror of the repository at [github.com/openssl/openssl], | |
dac5138e DMSP |
80 | which is updated automatically from the former on every commit. |
81 | ||
82 | A local copy of the Git Repository can be obtained by cloning it from | |
83 | the original OpenSSL repository using | |
84 | ||
257e9d03 | 85 | git clone git://git.openssl.org/openssl.git |
dac5138e DMSP |
86 | |
87 | or from the GitHub mirror using | |
88 | ||
257e9d03 | 89 | git clone https://github.com/openssl/openssl.git |
dac5138e DMSP |
90 | |
91 | If you intend to contribute to OpenSSL, either to fix bugs or contribute | |
92 | new features, you need to fork the OpenSSL repository openssl/openssl on | |
93 | GitHub and clone your public fork instead. | |
94 | ||
257e9d03 | 95 | git clone https://github.com/yourname/openssl.git |
dac5138e | 96 | |
af33b200 | 97 | This is necessary because all development of OpenSSL nowadays is done via |
dac5138e DMSP |
98 | GitHub pull requests. For more details, see [Contributing](#contributing). |
99 | ||
dac5138e DMSP |
100 | Build and Install |
101 | ================= | |
102 | ||
103 | After obtaining the Source, have a look at the [INSTALL](INSTALL.md) file for | |
104 | detailed instructions about building and installing OpenSSL. For some | |
105 | platforms, the installation instructions are amended by a platform specific | |
106 | document. | |
107 | ||
4148581e DMSP |
108 | * [Notes for UNIX-like platforms](NOTES-UNIX.md) |
109 | * [Notes for Android platforms](NOTES-ANDROID.md) | |
110 | * [Notes for Windows platforms](NOTES-WINDOWS.md) | |
111 | * [Notes for the DOS platform with DJGPP](NOTES-DJGPP.md) | |
112 | * [Notes for the OpenVMS platform](NOTES-VMS.md) | |
113 | * [Notes on Perl](NOTES-PERL.md) | |
114 | * [Notes on Valgrind](NOTES-VALGRIND.md) | |
dac5138e | 115 | |
96a77661 DMSP |
116 | Specific notes on upgrading to OpenSSL 3.0 from previous versions can be found |
117 | in the [migration_guide(7ossl)] manual page. | |
dac5138e DMSP |
118 | |
119 | Documentation | |
120 | ============= | |
121 | ||
122 | Manual Pages | |
123 | ------------ | |
124 | ||
125 | The manual pages for the master branch and all current stable releases are | |
126 | available online. | |
127 | ||
128 | - [OpenSSL master](https://www.openssl.org/docs/manmaster) | |
a20c9b6c | 129 | - [OpenSSL 3.0](https://www.openssl.org/docs/man3.0) |
dac5138e DMSP |
130 | - [OpenSSL 1.1.1](https://www.openssl.org/docs/man1.1.1) |
131 | ||
132 | Wiki | |
133 | ---- | |
134 | ||
6c8149df | 135 | There is a Wiki at [wiki.openssl.org] which is currently not very active. |
af33b200 | 136 | It contains a lot of useful information, not all of which is up-to-date. |
dac5138e DMSP |
137 | |
138 | License | |
5f8e6c50 | 139 | ======= |
0e37c909 | 140 | |
dac5138e DMSP |
141 | OpenSSL is licensed under the Apache License 2.0, which means that |
142 | you are free to get and use it for commercial and non-commercial | |
143 | purposes as long as you fulfill its conditions. | |
dfca822f | 144 | |
036cbb6b | 145 | See the [LICENSE.txt](LICENSE.txt) file for more details. |
dfca822f | 146 | |
dac5138e DMSP |
147 | Support |
148 | ======= | |
dfca822f | 149 | |
dac5138e | 150 | There are various ways to get in touch. The correct channel depends on |
af33b200 | 151 | your requirement. See the [SUPPORT](SUPPORT.md) file for more details. |
dfca822f | 152 | |
dac5138e DMSP |
153 | Contributing |
154 | ============ | |
932af161 | 155 | |
dac5138e DMSP |
156 | If you are interested and willing to contribute to the OpenSSL project, |
157 | please take a look at the [CONTRIBUTING](CONTRIBUTING.md) file. | |
b282fdae | 158 | |
dac5138e DMSP |
159 | Legalities |
160 | ========== | |
b06935f4 | 161 | |
dac5138e | 162 | A number of nations restrict the use or export of cryptography. If you are |
af33b200 | 163 | potentially subject to such restrictions, you should seek legal advice before |
dac5138e | 164 | attempting to develop or distribute cryptographic code. |
5f8e6c50 | 165 | |
5f8e6c50 DMSP |
166 | Copyright |
167 | ========= | |
168 | ||
c5f55a46 | 169 | Copyright (c) 1998-2023 The OpenSSL Project Authors |
5f8e6c50 DMSP |
170 | |
171 | Copyright (c) 1995-1998 Eric A. Young, Tim J. Hudson | |
172 | ||
173 | All rights reserved. | |
dac5138e | 174 | |
dac5138e DMSP |
175 | <!-- Links --> |
176 | ||
177 | [www.openssl.org]: | |
257e9d03 | 178 | <https://www.openssl.org> |
dac5138e DMSP |
179 | "OpenSSL Homepage" |
180 | ||
181 | [git.openssl.org]: | |
257e9d03 | 182 | <https://git.openssl.org> |
dac5138e DMSP |
183 | "OpenSSL Git Repository" |
184 | ||
185 | [git.openssl.org]: | |
257e9d03 | 186 | <https://git.openssl.org> |
dac5138e DMSP |
187 | "OpenSSL Git Repository" |
188 | ||
189 | [github.com/openssl/openssl]: | |
257e9d03 | 190 | <https://github.com/openssl/openssl> |
dac5138e DMSP |
191 | "OpenSSL GitHub Mirror" |
192 | ||
dac5138e | 193 | [wiki.openssl.org]: |
257e9d03 | 194 | <https://wiki.openssl.org> |
dac5138e DMSP |
195 | "OpenSSL Wiki" |
196 | ||
96a77661 DMSP |
197 | [migration_guide(7ossl)]: |
198 | <https://www.openssl.org/docs/manmaster/man7/migration_guide.html> | |
199 | "OpenSSL Migration Guide" | |
84dd002f | 200 | |
dac5138e | 201 | [RFC 8446]: |
257e9d03 | 202 | <https://tools.ietf.org/html/rfc8446> |
dac5138e DMSP |
203 | |
204 | <!-- Logos and Badges --> | |
dac5138e DMSP |
205 | |
206 | [openssl logo]: | |
207 | doc/images/openssl.svg | |
208 | "OpenSSL Logo" | |
209 | ||
b897b353 RL |
210 | [github actions ci badge]: |
211 | <https://github.com/openssl/openssl/workflows/GitHub%20CI/badge.svg> | |
212 | "GitHub Actions CI Status" | |
dac5138e | 213 | |
b897b353 RL |
214 | [github actions ci]: |
215 | <https://github.com/openssl/openssl/actions?query=workflow%3A%22GitHub+CI%22> | |
216 | "GitHub Actions CI" | |
dac5138e DMSP |
217 | |
218 | [appveyor badge]: | |
0799b79a | 219 | <https://ci.appveyor.com/api/projects/status/8e10o7xfrg73v98f/branch/master?svg=true> |
dac5138e DMSP |
220 | "AppVeyor Build Status" |
221 | ||
222 | [appveyor jobs]: | |
257e9d03 | 223 | <https://ci.appveyor.com/project/openssl/openssl/branch/master> |
dac5138e | 224 | "AppVeyor Jobs" |