Difference between revisions of "Main Page"
(add link to the STACK API page) |
|||
(42 intermediate revisions by 18 users not shown) | |||
Line 1: | Line 1: | ||
− | If this is your first visit or to get an account please see the [[Welcome]] page. Your participation and [[Contributions]] are valued. | + | This is the OpenSSL wiki. The main site is https://www.openssl.org . If this is your first visit or to get an account please see the [[Welcome]] page. Your participation and [[Contributions]] are valued. |
This wiki is intended as a place for collecting, organizing, and refining useful information about OpenSSL that is currently strewn among multiple locations and formats. | This wiki is intended as a place for collecting, organizing, and refining useful information about OpenSSL that is currently strewn among multiple locations and formats. | ||
Line 10: | Line 10: | ||
<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
<TD>[[Compilation and Installation]]</TD> | <TD>[[Compilation and Installation]]</TD> | ||
+ | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
+ | <TD>[[Configuration "packages"]]</TD> | ||
<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
<TD>[[Internals]]</TD> | <TD>[[Internals]]</TD> | ||
− | |||
− | |||
</TR> | </TR> | ||
<TR> | <TR> | ||
Line 21: | Line 21: | ||
<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
<TD>[[Examples]] </TD> | <TD>[[Examples]] </TD> | ||
+ | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
+ | <TD>[[Documentation Index|Index of all API functions]]</TD> | ||
</TR> | </TR> | ||
<TR> | <TR> | ||
Line 28: | Line 30: | ||
<TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
<TD>[[Related Links]]</TD> | <TD>[[Related Links]]</TD> | ||
+ | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
+ | <TD>[[Binaries]]</TD> | ||
+ | </TR> | ||
+ | <TR> | ||
+ | <TD>[[SSL and TLS Protocols]]</TD> | ||
+ | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
+ | <TD>[[1.1 API Changes]]</TD> | ||
+ | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
+ | <TD>[[FIPS modules]]</TD> | ||
+ | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
+ | <TD>[[TLS1.3]]</TD> | ||
+ | </TR> | ||
+ | <TR> | ||
+ | <TD>[[Mailing Lists]]</TD> | ||
+ | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
+ | <TD>[[OpenSSL 3.0]]</TD> | ||
+ | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
+ | <TD></TD> | ||
+ | <TD>[[Image:HTAB.png]][[Image:HTAB.png]]</TD> | ||
+ | <TD></TD> | ||
</TR> | </TR> | ||
</TABLE> | </TABLE> | ||
Line 39: | Line 61: | ||
== Reference == | == Reference == | ||
This section contains the automagically generated man pages from the OpenSSL git repository, and similar "man" style reference documentation. The man pages are automatically imported from the OpenSSL git repository and local wiki modifications are submitted as patches. | This section contains the automagically generated man pages from the OpenSSL git repository, and similar "man" style reference documentation. The man pages are automatically imported from the OpenSSL git repository and local wiki modifications are submitted as patches. | ||
− | :* OpenSSL Manual Pages | + | :* [https://www.openssl.org/docs/manpages.html OpenSSL Manual Pages] |
− | |||
− | |||
:* [[API]], [[Libcrypto API]], [[Libssl API]] | :* [[API]], [[Libcrypto API]], [[Libssl API]] | ||
:* [[FIPS mode()]], [[FIPS_mode_set()]] | :* [[FIPS mode()]], [[FIPS_mode_set()]] | ||
Line 64: | Line 84: | ||
::* [[EVP Signing and Verifying|EVP Signing and Verifying (including MAC codes)]] | ::* [[EVP Signing and Verifying|EVP Signing and Verifying (including MAC codes)]] | ||
:* [[STACK API]] | :* [[STACK API]] | ||
+ | :* [[List of SSL OP Flags]] | ||
:* Low Level APIs | :* Low Level APIs | ||
+ | ::[[Creating an OpenSSL Engine to use indigenous ECDH ECDSA and HASH Algorithms]] | ||
:: More specialized non-EVP usage | :: More specialized non-EVP usage | ||
::* [[Diffie-Hellman parameters]] | ::* [[Diffie-Hellman parameters]] | ||
+ | :* [[FIPS Mode]] | ||
+ | :* [[Simple TLS Server]] | ||
+ | :* [[Simple TLS Client]] | ||
+ | :* [[Simple DTLS Server]] | ||
+ | :* [[Simple DTLS Client]] | ||
== Concepts and Theory == | == Concepts and Theory == | ||
Line 72: | Line 99: | ||
Discussions of common operational issues | Discussions of common operational issues | ||
:* [[Base64]] | :* [[Base64]] | ||
− | :* [ | + | :* [http://wiki.openssl.org/index.php/Category:FIPS_140 FIPS 140-2] |
:* [[Random Numbers]] | :* [[Random Numbers]] | ||
:* [[Diffie Hellman]] | :* [[Diffie Hellman]] | ||
:* [[Elliptic Curve Diffie Hellman]] | :* [[Elliptic Curve Diffie Hellman]] | ||
:* [[Elliptic Curve Cryptography]] | :* [[Elliptic Curve Cryptography]] | ||
+ | |||
+ | == Security Advisories == | ||
+ | :* [https://www.openssl.org/policies/secpolicy.html OpenSSL Security Policy] | ||
+ | :* [https://www.openssl.org/news/vulnerabilities.html OpenSSL Vulnerabilities List] | ||
+ | :* [[Security_Advisories|Security Advisories Additional Information]] | ||
+ | |||
+ | == Feedback and Contributions == | ||
+ | :* [https://www.openssl.org/news/vulnerabilities.html How to notify us of suspected security vulnerabilities] | ||
+ | :* [https://www.openssl.org/community/#bugs How to report bugs, other than for suspected vulnerabilities] | ||
+ | :* [[Contributions|General background on source and documentation contributions - '''must read''']] | ||
+ | :* Contributing code fixes, other than for suspected vulnerabilities, as well as fixes and other improvements to manual pages: | ||
+ | ::* If you are unsure as to whether a feature will be useful for the general OpenSSL community please discuss it on the [https://www.openssl.org/community/ openssl-users mailing list] first. Someone may be already working on the same thing or there may be a good reason as to why that feature isn't implemented. | ||
+ | ::* Follow the [[Use of Git#Use_of_Git_with_OpenSSL_source_tree|instructions for accessing source code]] in the appropriate branches. Note that manual pages and the FAQ are maintained with the source code. | ||
+ | ::* Submit a pull request for each separate fix (also documented [[Use of Git#Use_of_Git_with_OpenSSL_source_tree|there]]) | ||
+ | ::* Submit a bug report (see second bullet, above) and reference the pull request. Or you can attach the patch to the ticket. | ||
+ | :* Contributing fixes and other improvements to the web site | ||
+ | ::* Follow the [[Use_of_Git#Use_of_Git_with_the_OpenSSL_web_site|instructions for accessing web site sources]] | ||
+ | ::* Create a patch (also documented [[Use_of_Git#Use_of_Git_with_the_OpenSSL_web_site|there]]) | ||
+ | ::* Submit a bug report and add the patch as an attachment | ||
+ | :* [[Developing For OpenSSL]] | ||
+ | :* [[KnownPatches|Known patches not part of OpenSSL]] | ||
+ | :* [[Welcome|Contributing to this wiki]] | ||
== Internals and Development == | == Internals and Development == | ||
This section is for internal details of primary interest to OpenSSL maintainers and power users | This section is for internal details of primary interest to OpenSSL maintainers and power users | ||
+ | :* [[Code reformatting]] | ||
+ | |||
:* [[Internals]] | :* [[Internals]] | ||
:* [[Code Quality]] | :* [[Code Quality]] | ||
:* [[Static and Dynamic Analysis]] | :* [[Static and Dynamic Analysis]] | ||
:* [[OCB|OCB Licence details]] | :* [[OCB|OCB Licence details]] | ||
+ | :* [[Defect and Feature Review Process]] | ||
+ | :* [[Unit Testing]] (includes other automated testing information) | ||
+ | :* [[How to Integrate a Symmetric Cipher]] |
Latest revision as of 05:26, 16 February 2021
This is the OpenSSL wiki. The main site is https://www.openssl.org . If this is your first visit or to get an account please see the Welcome page. Your participation and Contributions are valued.
This wiki is intended as a place for collecting, organizing, and refining useful information about OpenSSL that is currently strewn among multiple locations and formats.
OpenSSL Quick Links[edit]
Administrivia[edit]
Site guidelines, legal and admininstrative issues.
- Basic rules, Commercial Product Disclaimer, Contributions, Copyright, License
- Using This Wiki
Reference[edit]
This section contains the automagically generated man pages from the OpenSSL git repository, and similar "man" style reference documentation. The man pages are automatically imported from the OpenSSL git repository and local wiki modifications are submitted as patches.
Usage and Programming[edit]
This section has discussions of practical issues in using OpenSSL
- Building from Source
- Where to find it, the different versions, how to build and install it.
- Programming techniques and example code
- Use of EVP is preferred for most applications and circumstances
- STACK API
- List of SSL OP Flags
- Low Level APIs
- Creating an OpenSSL Engine to use indigenous ECDH ECDSA and HASH Algorithms
- More specialized non-EVP usage
Concepts and Theory[edit]
Discussions of basic cryptographic theory and concepts Discussions of common operational issues
Security Advisories[edit]
Feedback and Contributions[edit]
- How to notify us of suspected security vulnerabilities
- How to report bugs, other than for suspected vulnerabilities
- General background on source and documentation contributions - must read
- Contributing code fixes, other than for suspected vulnerabilities, as well as fixes and other improvements to manual pages:
- If you are unsure as to whether a feature will be useful for the general OpenSSL community please discuss it on the openssl-users mailing list first. Someone may be already working on the same thing or there may be a good reason as to why that feature isn't implemented.
- Follow the instructions for accessing source code in the appropriate branches. Note that manual pages and the FAQ are maintained with the source code.
- Submit a pull request for each separate fix (also documented there)
- Submit a bug report (see second bullet, above) and reference the pull request. Or you can attach the patch to the ticket.
- Contributing fixes and other improvements to the web site
- Follow the instructions for accessing web site sources
- Create a patch (also documented there)
- Submit a bug report and add the patch as an attachment
Internals and Development[edit]
This section is for internal details of primary interest to OpenSSL maintainers and power users
- Internals
- Code Quality
- Static and Dynamic Analysis
- OCB Licence details
- Defect and Feature Review Process
- Unit Testing (includes other automated testing information)
- How to Integrate a Symmetric Cipher