Website Download Support
 

Discuss this help topic in SecureBlackbox Forum

Installing the components into Delphi, C++Builder and FreePascal

SecureBlackbox is shipped as a set of precompiled modules in evaluation version. Registered version is shipped in source code only.

Usually the files are integrated into Delphi/C++Builder IDE by SecureBlackbox Setup. If you need to setup the files manually, please follow the instructions below.

Packages are located in <SecureBlackbox>\Packages folder.

Each package has a name of "<package abbreviation>BBox<suffix>.<extension>". Example: BaseBBoxD14.bpl suffix corresponds to Delphi or C++Builder version. The suffixes are:

  1. D5 - Delphi 5
  2. D6 - Delphi 6
  3. D7 - Delphi 7
  4. D9 - Delphi 2005
  5. DX - Delphi 2006 and C++Builder 2006
  6. D11 - Delphi 2007
  7. D12 - Delphi 2009 (Unicode)
  8. D14 - Delphi 2010 (Unicode)
  9. D15 - Delphi XE (Unicode)
  10. D16 - Delphi XE2 (Unicode)
  11. D17 - Delphi XE3 (Unicode)
  12. D18 - Delphi XE4 (Unicode)
  13. D19 - Delphi XE5 (Unicode)
  14. D20 - Delphi XE6 (Unicode)
  15. D21 - Delphi XE7 (Unicode)
  16. D22 - Delphi XE8 (Unicode)
  17. D23 - Delphi 10 Seattle (Unicode)
  18. D24 - Delphi 10.1 Berlin (Unicode)
  19. D25 - Delphi 10.2 Tokyo (Unicode)
  20. D26 - Delphi 10.3 Rio (Unicode)
  21. B11 - C++Builder 2007
  22. B12 - C++Builder 2009 (Unicode)
  23. B14 - C++Builder 2010 (Unicode)
  24. B15 - C++Builder XE (Unicode)
  25. B16 - C++Builder XE2 (Unicode)
  26. B17 - C++Builder XE3 (Unicode)
  27. B18 - C++Builder XE4 (Unicode)
  28. B19 - C++Builder XE5 (Unicode)
  29. B20 - C++Builder XE6 (Unicode)
  30. B21 - C++Builder XE7 (Unicode)
  31. B22 - C++Builder XE8 (Unicode)
  32. B23 - C++Builder 10 Seattle (Unicode)
  33. B24 - C++Builder 10.1 Berlin (Unicode)
  34. B25 - C++Builder 10.2 Tokyo (Unicode)
  35. B26 - C++Builder 10.3 Rio (Unicode)

For FreePascal the suffixes are:

  1. Win - Windows package
  2. Linux - Linux/x86 and Linux/x64 package

Precompiled units are located in <SecureBlackbox>\Units\<IDE version> folder.

Precompiled units require activation (it is done by passing the license key to the library before you use its components or functions) in order to be used.

Source code can be downloaded as a separate file, which is available to users who purchased a license. Windows installation of the source code installs the files to the <SecureBlackbox>\Source folder. Source code doesn't need activation (i.e. you don't set the license key if you compile the units from source code).

Step-by-step Instructions for Delphi and C++Builder

Precompiled code

  1. Add <SecureBlackbox>\Units\<IDE version> folder to the list of library folders in Delphi IDE. Library folders are set in:
    • Delphi XE and later: Main Menu -> Tools -> Options dialog -> Environment options -> Delphi Options -> Library -> Library Path edit box
    • C++Builder XE and later: Main Menu -> Tools -> Options dialog -> Environment options -> C++ Options -> Paths and directories -> Library Path edit box
    • Delphi 2005 to RAD Studio 2010: Main Menu -> Tools -> Options dialog > Library - Win 32 -> Library Path edit box
    • C++Builder 2007 to RAD Studio 2010: Main Menu -> Tools -> Options dialog > Library - Win 32 -> Library Path edit box
    • Delphi 6 to Delphi 7: Main Menu -> Tools -> Environment options dialog -> Library page -> Library Path edit box
  2. Choose Main menu -> Component -> Install Packages. The dialog window will appear.
  3. Using Add button in that dialog window, add all *BBox*<suffix>.bpl files in <SecureBlackbox>\Packages folder to the list.

Source code (registered version only):

  1. If you have the precompiled (evaluation) version installed, don't uninstall it (that installation includes help files and samples, which are not included in source code installation file).
    To avoid possible version conflict, do the following:
    1. Delete the folder <SecureBlackbox>\Units completely (with all files and subfolders).
    2. Search your disks for files using the following masks: SB*.dcu and *BBox*.bpl.
    3. Delete the files that have been found. This will remove old precompiled files and ensure that no version conflict occurs.
  2. Add <SecureBlackbox>\Sources folder to the list of library folders in Delphi IDE. Library folders are set in:
    • Delphi XE and later: Main Menu -> Tools -> Options dialog -> Environment options -> Delphi Options -> Library -> Library Path edit box
    • C++Builder XE and later: Main Menu -> Tools -> Options dialog -> Environment options -> C++ Options -> Paths and directories -> Library Path edit box
    • Delphi 2005 to RAD Studio 2010: Main Menu -> Tools -> Options dialog > Library - Win 32 -> Library Path edit box
    • C++Builder 2007 to RAD Studio 2010: Main Menu -> Tools -> Options dialog > Library - Win 32 -> Library Path edit box
    • Delphi 6 to Delphi 7: Main Menu -> Tools -> Environment options dialog -> Library page -> Library Path edit box
  3. Open each package source file in <SecureBlackbox>\Packages\SecBBox<suffix>.bpg in IDE. Package files have the following file extension:
    • Delphi 6 to Delphi 7: ".dpk"
    • Delphi 2005 and Delphi 2006: ".bdsproj"
    • Delphi 2007 and later: ".dproj"
    • C++Builder 2007 and later: ".cbproj"
    Alternatively, you can open the corresponding .dpk file, but in this case you will be prompted to "upgrade" or "convert" your package.
  4. Use Install command to compile install the package. In Delphi 5 to Delphi 7 the Install command is available as a button in the package window. In Delphi and C++Builder versions after Delphi 2005 the Install command is accessed via the context menu, that appears when you right-click on the package name in Project Manager in IDE.

S/MIME integration

S/MIME support classes let you sign, encrypt, decrypt and verify S/MIME messages. To use these classes, you need to add SBSMIMECore.pas to your project. This file is located in \Sources folder.

PGP/MIME integration

PGP/MIME support classes that let you sign, encrypt, decrypt and verify PGP/MIME messages, are included in the OpenPGP package. To use these classes, you need to add SBPGPMIME.pas to your project. This file is located in \Sources folder.

Additional packages and sample projects for SSL

SecureBlackbox includes not only SSL classes themselves, but also components and classes that can be used with such libraries and components as Indy, ICS or Delphi Sockets (built-in components shipped with Delphi). As SSLBlackbox installer is not able to determine correctly, which versions of those components you have and you plan to use, pre-compiled packages with SSLBlackbox helper components are not installed automatically.

You need to compile proper packages and install them manually to Delphi IDE.

  • Indy:

    You need to install the packages located in <SecureBlackbox>\Classes\Indy folder.

    If you have Indy 10, install

    • SSLBBoxSrvIndy10D5.dpk for Delphi 5;
    • SSLBBoxSrvIndy10D6.dpk for Delphi 6;
    • SSLBBoxSrvIndy10D7.dpk for Delphi 7;
    • SSLBBoxSrvIndy10D9.dpk for Delphi 2005;
    • SSLBBoxSrvIndy10DX.dpk for Borland Developer Studio 2006;
    • SSLBBoxSrvIndy10D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
    • SSLBBoxSrvIndy10D12.dpk for Delphi 2009 / CodeGear RAD Studio 2009
    • SSLBBoxSrvIndy10D14.dpk for Delphi 2010 / Embarcadero RAD Studio 2010
    • SSLBBoxSrvIndy10D15.dpk for Delphi XE / Embarcadero RAD Studio XE
    • SSLBBoxSrvIndy10D16.dpk for Delphi XE2 / Embarcadero RAD Studio XE2
    • SSLBBoxSrvIndy10D17.dpk for Delphi XE3 / Embarcadero RAD Studio XE3
    • SSLBBoxSrvIndy10D18.dpk for Delphi XE4 / Embarcadero RAD Studio XE4
    • SSLBBoxSrvIndy10D19.dpk for Delphi XE5 / Embarcadero RAD Studio XE5
    • SSLBBoxSrvIndy10D20.dpk for Delphi XE6 / Embarcadero RAD Studio XE6
    • SSLBBoxSrvIndy10D21.dpk for Delphi XE7 / Embarcadero RAD Studio XE7
    • SSLBBoxSrvIndy10D22.dpk for Delphi XE8 / Embarcadero RAD Studio XE8
    • SSLBBoxSrvIndy10D23.dpk for Delphi 10 / Embarcadero RAD Studio 10
    • SSLBBoxSrvIndy10D24.dpk for Delphi 10.1 / Embarcadero RAD Studio 10.1
    • SSLBBoxSrvIndy10D25.dpk for Delphi 10.2 / Embarcadero RAD Studio 10.2
    • SSLBBoxSrvIndy10D26.dpk for Delphi 10.3 / Embarcadero RAD Studio 10.3

    Note, that Indy packages included in Delphi 6 and later distribution have package name "Indy.dpk". Indy packages, shipped with "standalone" (downloadable) versions of Indy have name Indy60 and Indy70 repsectively. If you are using such standalone package, you will need to open SSLBBoxSrvIndy* package (.dpk) file that you want to install and change the reference in "requires" clause from "indy" to "indy60" or "indy70" as needed.

  • ICS:

    You need to install the packages located in <SecureBlackbox>\Classes\ICS folder:

    • SSLBBoxSrvICSV8D5.dpk for Delphi 5;
    • SSLBBoxSrvICSV8D6.dpk for Delphi 6;
    • SSLBBoxSrvICSV8D7.dpk for Delphi 7;
    • SSLBBoxSrvICSV8D9.dpk for Delphi 2005;
    • SSLBBoxSrvICSV8DX.dpk for Borland Developer Studio 2006;
    • SSLBBoxSrvICSV8D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
    • SSLBBoxSrvICSV8D12.dpk for Delphi 2009 / CodeGear RAD Studio 2009
    • SSLBBoxSrvICSV8D14.dpk for Delphi 2010 / Embarcadero RAD Studio 2010
    • SSLBBoxSrvICSV8D15.dpk for Delphi XE / Embarcadero RAD Studio XE
    • SSLBBoxSrvICSV8D16.dpk for Delphi XE2 / Embarcadero RAD Studio XE2
    • SSLBBoxSrvICSV8D17.dpk for Delphi XE3 / Embarcadero RAD Studio XE3
    • SSLBBoxSrvICSV8D18.dpk for Delphi XE4 / Embarcadero RAD Studio XE4
    • SSLBBoxSrvICSV8D19.dpk for Delphi XE5 / Embarcadero RAD Studio XE5
    • SSLBBoxSrvICSV8D20.dpk for Delphi XE6 / Embarcadero RAD Studio XE6
    • SSLBBoxSrvICSV8D21.dpk for Delphi XE7 / Embarcadero RAD Studio XE7
    • SSLBBoxSrvICSV8D22.dpk for Delphi XE8 / Embarcadero RAD Studio XE8
    • SSLBBoxSrvICSV8D23.dpk for Delphi 10 / Embarcadero RAD Studio 10
    • SSLBBoxSrvICSV8D24.dpk for Delphi 10.1 / Embarcadero RAD Studio 10.1
    • SSLBBoxSrvICSV8D25.dpk for Delphi 10.2 / Embarcadero RAD Studio 10.2
    • SSLBBoxSrvICSV8D26.dpk for Delphi 10.3 / Embarcadero RAD Studio 10.3

  • Delphi Sockets:

    You need to install the packages located in <SecureBlackbox>\Classes\Sockets folder:

    • SSLBBoxSrvScktD5.dpk for Delphi 5
    • SSLBBoxSrvScktD6.dpk for Delphi 6
    • SSLBBoxSrvScktD7.dpk for Delphi 7
    • SSLBBoxSrvScktD9.dpk for Delphi 2005
    • SSLBBoxSrvScktDX.dpk for Borland Developer Studio 2006
    • SSLBBoxSrvScktD11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
    • SSLBBoxSrvScktD12.dpk for Delphi 2009 / CodeGear RAD Studio 2009
    • SSLBBoxSrvScktD14.dpk for Delphi 2010 / Embarcadero RAD Studio 2010
    • SSLBBoxSrvScktD15.dpk for Delphi XE / Embarcadero RAD Studio XE
    • SSLBBoxSrvScktD16.dpk for Delphi XE2 / Embarcadero RAD Studio XE2
    • SSLBBoxSrvScktD17.dpk for Delphi XE3 / Embarcadero RAD Studio XE3
    • SSLBBoxSrvScktD18.dpk for Delphi XE4 / Embarcadero RAD Studio XE4
    • SSLBBoxSrvScktD19.dpk for Delphi XE5 / Embarcadero RAD Studio XE5
    • SSLBBoxSrvScktD20.dpk for Delphi XE6 / Embarcadero RAD Studio XE6
    • SSLBBoxSrvScktD21.dpk for Delphi XE7 / Embarcadero RAD Studio XE7
    • SSLBBoxSrvScktD22.dpk for Delphi XE8 / Embarcadero RAD Studio XE8
    • SSLBBoxSrvScktD23.dpk for Delphi 10 / Embarcadero RAD Studio 10
    • SSLBBoxSrvScktD24.dpk for Delphi 10.1 / Embarcadero RAD Studio 10.1
    • SSLBBoxSrvScktD25.dpk for Delphi 10.2 / Embarcadero RAD Studio 10.2
    • SSLBBoxSrvScktD26.dpk for Delphi 10.3 / Embarcadero RAD Studio 10.3

    Note: Delphi 7 and later by default doesn't install Delphi Sockets classes into IDE. If you require the use of these components then you can install the design time package named dclsockets*.bpl, found in your bin directory.

  • RemObjects:

    SSL support for RemObjects is provided via Indy transport. First you need to install Indy packages. Then read the how-to on using SecureBlackbox with RemObjects on SecureBlackbox site. RemObjects doesn't require specific components for SSL support.

  • RealThinClient:

    You need to install the packages located in <SecureBlackbox>\Classes\RealThinClient folder:

    • SSLBBoxSrvRTCD5.dpk for Delphi 5;
    • SSLBBoxSrvRTCD6.dpk for Delphi 6;
    • SSLBBoxSrvRTCD7.dpk for Delphi 7;
    • SSLBBoxSrvRTCD9.dpk for Delphi 2005;
    • SSLBBoxSrvRTCDX.dpk for Borland Developer Studio 2006;
    • SSLBBoxSrvRTCD11.dpk for Delphi 2007 / CodeGear RAD Studio 2007;
    • SSLBBoxSrvRTCD12.dpk for Delphi 2009 / CodeGear RAD Studio 2009;
    • SSLBBoxSrvRTCD14.dpk for Delphi 2010 / Embarcadero RAD Studio 2010;
    • SSLBBoxSrvRTCD15.dpk for Delphi XE / Embarcadero RAD Studio XE
    • SSLBBoxSrvRTCD16.dpk for Delphi XE2 / Embarcadero RAD Studio XE2
    • SSLBBoxSrvRTCD17.dpk for Delphi XE3 / Embarcadero RAD Studio XE3
    • SSLBBoxSrvRTCD18.dpk for Delphi XE4 / Embarcadero RAD Studio XE4
    • SSLBBoxSrvRTCD19.dpk for Delphi XE5 / Embarcadero RAD Studio XE5
    • SSLBBoxSrvRTCD20.dpk for Delphi XE6 / Embarcadero RAD Studio XE6
    • SSLBBoxSrvRTCD21.dpk for Delphi XE7 / Embarcadero RAD Studio XE7
    • SSLBBoxSrvRTCD22.dpk for Delphi XE8 / Embarcadero RAD Studio XE8
    • SSLBBoxSrvRTCD23.dpk for Delphi 10 / Embarcadero RAD Studio 10
    • SSLBBoxSrvRTCD24.dpk for Delphi 10.1 / Embarcadero RAD Studio 10.1
    • SSLBBoxSrvRTCD25.dpk for Delphi 10.2 / Embarcadero RAD Studio 10.2
    • SSLBBoxSrvRTCD26.dpk for Delphi 10.3 / Embarcadero RAD Studio 10.3

Sample projects are built using those helper classes. Before you can open the samples in IDE, you must install helper packages to Delphi IDE.

Additional packages and sample projects for SSH

SecureBlackbox includes not only SSH classes themselves, but also components and classes that can be used with Indy. As SSHBlackbox installer is not able to determine correctly, which versions of Indy you have and you plan to use, pre-compiled packages with SSHBlackbox helper components are not installed automatically.

You need to compile proper packages and install them manually to Delphi IDE. There are 2 sets of Indy SSH components: Indy SSH IOHandlers and IndySSHClient.

  • To install Indy SSH IOHandlers you need to install the packages located in <SecureBlackbox>\Classes\IndySSHIOHandler folder.

    If you have Indy 10, install

    • SSHBBoxSrvIndy10D5.dpk for Delphi 5;
    • SSHBBoxSrvIndy10D6.dpk for Delphi 6;
    • SSHBBoxSrvIndy10D7.dpk for Delphi 7;
    • SSHBBoxSrvIndy10D9.dpk for Delphi 2005;
    • SSHBBoxSrvIndy10DX.dpk for Borland Developer Studio 2006;
    • SSHBBoxSrvIndy10D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
    • SSHBBoxSrvIndy10D12.dpk for Delphi 2009 / CodeGear RAD Studio 2009
    • SSHBBoxSrvIndy10D14.dpk for Delphi 2010 / Embarcadero RAD Studio 2010
    • SSHBBoxSrvIndy10D15.dpk for Delphi XE / Embarcadero RAD Studio XE
    • SSHBBoxSrvIndy10D16.dpk for Delphi XE2 / Embarcadero RAD Studio XE2
    • SSHBBoxSrvIndy10D17.dpk for Delphi XE3 / Embarcadero RAD Studio XE3
    • SSHBBoxSrvIndy10D18.dpk for Delphi XE4 / Embarcadero RAD Studio XE4
    • SSHBBoxSrvIndy10D19.dpk for Delphi XE5 / Embarcadero RAD Studio XE5
    • SSHBBoxSrvIndy10D20.dpk for Delphi XE6 / Embarcadero RAD Studio XE6
    • SSHBBoxSrvIndy10D21.dpk for Delphi XE7 / Embarcadero RAD Studio XE7
    • SSHBBoxSrvIndy10D22.dpk for Delphi XE8 / Embarcadero RAD Studio XE8
    • SSHBBoxSrvIndy10D23.dpk for Delphi 10 / Embarcadero RAD Studio 10
    • SSHBBoxSrvIndy10D24.dpk for Delphi 10.1 / Embarcadero RAD Studio 10.1
    • SSHBBoxSrvIndy10D25.dpk for Delphi 10.2 / Embarcadero RAD Studio 10.2
    • SSHBBoxSrvIndy10D26.dpk for Delphi 10.3 / Embarcadero RAD Studio 10.3

  • To install Indy SSH Client you need to install the packages located in <SecureBlackbox>\Classes\IndySSHIOHandler folder.

    If you have Indy 10, install

    • IdSSHIndy10D5.dpk for Delphi 5;
    • IdSSHIndy10D6.dpk for Delphi 6;
    • IdSSHIndy10D7.dpk for Delphi 7;
    • IdSSHIndy10D9.dpk for Delphi 2005;
    • IdSSHIndy10DX.dpk for Borland Developer Studio 2006;
    • IdSSHIndy10D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
    • IdSSHIndy10D12.dpk for Delphi 2009 / CodeGear RAD Studio 2009
    • IdSSHIndy10D14.dpk for Delphi 2010 / Embarcadero RAD Studio 2010
    • IdSSHIndy10D15.dpk for Delphi XE / Embarcadero RAD Studio XE
    • IdSSHIndy10D16.dpk for Delphi XE2 / Embarcadero RAD Studio XE2
    • IdSSHIndy10D17.dpk for Delphi XE3 / Embarcadero RAD Studio XE3
    • IdSSHIndy10D18.dpk for Delphi XE4 / Embarcadero RAD Studio XE4
    • IdSSHIndy10D19.dpk for Delphi XE5 / Embarcadero RAD Studio XE5
    • IdSSHIndy10D20.dpk for Delphi XE6 / Embarcadero RAD Studio XE6
    • IdSSHIndy10D21.dpk for Delphi XE7 / Embarcadero RAD Studio XE7
    • IdSSHIndy10D22.dpk for Delphi XE8 / Embarcadero RAD Studio XE8
    • IdSSHIndy10D23.dpk for Delphi 10 / Embarcadero RAD Studio 10
    • IdSSHIndy10D24.dpk for Delphi 10.1 / Embarcadero RAD Studio 10.1
    • IdSSHIndy10D25.dpk for Delphi 10.2 / Embarcadero RAD Studio 10.2
    • IdSSHIndy10D26.dpk for Delphi 10.3 / Embarcadero RAD Studio 10.3

    Note, that Indy packages included in Delphi 6 and Delphi 7 distribution have package name "Indy.dpk". Indy packages, shipped with "standalone" (downloadable) versions of Indy have name Indy60 and Indy70 repsectively. If you are using such standalone package, you will need to open SSHBBoxSrvIndy* or IdSSHIndy* package (.dpk) file that you want to install and change the reference in "requires" clause from "indy" to "indy60" or "indy70" as needed.

Sample projects are built using those helper classes. Before you can open the samples in IDE, you must install helper packages to Delphi IDE.

Additional packages and sample projects for SFTP

SecureBlackbox includes SFTP client with Indy-like interface so that you can easier add/replace standard FTP support with SFTP.

You need to compile proper packages and install them manually to Delphi IDE.

  • Indy:

    You need to install the packages located in <SecureBlackbox>\Classes\IndySFTP folder.

    If you have Indy 10, install

    • IdSFTPIndy10D5.dpk for Delphi 5;
    • IdSFTPIndy10D6.dpk for Delphi 6;
    • IdSFTPIndy10D7.dpk for Delphi 7;
    • IdSFTPIndy10D9.dpk for Delphi 2005;
    • IdSFTPIndy10DX.dpk for Borland Developer Studio 2006;
    • IdSFTPIndy10D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
    • IdSFTPIndy10D12.dpk for Delphi 2009 / CodeGear RAD Studio 2009
    • IdSFTPIndy10D14.dpk for Delphi 2010 / Embarcadero RAD Studio 2010
    • IdSFTPIndy10D15.dpk for Delphi XE / Embarcadero RAD Studio XE
    • IdSFTPIndy10D16.dpk for Delphi XE2 / Embarcadero RAD Studio XE2
    • IdSFTPIndy10D17.dpk for Delphi XE3 / Embarcadero RAD Studio XE3
    • IdSFTPIndy10D18.dpk for Delphi XE4 / Embarcadero RAD Studio XE4
    • IdSFTPIndy10D19.dpk for Delphi XE5 / Embarcadero RAD Studio XE5
    • IdSFTPIndy10D20.dpk for Delphi XE6 / Embarcadero RAD Studio XE6
    • IdSFTPIndy10D21.dpk for Delphi XE7 / Embarcadero RAD Studio XE7
    • IdSFTPIndy10D22.dpk for Delphi XE8 / Embarcadero RAD Studio XE8
    • IdSFTPIndy10D23.dpk for Delphi 10 / Embarcadero RAD Studio 10
    • IdSFTPIndy10D24.dpk for Delphi 10.1 / Embarcadero RAD Studio 10.1
    • IdSFTPIndy10D25.dpk for Delphi 10.2 / Embarcadero RAD Studio 10.2
    • IdSFTPIndy10D26.dpk for Delphi 10.3 / Embarcadero RAD Studio 10.3

    Note, that Indy packages included in Delphi 6 and Delphi 7 distribution have package name "Indy.dpk". Indy packages, shipped with "standalone" (downloadable) versions of Indy have name Indy60 and Indy70 repsectively. If you are using such standalone package, you will need to open IdSFTPIndy* package (.dpk) file that you want to install and change the reference in "requires" clause from "indy" to "indy60" or "indy70" as needed.

Discuss this help topic in SecureBlackbox Forum

Copyright (c) 2018, /n software, inc.