Encrypt data BLOB
Encrypt data BLOB ( blobToEncrypt ; keyObject | passPhrase ; salt ; encryptedBLOB ) : Boolean
| Paramètre | Type | Description | |
|---|---|---|---|
| blobToEncrypt | Blob | → | BLOB à encrypter |
| keyObject | passPhrase | Objet, Texte | → | Objet JSON contenant la clé de chiffrement ou le mot de passe pour une génération directe de clé de chiffrement (texte) |
| salt | Integer | → | Additional salt for algorithm |
| encryptedBlob | Blob | ← | BLOB encrypté |
| Résultat | Boolean | ← | True si le chiffrement a été effectué correctement. Sinon False |
Description
La commande Encrypt data BLOBencrypte le paramètre blobToEncrypt avec le même algorithme utilisé par 4D pour encrypter les données (AES-256) et retourne le résultat dans encryptedBlob..
Vous pouvez utiliser un paramètre keyObject ou un passPhrase pour encrypter le BLOB :
- keyObject : un objet JSON contenant la clé de chiffrement, avec la même structure que l'objet retourné par la commande New data key
- passPhrase : une chaîne utilisée pour générer la clé de chiffrement
Passez dans salt le nombre qui sera utilisé pour renforcer le chiffrement.
Si le chiffrement est réussi, les données chiffrées sont retournées dans le paramètre encryptedBlob et la commande retourne True.
En cas d'erreur, le BLOB est retourné vide et la commande retourne false.
Note : Lorsque vous cryptez un objet blob à l'aide de Encrypt data BLOB, l'encryptedBlob résultant est un multiple de 16 octets en raison de l'algorithme d'encription. Par conséquent, si blobToEncrypt n'est pas un multiple de 16 octets, la commande le transforme automatiquement en un multiple de 16 octets en ajoutant des octets nuls à la fin. Pour éviter les erreurs lors du déchiffrement du blob avec Decrypt data BLOB, vous devez gérer la taille de blobToEncrypt lorsque vous travaillez avec des fichiers autres que des fichiers texte. Pour un exemple détaillé sur la façon de procéder, consultez cet article de blog.
Exemple
Cryptez un fichier texte situé dans le dossier RESSOURCES de la base de données :
var $fileToEncrypt;$encryptedFile : 4D.File
var $blobToEncrypt;$encryptedBlob : Blob
var $result : Boolean
$fileToEncrypt:=File("/RESOURCES/confidential.txt")
$encryptedFile:=File("/RESOURCES/encryptedConfidential.txt")
$blobToencrypt:=$fileToEncrypt.getContent()
$result:=Encrypter donnees BLOB($blobToEncrypt;"myPassPhrase";MAXLONG;$encryptedBlob)
$encryptedFile.setContent($encryptedBlob)
Voir aussi
Decrypt data BLOB
ENCRYPT BLOB
Encrypt data file
New data key
Propriétés
| Numéro de commande | 1773 |
| Thread safe | ✓ |