Plugin Pour Le Cryptage Des Données Transmises Sur Le Réseau

IXpbBuilder

Interface IXpbBuilder

clear
```
void clear(StatusType* status)
```
Réinitialise le constructeur à un état vide.
removeCurrent
```
void removeCurrent(StatusType* status)
```
Supprime le clumplet en cours.
insertInt
```
void insertInt(StatusType* status, unsigned char tag, int value)
```
Insère un agrégat avec une valeur qui représente un entier dans le format réseau.
insertBigInt
```
void insertBigInt(StatusType* status, unsigned char tag, ISC_INT64 value)
```
Insère un agrégat avec une valeur qui représente un entier 64 bits au format réseau.

insertBytes

void insertBytes(StatusType* status, unsigned char tag, const void* bytes, unsigned length)

Insère un clumpet avec une valeur qui contient les octets passés.

insertTag

void insertTag(StatusType* status, unsigned char tag)

Insère un clumpet sans valeur.

isEof
```
FB_BOOLEAN isEof(StatusType* status)
```
Vérifie s`il y a un clumpet actuelle.
moveNext
```
void moveNext(StatusType* status)
```
Passe au clumpet suivant.
rewind
```
void rewind(StatusType* status)
```
Se positionne sur le premier clumpet

findFirst

FB_BOOLEAN findFirst(StatusType* status, unsigned char tag)

Trouve le premier clumpet avec cette balise.

findNext
```
FB_BOOLEAN findNext(StatusType* status)
```
Recherche le clumpet suivant avec la balise spécifiée.

getTag

unsigned char getTag(StatusType* status)

Renvoie la balise du clumpet courant.

getLength
```
unsigned getLength(StatusType* status)
```
Renvoie la longueur de la valeur actuel du clumpet.
getInt
```
int getInt(StatusType* status)
```
Renvoie la valeur du clumpet courant sous forme d’un entier.
getBigInt
```
SC_INT64 getBigInt(StatusType* status)
```
Renvoie la valeur du clumpet courant sous forme d’un 64 bits.
getString
```
const char* getString(StatusType* status)
```
Renvoie la valeur de l’agrégat courant sous la forme d’un pointeur vers une chaîne de terminaisons null (le pointeur est valide jusqu’au prochain appel de cette méthode).
getBytes
```
const unsigned char* getBytes(StatusType* status)
```
Renvoie la valeur du clumpet courant sous la forme d’un pointeur vers unsigned char.
getBufferLength
```
unsigned getBufferLength(StatusType* status)
```
Renvoie la longueur du bloc de paramètres.
getBuffer
```
const unsigned char* getBuffer(StatusType* status)
```
Renvoie un pointeur vers le bloc de paramètres.

Constantes définies par l’interface IXpbBuilder

Types de constructeurs valides :

BATCH (IBatch parameters block)
BPB (BLOB parameters block)
DPB (database attachment parameters block)
SPB_ATTACH (service attachment parameters block)
SPB_START (start service parameters)
SPB_SEND (send items in IService::query())
SPB_RECEIVE (receive items in IService::query())
SPB_RESPONSE (response from IService::query())
TPB (transaction parameters block)

Plugin pour le cryptage des données transmises sur le réseau

Les algorithmes permettant de crypter des données à différentes fins sont bien connus depuis de nombreuses années. Le seul "petit" problème typique qui subsiste est de savoir où obtenir la clé top secrète utilisée par cet algorithme. Heureusement, pour le cryptage du trafic réseau, il existe une bonne solution : une clé de cryptage unique doit être générée par le plugin d’authentification. Au moins, le plugin SRP par défaut peut produire une telle clé. Et cette clé est résistante aux attaques, y compris celles de type "man-in-the-middle". C’est pourquoi une méthode a été choisie pour fournir des clés au plugin wire crypt : les obtenir du plugin d’authentification. (Dans le cas où le plugin d’authentification utilisé ne peut pas fournir de clé, un pseudo-plugin peut être ajouté dans les listes AuthClient et AuthServer pour produire des clés, quelque chose comme deux paires privées/publiques asymétriques).

ICryptKey

L’interface ICryptKey est utilisée pour stocker la clé fournie par le plugin d’authentification et la transmettre au plugin de chiffrement du trafic réseau. Cette interface doit être utilisée de la manière suivante : lorsque le plugin d’authentification du serveur ou du client est prêt à fournir une clé, il demande IServerBlock ou IClientBlock pour créer une nouvelle interface ICryptKey et y stocke la clé. Un type de clé adapté à IWireCryptPlugin sera sélectionné par Firebird et passé à cette interface.

setSymmetric

void setSymmetric(StatusType* status,
                  const char* type,
                  unsigned keyLength,
                  const void* key)

Stocke une clé symétrique du type spécifié.

setAsymmetric

void setAsymmetric(StatusType* status,
                   const char* type,
                   unsigned encryptKeyLength,
                   const void* encryptKey,
                   unsigned decryptKeyLength,
                   const void* decryptKey)

Stocke une paire de clés asymétriques du type spécifié.

getEncryptKey

const void* getEncryptKey(unsigned* length)

Renvoie la clé de chiffrement.

getDecryptKey
```
const void* getDecryptKey(unsigned* length))
```
renvoie la clé à déchiffrer (dans le cas d’une clé symétrique, le résultat est le même que getEncryptKey()).