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. D4 - Delphi 4
2. D5 - Delphi 5
3. D6 - Delphi 6
4. D7 - Delphi 7
5. D9 - Delphi 2005
6. DX - Delphi 2006 and C++Builder 2006
7. D11 - Delphi 2007
8. D12 - Delphi 2009 (Unicode)
9. D14 - Delphi 2010 (Unicode)
10. D15 - Delphi XE (Unicode)
11. B11 - C++Builder 2007
12. B12 - C++Builder 2009 (Unicode)
13. B14 - C++Builder 2010 (Unicode)
14. B15 - C++Builder XE (Unicode)

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

1. Delphi4 - Delphi 4
2. Delphi5 - Delphi 5
3. Delphi6 - Delphi 6
4. Delphi7 - Delphi 7
5. Delphi9 - Delphi 2005
6. DelphiX - Delphi 2006 and C++Builder 2006
7. Delphi11 - Delphi 2007
8. Delphi12 - Delphi 2009 (Unicode)
9. Delphi14 - Delphi 2010 (Unicode)
10. Delphi15 - Delphi XE (Unicode)
    
11. CBuilder2007 - C++Builder 2007
12. CBuilder2009 - C++Builder 2009 (Unicode)
13. CBuilder2010 - C++Builder 2010 (Unicode)
14. CBuilderXE - C++Builder XE (Unicode)
    
15. FreePascalWin32 - 32-bit units for FreePascal for Windows
16. FreePascalWin64 - 64-bit units for FreePascal for Windows

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 4 to Delphi 7: Main Menu -> Tools -> Environment options dialog -> Library page -> Library Path edit box
   • Delphi 2005 and later: Main Menu -> Tools -> Options dialog > Library - Win 32 -> Library Path edit box
   • C++Builder 2007 and later: Main Menu -> Tools -> Options dialog > Library - Win 32 -> 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.

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 4 to Delphi 7: Main Menu -> Tools -> Environment options dialog -> Library page -> Library Path edit box
   • Delphi 2005 and later: Main Menu -> Tools -> Options dialog > Library - Win 32 -> Library Path edit box
   • C++Builder 2007 and later: Main Menu -> Tools -> Options dialog > Library - Win 32 -> Library Path edit box
3. Open each package source file in <SecureBlackbox>\Packages\SecBBoxD4.bpg in IDE. Package files have the following file extension:
   • Delphi 4 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 4 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 OpenPGPBlackbox. 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 8, install
  • SSLBBoxSrvIndy8D4.dpk for Delphi 4;
  • SSLBBoxSrvIndy8D5.dpk for Delphi 5;
  • SSLBBoxSrvIndy8D6.dpk for Delphi 6;
  • SSLBBoxSrvIndy8D7.dpk for Delphi 7;
  • SSLBBoxSrvIndy8D9.dpk for Delphi 2005;
  • SSLBBoxSrvIndy8DX.dpk for Borland Developer Studio 2006;
  • SSLBBoxSrvIndy8D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
  If you have Indy 9, install
  • SSLBBoxSrvIndy9D4.dpk for Delphi 4;
  • SSLBBoxSrvIndy9D5.dpk for Delphi 5;
  • SSLBBoxSrvIndy9D6.dpk for Delphi 6;
  • SSLBBoxSrvIndy9D7.dpk for Delphi 7;
  • SSLBBoxSrvIndy9D9.dpk for Delphi 2005;
  • SSLBBoxSrvIndy9DX.dpk for Borland Developer Studio 2006;
  • SSLBBoxSrvIndy9D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
  • SSLBBoxSrvIndy9D12.dpk for Delphi 2009 / CodeGear RAD Studio 2009
  If you have Indy 10, install
  • SSLBBoxSrvIndy10D4.dpk for Delphi 4;
  • 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
  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:
  • SSLBBoxSrvICSV7D4.dpk for Delphi 4;
  • SSLBBoxSrvICSV7D5.dpk for Delphi 5;
  • SSLBBoxSrvICSV7D6.dpk for Delphi 6;
  • SSLBBoxSrvICSV7D7.dpk for Delphi 7;
  • SSLBBoxSrvICSV7D9.dpk for Delphi 2005;
  • SSLBBoxSrvICSV7DX.dpk for Borland Developer Studio 2006;
  • SSLBBoxSrvICSV7D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
  • SSLBBoxSrvICSDV712.dpk for Delphi 2009 / CodeGear RAD Studio 2009
  • SSLBBoxSrvICSDV714.dpk for Delphi 2010 / Embarcadero RAD Studio 2010
  • SSLBBoxSrvICSDV715.dpk for Delphi XE / Embarcadero RAD Studio XE
  
  
• Delphi Sockets:
  You need to install the packages located in <SecureBlackbox>\Classes\Sockets folder:
  • SSLBBoxSrvScktD4.dpk for Delphi 4;
  • SSLBBoxSrvScktD5.dpk for Delphi 5;
  • SSLBBoxSrvScktD6.dpk for Delphi 6;
  • SSLBBoxSrvScktD7.dpk for Delphi 7. Note: Delphi 7 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 dclsockets70.bpl, found in your bin directory.
  • SSLBBoxSrvScktD9.dpk for Delphi 2005. Note: Delphi 2005 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 dclsockets90.bpl, found in your bin directory.
  • SSLBBoxSrvScktDX.dpk for Borland Developer Studio 2006. Note: BDS 2006 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 dclsockets100.bpl, found in your bin directory.
  • SSLBBoxSrvScktD11.dpk for Delphi 2007 / CodeGear RAD Studio 2007. Note: Delphi 2007 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 dclsockets110.bpl, found in your bin directory.
  • SSLBBoxSrvScktD12.dpk for Delphi 2009 / CodeGear RAD Studio 2009. Note: Delphi 2009 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 dclsockets120.bpl, found in your bin directory.
  • SSLBBoxSrvScktD14.dpk for Delphi 2010 / Embarcadero RAD Studio 2010. Note: Delphi 2010 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 dclsockets140.bpl, found in your bin directory.
  • SSLBBoxSrvScktD15.dpk for Delphi XE / Embarcadero RAD Studio XE. Note: Delphi XE 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 dclsockets140.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.
  
  
• kbmMW:
  
  You need to install the packages located in <SecureBlackbox>\Classes\kbmMW folder:
  • ElkbmMWServerD5.dpk for Delphi 5;
  • ElkbmMWServerD6.dpk for Delphi 6;
  • ElkbmMWServerD7.dpk for Delphi 7;
  • ElkbmMWServerD9.dpk for Delphi 2005;
  • ElkbmMWServerDX.dpk for Borland Developer Studio 2006
  • ElkbmMWServerD11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
  • ElkbmMWServerD12.dpk for Delphi 2009 / CodeGear RAD Studio 2009
  • ElkbmMWServerD14.dproj for Delphi 2010 / Embarcadero RAD Studio 2010
  • ElkbmMWServerD15.dproj for Delphi XE / Embarcadero RAD Studio XE
  
  Read the article Using SecureBlackbox with kbmMW for information about using SecureBlackbox with kbmMW.
  
  
• NexusDB:
  If you have NexusDB 3.x, install one of the packages located in <SecureBlackbox>\Classes\Nexus\DB3 as follows:
  • SBNexusDB3D7.dpk for Delphi 7;
  • SBNexusDB3D9.dpk for Delphi 2005;
  • SBNexusDB3DX.dpk for Borland Developer Studio 2006;
  • SBNexusDB3D11.dpk for for Delphi 2007 / CodeGear RAD Studio 2007;
  • SBNexusDB3D12.dpk for Delphi 2009 / CodeGear RAD Studio 2009;
  • SBNexusDB3D14.dpk for Delphi 2010 / Embarcadero RAD Studio 2010;
  • SBNexusDB3D15.dpk for Delphi XE / Embarcadero RAD Studio XE
  If you have NexusDB 2.x, install one of the packages located in <SecureBlackbox>\Classes\Nexus\DB2 as follows:
  • SBNexusDB2D4.dpk for Delphi 4;
  • SBNexusDB2D5.dpk for Delphi 5;
  • SBNexusDB2D6.dpk for Delphi 6;
  • SBNexusDB2D7.dpk for Delphi 7;
  • SBNexusDB2D9.dpk for Delphi 2005;
  • SBNexusDB2DX.dpk for Borland Developer Studio 2006
  If you have NexusDB 1.x, install one of the packages located in <SecureBlackbox>\Classes\Nexus\DB1 as follows:
  • sbnexusD4.dpk for Delphi 4;
  • sbnexusD5.dpk for Delphi 5;
  • sbnexusD6.dpk for Delphi 6;
  • sbnexusD7.dpk for Delphi 7;
  • sbnexusD9.dpk for Delphi 2005;
  • sbnexusDX.dpk for Borland Developer Studio 2006
  
  Read the article SSL transports for NexusDB for information about using SecureBlackbox with NexusDB.
  
  
• RealThinClient:
  
  You need to install the packages located in <SecureBlackbox>\Classes\RealThinClient folder:
  • SSLBBoxSrvRTCD4.dpk for Delphi 4;
  • 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

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 9, install
  • SSHBBoxSrvIndy9D4.dpk for Delphi 4;
  • SSHBBoxSrvIndy9D5.dpk for Delphi 5;
  • SSHBBoxSrvIndy9D6.dpk for Delphi 6;
  • SSHBBoxSrvIndy9D7.dpk for Delphi 7;
  • SSHBBoxSrvIndy9D9.dpk for Delphi 2005;
  • SSHBBoxSrvIndy9DX.dpk for Borland Developer Studio 2006;
  • SSHBBoxSrvIndy9D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
  If you have Indy 10, install
  • SSHBBoxSrvIndy10D4.dpk for Delphi 4;
  • 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
• To install Indy SSH Client you need to install the packages located in <SecureBlackbox>\Classes\IndySSHIOHandler folder.
  If you have Indy 9, install
  • IdSSHIndy9D4.dpk for Delphi 4;
  • IdSSHIndy9D5.dpk for Delphi 5;
  • IdSSHIndy9D6.dpk for Delphi 6;
  • IdSSHIndy9D7.dpk for Delphi 7;
  • IdSSHIndy9D9.dpk for Delphi 2005;
  • IdSSHIndy9DX.dpk for Borland Developer Studio 2006;
  • IdSSHIndy9D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
  If you have Indy 10, install
  • IdSSHIndy10D4.dpk for Delphi 4;
  • 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
  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 9, install
  • IdSFTPIndy9D4.dpk for Delphi 4;
  • IdSFTPIndy9D5.dpk for Delphi 5;
  • IdSFTPIndy9D6.dpk for Delphi 6;
  • IdSFTPIndy9D7.dpk for Delphi 7;
  • IdSFTPIndy9D9.dpk for Delphi 2005;
  • IdSFTPIndy9DX.dpk for Borland Developer Studio 2006;
  • IdSFTPIndy9D11.dpk for Delphi 2007 / CodeGear RAD Studio 2007
  If you have Indy 10, install
  • IdSFTPIndy10D4.dpk for Delphi 4;
  • 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
  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.