meta data for this page
  •  

ibec_RegisterFBCryptKey

Description

No additional description…

Syntax

  function ibec_RegisterFBCryptKey(KeyName : string; KeyData : string; FBCryptDLLPath : string) : integer;
  

The ibec_RegisterFBCryptKey function registers a key to allow work with an encrypted Firebird database (Firebird 3).

Parameters

KeyName The key name should match the one used in the ALTER DATABASE ENCRYPT WITH “DbCrypt” KEY NAME operator.
KeyData Key bytes sequence.
FBCryptDLLPath Currently not used, reserved for future use.

There are three ways to specify the key bytes sequence:

1.  ibec_RegisterFBCryptKey('Red', '$ec$a1$52$f6$4d$27$da$93...', '')
2. ibec_RegisterFBCryptKey('Green', '0xab,0xd7,0x34,0x63,0xae,0x19,...', '');
3. ibec_RegisterFBCryptKey('Raw', 'just a plain string', '');

It is possible to register more than one key (they should have different names).

The ibec_RegisterFBCryptKey function registers a key within the IBExpert/IBEScript process. Specified keys will be registered on the server if the key not set error appears when connecting to a database.

ibec_RegisterFBCryptKey requires FBCrypt.dll on the client side. DBCrypt.dll and KeyHolder.dll (plugins) should be installed and configured on the server side.

There are several ways to call ibec_RegisterDBCryptKey before connecting to a database:

1. Include it into the //After IBExpert Starts script// (//Options / Environment Options//).
2. Include it into the //Before Connect Script// of a database (//Database Registration Info//).
3. Include it into the After //IBExpert Starts// event block (//DB Explorer / Blocks / Create/Edit event block// in the context menu).

Example