Skip to content

TurboPack/indy_extras

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TaurusTLS

Copyright (c) 2025 TaurusTLS Developers All Rights Reserved

General Information

TaurusTLS provides OpenSSL 1.1.1 and 3.x support for Indy - Internet Direct. It includes headers plus two components for Delphi and C++Builder. Those components are:

  • TTaurusTLSIOHandlerSocket - Enables TLS in a TIdTCPClientCustom descendant.
  • TTaurusTLSServerIOHandler - Enables TLS in a TIdCustomTCPServer descendant.

Both components are in the TaurusTLS.pas unit and the components are available on the IDE palette page, “TaurusTLS”.

TaurusTLS supports the following operating systems:

  • Android
  • iOS
  • Linux
  • MacOS
  • Windows

License

TaurusTLS is dual licensed. You can review which license better suits your needs, and use that license. You can even change your mind later if you have previously chosen one.

The TaurusTLS Modified BSD license is a very no nonsense license that allows you to do almost anything you want with TaurusTLS provided you provide proper attribution. Details are available in the Modified_BSD_LICENSE.md file included in the with this source-code.

To make it easier and consistent for JEDI users, we also offer an MPL license v1.1. Details are available in the LICENSE_MPL_1_1.txt file included with this source-code.

RAD Studio Installation

TaurusTLS supports the following RAD Studio versions:

  • Athens (Delphi 12) - packages in the TaurusTLS\Packages\d12 folder
  • Alexandria (Delphi 11) - package in the TaurusTLS\Packages\d11 folder
  • Sydney (Delphi 10.4) - package in the TaurusTLS\Packages\dsydney folder
  • Rio (Delphi 10.3) - package in the TaurusTLS\Packages\drio folder
  • Tokyo (Delphi 10.2) - package in the TaurusTLS\Packages\dtokyo folder
  • Berlin (Delphi 10.1) - package in the TaurusTLS\Packages\dberlin folder
  • Seattle (Delphi 10) - package in the TaurusTLS\Packages\dseattle folder

You may make packages for older versions of RAD Studio.

For Indy Included with Delphi

  1. Open TaurusAll.groupproj in the TaurusTLS\Packages\d12 folder.
  2. Compile TaurusTLS_RT.
  3. Compile TaurusTLS_DT and install it in the IDE.

You may install TaurusTLS into the 64-bit Integrated Development Environment (IDE) using the same procedure.

If you have TMS Smart Setup, you can do the following to install TaurusTLS:

tms repo-register git https://github.com/JPeterMugaas/TaurusTLS.git
tms install taurustls_developers.taurustls

For Indy that was Upgraded from the Website

  1. Set the INDY_PATH environment variable for your user account to the location where Indy is located.
  2. Open TaurusForIndy290All.groupproj in the TaurusTLS\Packages\d12 folder.
  3. Compile TaurusTLS_RTForIndy290.
  4. Compile TaurusTLS_DTForIndy290 and install it in the IDE.

You may install TaurusTLS into the 64-bit Integrated Development Environment (IDE) using the same procedure.

Making your own Packages

I suggest that you have 2 separate packages; a runtime only package and a design-time package.

The run-time package should depend upon your Indy package files and include the following:

  • Source\TaurusTLS.pas
  • Source\TaurusTLS_Files.pas
  • Source\TaurusTLS_NTLM.pas
  • Source\TaurusTLS_ResourceStrings.pas
  • Source\TaurusTLS_Utils.pas
  • Source\TaurusTLS_X509.pas
  • Source\TaurusTLSConsts.pas
  • Source\TaurusTLSExceptionHandlers.pas
  • Source\TaurusTLSFIPS.pas
  • Source\TaurusTLSHeaders_*.pas
  • Source\TaurusTLSLoader.pas

The design-time package should depend upon the run-time package and include the following files:

  • Source\TaurusTLS_Dsn_AboutDlg.pas
  • Source\TaurusTLS_Dsn_ComponentEditor.pas
  • Source\TaurusTLS_Dsn_Register.pas
  • Source\TaurusTLS_Dsn_ResourceStrings.pas

Lazarus Installation

  1. Open taurustlsldsgn.lpk from the TaurusTLS/Packages/lazarus.
  2. From "Required Packages", open "TaurusTLSRT" and compile it.
  3. Then compile the main package itself and install it in the IDE.

Deploying Your Applications

TaurusTLS requires OpenSSL 1.1.1 or OpenSSL 3.x.

Static Libraries (OpenSSL 3.x ONLY)

Static libraries (.a files) can be used with Android, iOS and macOS. Precompiled versions of the libraries are available at: https://github.com/JPeterMugaas/OpenSSL-Distribution/tree/main/binaries and https://github.com/TurboPack/OpenSSL-Distribution/tree/main/binaries. There are also instructions for building the libraries at: https://github.com/TurboPack/OpenSSL-Distribution/tree/main/build-scripts.

Linux

On Linux, OpenSSL is usually installed by default. We recommend that developers document this requirement in case users need to install updated versions of OpenSSL.

Windows

On Windows, OpenSSL is not installed by default so you have to redistribute it along with your software by placing the library files in the same directory as your executable. You can choose to either deploy OpenSSL 1.1.1 (not recommended) or an OpenSSL 3.x version. As of this writing, the current OpenSSL 3.x versions are 3.0.16, 3.1.8, 3.2.4, 3.3.3, 3.4.1, and 3.5.0. Pre-compiled .DLL’s for these versions are available at https://github.com/JPeterMugaas/OpenSSL-Distribution/tree/main/binaries/Windows and https://github.com/TurboPack/OpenSSL-Distribution/tree/main/binaries/Windows .

For Win32 applications, you need to redistribute the following:

OpenSSL 1.1.1 (not recommended because OpenSSL 1.1.1 has reached its end of life)

  • libcrypto-1_1.dll
  • libssl-1_1.dll
  • openssl.exe

OpenSSL 3.x

  • libcrypto-3.dll
  • libssl-3.dll
  • openssl.exe

For Win64 applications, you need to redistribute the following:

OpenSSL 1.1.1 (not recommended because OpenSSL 1.1.1 has reached its end of life)

  • libcrypto-1_1-x64.dll
  • libssl-1_1-x64.dll
  • openssl.exe

OpenSSL 3.x

  • libcrypto-3-x64.dll
  • libssl-3-x64.dll
  • openssl.exe

Component Reference

TaurusTLS includes a component reference in "Compiled HTML Help file (.chm)" format in the Help\chm directory.

Demo Programs

Taurus TLS includes 4 demo programs.

TaurusTLS\src\demos\FTPServer\TaurusFTPServer.dproj

This is a FTP Server with TLS enabled that runs in the Windows console. This program has been tested with the following FTP clients:

This program requires a certificate to run. Instructions for creating a self-signed certificate are available at https://technotes.shemyak.com/posts/min-openssl-cnf/. You then need to create a server.ini file in the executable directory that enables the certificate that has the following lines:

[Certificate]
CertificateFile=[path to your public certificate file]
KeyFile=[path to your private SSL key]
Password=[password for your private SSL key]

You can also do the following:

  1. Copy the OpenSSL .dll's and openssl.exe to the directory where the FTP server demo .exe is built. Usually that is \$(platform)\Debug or \$(platform)\Release.
  2. Run the makecert.bat to generate a self-signed certificate. Just answer the prompts and the certificate is generated.
  3. Run the FTP Server .exe and it will create a default server.ini file that points to the certificate files generated in Step 2.

TaurusTLS\demos\TaurusFTPClient\TaurusFTPClient.dproj

This is a fully functional Delphi-only FTP client that is multi-threaded using the VCL Framework. It has been tested with the following servers:

No special configuration is required, and the program generates its own INI files for storing FTP server information and default settings. You may need to configure the program if you have a firewall/proxy setup or are behind a NAT and wish to use PORT transfers.

TaurusTLS\demos\TaurusFTPConsole\taurusftp.dpr and taurusftp.lpr

This is a fully functional cross-platform console FTP client that can be built with both Delphi and Lazaurus. It has been tested with the following servers:

For help using the client, just use the "help" command.

TaurusTLS\Demos\TaurusHTTPServer\taurusHTTPServer.dpr and taurusHTTPServer.lpr

This is a minimal HTTP Server that only replies with a 200 code and an empty page. This program is used for testing the server component for cross-platform usage. This program requires a certificate file (domain.crt) and a private key file (domain.key) that has to generated by the openssl.exe program.

Tools I Use

Beyond Compare

Compares different versions of a file. https://www.scootersoftware.com/

Deleaker

Helps us find leaks. https://www.deleaker.com/

DocInsight

Converts XML Documentation comments into a .CHM file. https://devjetsoftware.com/products/documentation-insight/

Pascal Analyzer

Analyzes source-code to find various types of potential issues.

https://peganza.com/products_pal.html

Credits

Chad Z. Hower (Kudzu) and the Indy Pit Crew

author of the original code that was modified to create TaurusTLS.

Dave Nottage

for providing the code used for loading OpenSSL on MacOS, and for changes needed for static binding, and Android and iOS

Tony Whyman

for providing the OpenSSL headers that TaurusTLS is based upon

Third Party Notices

Portions of this software are Copyright (c) 1993 – 2018, Chad Z. Hower (Kudzu) and the Indy Pit Crew – https://www.indyproject.org/

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

  1. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation, about box and/or other materials provided with the distribution.

  2. No personal names or organizations names associated with the Indy project may be used to endorse or promote products derived from this software without specific prior written permission of the specific individual or organization.

THIS SOFTWARE IS PROVIDED BY Chad Z. Hower (Kudzu) and the Indy Pit Crew “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

About

A collection of projects to augment the Indy project

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages