F.25. pgcrypto

    digest(data text, type text) returns bytea
    digest(data bytea, type text) returns bytea
   

Calcule un hachage binaire de data. type est l'algorithme utilis�. Les algorithmes standards sont md5 et sha1. Si pgcrypto a �t� construit avec OpenSSL, d'autres algorithmes sont disponibles comme le d�taille Tableau F.18, � R�sum� de fonctionnalit�s avec et sans OpenSSL �.

Si vous voulez en r�sultat une cha�ne hexad�cimale, utilisez encode() sur le r�sultat. Par exemple :

    CREATE OR REPLACE FUNCTION sha1(bytea) returns text AS $$
      SELECT encode(digest($1, 'sha1'), 'hex')
    $$ LANGUAGE SQL STRICT IMMUTABLE;
   

    hmac(data text, key text, type text) returns bytea
    hmac(data bytea, key text, type text) returns bytea
   

Calcule un MAC hach� sur data avec la cl� key. type est identique � digest().

C'est similaire � digest() mais le hachage peut �tre recalcul� en connaissant seulement la cl�. Ceci �vite le sc�nario o� quelqu'un modifie les donn�es et le hachage en m�me temps.

Si la cl� est plus grosse que le bloc hach�, il sera tout d'abord hach� puis le r�sultat sera utilis� comme cl�.

    crypt(password text, salt text) returns text
   

Calcule un hachage de mot de passe (password) d'apr�s crypt(3) UN*X. Lors du stockage d'un nouveau mot de passe, vous devez utiliser la fonction gen_salt() pour g�n�rer un nouveau sel (salt). Lors de la v�rification de mot de passe, passez la valeur hach�e stock�e salt, et testez si le r�sultat correspond � la valeur stock�e.

Exemple d'ajout d'un nouveau mot de passe :

    UPDATE ... SET pswhash = crypt('new password', gen_salt('md5'));
   

Exemple d'authentification :

    SELECT pswhash = crypt('entered password', pswhash) FROM ... ;
   

Ceci renvoie true si le mot de passe saisi est correct.

    gen_salt(type text [, iter_count integer ]) returns text
   

G�n�re une nouvelle valeur al�atoire sel pour son utilisation avec crypt(). La cha�ne sel indique aussi � crypt() l'algorithme � utiliser.

Le param�tre type pr�cise l'algorithme de hachage. Les types accept�es sont : des, xdes, md5 et bf.

Le param�tre iter_count laisse l'utilisateur indiquer le nombre d'it�ration, pour les algorithmes qui en ont. Plus le nombre est important, plus le hachage du mot de passe prendra du temps, et du coup plus le craquage du mot de passe prendre du temps. Cela �tant dit, un nombre trop important rend pratiquement impossible le calcul du hachage. Si le param�tre iter_count est omis, le nombre d'it�ration par d�faut est utilis�. Les valeurs autoris�es pour iter_count d�pendent de l'algorithme et sont affich�es dans Tableau F.16, � Nombre d'it�ration pour crypt() �.

Pour xdes, il existe une limite suppl�mentaire qui fait que ce nombre doit �tre un nombre impair.

Pour utiliser un nombre d'it�ration appropri�, pensez que la fonction crypt DES original a �t� con�u pour avoir la vitesse de quatre hachages par seconde sur le mat�riel de l'�poque. Plus lent que quatre hachages par secondes casserait probablement la facilit� d'utilisation. Plus rapide que cent hachages � la seconde est probablement trop rapide.

Tableau F.17, � Vitesse de l'algorithm de hachage � donne un aper�u de la lenteur relative de diff�rents algorithmes de hachage. La table montre le temps que prendrait le calcul de toutes les combinaisons r�alisables pour un mot de passe sur huit caract�res, en supposant que le mot de passe contient soit que des lettres minuscules, soit des lettres minuscules et majuscules et des chiffres. Dans les entr�es crypt-bf, le nombre apr�s un slash est le param�tre iter_count de gen_salt.

Notes :

Notez que � tenter toutes les combinaisons � n'est pas un exercice r�aliste. Habituellement, craquer les mots de passe se fait avec l'aide de dictionnaires contenant les mots standards et diff�rentes variantes. Donc, m�me des mots de passe qui ressemblent vaguement � des mots peuvent �tre craqu�s plus rapidement que les nombres ci-dessus le sugg�rent alors qu'un mot de passe sur six caract�res qui ne ressemble pas � un mot pourrait ne pas �tre craqu�.

    pgp_sym_encrypt(data text, psw text [, options text ]) returns bytea
    pgp_sym_encrypt_bytea(data bytea, psw text [, options text ]) returns bytea
   

Chiffre data avec une cl� PGP sym�trique psw. Le param�tre options peut contenir des options d�crites ci-dessous.

    pgp_sym_decrypt(msg bytea, psw text [, options text ]) returns text
    pgp_sym_decrypt_bytea(msg bytea, psw text [, options text ]) returns bytea
   

D�chiffre un message PGP chiffr� avec une cl� sym�trique.

D�chiffrer des donn�es bytea avec pgp_sym_decrypt est interdit. Ceci a pour but d'�viter la sortie de donn�es de type caract�re invalides. D�chiffrer des donn�es textuelles avec pgp_sym_decrypt_bytea ne pose pas de probl�me.

Le param�tre options peut contenir les param�tres d�crits ci-dessous.

    pgp_pub_encrypt(data text, key bytea [, options text ]) returns bytea
    pgp_pub_encrypt_bytea(data bytea, key bytea [, options text ]) returns bytea
   

Chiffre data avec la cl� PGP publique key. Avec cette fonction, une cl� priv�e renverra une erreur.

Le param�tre options peut contenir des options d�crites ci-dessous.

    pgp_pub_decrypt(msg bytea, key bytea [, psw text [, options text ]]) returns text
    pgp_pub_decrypt_bytea(msg bytea, key bytea [, psw text [, options text ]]) returns bytea
   

D�chiffre un message chiffr� avec une cl� publique. key doit �tre la cl� secr�te correspondant � la cl� publique utilis�e pour chiffrer. Si la cl� secr�te est prot�g�e par un mot de passe, vous devez saisir le mot de passe dans psw. S'il n'y a pas de mot de passe mais que vous devez indiquer des options, vous devez saisir un mot de passe vide.

D�chiffrer des donn�es bytea avec pgp_pub_decrypt est interdit. Ceci a pour but d'�viter la sortie de donn�es de type caract�re invalides. D�chiffrer des donn�es textuelles avec pgp_pub_decrypt_bytea ne pose pas de probl�me.

Le param�tre options peut contenir des options d�crites ci-dessous.

    pgp_key_id(bytea) returns text
   

pgp_key_id extrait l'identifiant de la cl� pour une cl� PGP publique ou secr�te. Ou il donne l'identifiant de la cl� utilis� pour chiffrer les donn�es si un message chiffr� est fourni.

Elle peut renvoyer deux identifiants de cl�s sp�ciaux :

Notez que des cl�s diff�rentes peuvent avoir le m�me identifiant. C'est rare mais normal. L'application client doit alors essayer de d�chiffer avec chacune d'elle pour voir laquelle correspond -- ce qui revient � la gestion de ANYKEY.

    armor(data bytea) returns text
    dearmor(data text) returns bytea
   

Ces fonctions enveloppent les donn�es dans une armure ASCII PGP qui est basiquement en Base64 avec CRC et un formatage suppl�mentaire.

Les options sont nomm�es de fa�on similaires � GnuPG. Les valeurs sont fournies apr�s un signe d'�galit� ; les options sont s�par�es par des virgules. Par exemple :

    pgp_sym_encrypt(data, psw, 'compress-algo=1, cipher-algo=aes256')
   

Toutes les options en dehors de convert-crlf s'appliquent seulement aux fonctions de chiffrement. Les fonctions de d�chiffrement obtiennent des param�tres des donn�es PGP.

Les options les plus int�ressantes sont problablement compression-algo et unicode-mode. Le reste doit avoir des valeurs par d�faut raisonnables.

Pour g�n�rer une nouvelle cl� :

   gpg --gen-key
  

Le type de cl� pr�f�r� est � DSA and Elgamal �.

Pour le chiffrement RSA, vous devez cr�er soit une cl� de signature seulement DSA ou RSA en tant que ma�tre, puis ajouter la sous-cl� de chiffrement RSA avec gpg --edit-key.

Pour lister les cl�s :

   gpg --list-secret-keys
  

Pour exporter une cl� publique dans un format armure ASCII :

   gpg -a --export KEYID > public.key
  

Pour exporter une cl� secr�te dans un format armure ASCII :

   gpg -a --export-secret-keys KEYID > secret.key
  

Vous avez besoin d'utiliser la fonction dearmor() sur ces cl�s avant de les passer aux fonctions PGP. Ou si vous g�rez des donn�es binaires, vous pouvez supprimer l'option -a pour la commande.

Pour plus de d�tails, voir la page de r�f�rence de gpg, le livre � GNU Privacy Handbook � et d'autres documents sur le site gnupg.org.

pgcrypto se configure lui-m�me suivant les d�couvertes du scrip configure principal de PostgreSQL. Les options qui l'affectent sont --with-zlib et --with-openssl.

Quand il est compil� avec zlib, les fonctions de chiffrement PGP peuvent compresser les donn�es avant chiffrement.

Quand il est compil� avec OpenSSL, plus d'algorithmes seront disponibles. De plus, les fonctions de chiffrement � cl� publique seront plus rapides car OpenSSL a des fonctions BIGNUM plus optimis�es.

Notes :

Comme le standard SQL le demande, toutes les fonctions renvoient NULL si un des arguments est NULL. Cela peut permettre une faille de s�curit� si c'est utilis� sans pr�caution.

Toutes les fonctions de pgcrypto sont ex�cut�es au sein du serveur de bases de donn�es. Cela signifie que toutes les donn�es et les mots de passe sont pass�s entre pgcrypto et l'application client en texte clair. Donc, vous devez :

Si vous ne le pouvez pas, alors il est pr�f�rable de chiffrer directement au sein de l'application client.