DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de cryptage/compression
  • Résultats obtenus lors d'un chiffrement AES
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Crypte une chaîne de caractères ou un buffer binaire en utilisant un algorithme de chiffrement symétrique (AES, DES, etc.). Ce message crypté pourra être décrypté avec la fonction DécrypteStandard.
Contrairement aux fonctions Crypte et Décrypte, les fonctions CrypteStandard et DécrypteStandard utilisent des algorithmes de cryptage standard qui permettent d'échanger des messages cryptés entre des plateformes d'exécution différentes (Windows, Linux, Android, Java, iOS, PHP, etc.) et/ou avec des outils tiers.
Remarque : Le premier appel à la fonction CrypteStandard peut être relativement long car il est nécessaire d'initialiser la randomisation.
// Cryptage d'une chaîne de caractères en utilisant l'algorithme AES
// ------------------------------------------------------------------
bufMessage est un Buffer = "Message à crypter"
bufClé est un Buffer = HashChaîne(HA_MD5_128, "mot de passe")
bufCrypte est un Buffer = CrypteStandard(bufMessage, bufClé, crypteAES128)
 
// Décryptage en WLangage
-------------------------
bufRésultat est un Buffer = DécrypteStandard(bufCrypte, bufClé, crypteAES128)
Info(bufRésultat)
// Cryptage en WLangage
// ---------------------
bufMessage est un Buffer = "Message à crypter"
bufClé est un Buffer = HashChaîne(HA_MD5_128, "ma chaîne à crypter")
bufCrypte est un Buffer = CrypteStandard(bufMessage, bufClé, crypteAES128)
 
//---------------------------------------------------------------
// Décryptage via un appel à l'API Mcrypt de PHP
nTailleIV est un entier = 128 / 8
bufIV est un Buffer = bufCrypte[[ À nTailleIV]]
bufDonnées est un Buffer = bufCrypte[[nTailleIV+1 À]]
 
EXTERNE mcrypt_decrypt//API PHP (à faire dans un traitement serveur WEBDEV PHP)
Trace(mcrypt_decrypt("rijndael-128", bufClé, bufDonnées, "cbc", bufIV))
Syntaxe
<Résultat> = CrypteStandard(<Message> , <Clé> [, <Algorithme> [, <Mode d'opération> [, <Remplissage> [, <Vecteur d'initialisation>]]]])
<Résultat> : Buffer binaire
  • Résultat du cryptage du message spécifié,
  • Chaîne vide ("") en cas d'erreur. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
Ce buffer est composé de deux parties :
  • Le vecteur d'initialisation (Initialisation Vector ou IV) qui correspond à un bloc de bits généré aléatoirement (ou précisé avec le paramètre <Vecteur d'initialisation>) et qui a été combiné au premier bloc des données cryptées. Ce vecteur est nécessaire pour permettre le décryptage du message. Sa taille correspond à la taille des blocs utilisés par l'algorithme de cryptage (voir paramètre <Algorithme>).
  • Les données cryptées.
Si le message doit être décrypté :
  • par la fonction DécrypteStandard, il suffit de passer l'intégralité du buffer à la fonction.
  • par un outil tiers, il est nécessaire de découper le buffer pour séparer le vecteur d'initialisation des données cryptées (voir exemple).
Remarque : Si le mode d'opération spécifié est crypteECB, aucun vecteur d'initialisation n'est utilisé et dans ce cas la fonction retourne directement les données cryptées.
<Message> : Buffer binaire
Message à crypter.
<Clé> : Buffer
Clé avec laquelle les données doivent être cryptées. La taille de cette clé dépend de l'algorithme de cryptage utilisé. La taille de la clé doit correspondre à celle de l'algorithme.
Il est conseillé d'utiliser les fonctions de hachage (par exemple fonction HashChaîne) pour créer une clé à partir d'un mot de passe. Un mot de passe long et composé d'un maximum de caractères alphanumériques et symboles distincts permet une meilleure sécurité de cryptage.
Développement multiplateforme : Pour manipuler des chaînes de caractères, il est nécessaire d'utiliser le même format sur toutes les plateformes. Il est conseillé d'utiliser des chaînes au format UTF 8 (et de convertir les chaînes Unicode si nécessaire).
<Algorithme> : Constante optionnelle de type Entier
Algorithme de cryptage à utiliser :
crypte3DESTriple Data Encryption Standard.
  • Taille de la clé : 192 bits.
  • Taille des blocs : 64 bits.
  • Taille du vecteur d'initialisation (IV) : 64 bits.
crypteAES128
(Valeur par défaut)
Advanced Encryption Standard.
  • Taille de la clé : 128 bits.
  • Taille des blocs : 128 bits.
  • Taille du vecteur d'initialisation (IV) : 128 bits.
Nouveauté SaaS
crypteAES192
Advanced Encryption Standard.
  • Taille de la clé : 192 bits.
  • Taille des blocs : 128 bits.
  • Taille du vecteur d'initialisation (IV) : 128 bits.
AndroidWidget AndroidJavaPHP Cette constante n'est pas disponible.
crypteAES256Advanced Encryption Standard.
  • Taille de la clé : 256 bits.
  • Taille des blocs : 128 bits.
  • Taille du vecteur d'initialisation (IV) : 128 bits.
crypteDESData Encryption Standard.
  • Taille de la clé : 64 bits.
  • Taille des blocs : 64 bits.
  • Taille du vecteur d'initialisation (IV) : 64 bits.
Attention : cet algorithme est actuellement déprécié.
<Mode d'opération> : Constante optionnelle de type Entier
Mode de traitement des blocs par l'algorithme de cryptage :
crypteCBC
(Valeur par défaut)
Cipher Block Chaining - Enchaînement des blocs
crypteCFBCipher Feedback - Chiffrement à rétroaction.
Nouveauté SaaS
Désormais, ce mode de traitement est disponible quel que soit l'algorithme utilisé.
AndroidWidget AndroidJavaPHP Cette constante n'est pas disponible.
crypteCTRCipher Counter - Chiffrement basé sur un compteur.
Nouveauté SaaS
Désormais, ce mode de traitement est disponible quel que soit l'algorithme utilisé.
AndroidWidget AndroidJavaPHP Cette constante n'est pas disponible.
crypteECBElectronic Code Book - Dictionnaire de codes. Ce mode d'opération est déconseillé et ne devrait être utilisé que pour des raisons de compatibilité.
Aucun vecteur d'initialisation n'est utilisé et dans ce cas la fonction retourne directement les données cryptées.
<Remplissage> : Constante optionnelle de type Entier
Mode de remplissage des données cryptées pour être compatibles avec la taille requise par les algorithmes de cryptage par blocs :
cryptePaddingPKCS
(Valeur par défaut)
Les données sont complétées par des octets dont la valeur correspond au nombre total d'octets ajoutés pour atteindre la taille requise.
cryptePaddingZéroLes données sont complétées par des zéros binaires jusqu'à obtenir la taille requise.
<Vecteur d'initialisation> : Buffer optionnel
Vecteur d'initialisation (IV) à utiliser pour le chiffrement. La taille du buffer dépend de l'algorithme de chiffrement choisi (paramètre <Algorithme>). Si ce paramètre n'est pas précisé, le vecteur d'initialisation est généré aléatoirement.
Attention : Ce paramètre doit être utilisé seulement si vous avez besoin d'un vecteur d'initialisation personnalisé dans votre projet. Dans le cas contraire, il est fortement conseillé de conserver la génération du vecteur d'initialisation en mode aléatoire.
PHP Ce paramètre n'est pas disponible.
Remarques

Résultats obtenus lors d'un chiffrement AES

Le chiffrement réalisé avec un algorithme AES utilise un vecteur d'initialisation. Ce vecteur d'initialisation est modifié à chaque appel de la fonction. Il est donc normal de ne jamais obtenir le même résultat lors du chiffrement d'une même information. Cependant, la valeur attendue est bien récupérée lors de l'appel de la fonction DécrypteStandard.
Liste des exemples associés :
Les fonctions de chiffrement (CrypteXXX, DécrypteXXX) Exemples unitaires (WINDEV) : Les fonctions de chiffrement (CrypteXXX, DécrypteXXX)
[ + ] Utilisation des fonctions de chiffrement de WINDEV.
Cet exemple permet de :
- Chiffrer une chaîne de caractères
- Déchiffrer une chaîne de caractères
Classification Métier / UI : Code métier
Composante : wd300com.dll
Version minimum requise
  • Version 20
Documentation également disponible pour…
Commentaires
Cryptage Windows <> Android (vu quelque part)
Procedure CryptageToutePlateforme(LOCAL sChaine_UNICODE est une chaîne UNICODE, LOCAL sCle_UNICODE est une chaîne UNICODE)

sChaine_UTF8 est un Buffer = ChaîneVersUTF8(sChaine_UNICODE)
sCle_UTF8 est un Buffer = ChaîneVersUTF8(sCle_UNICODE)
bufCle est un Buffer
bufCrypte est un Buffer

bufCle= HashChaîne(HA_MD5_128, sCle_UTF8)
bufCrypte = CrypteStandard(sChaine_UTF8, bufCle, crypteAES128)

RENVOYER bufCrypte



Procedure DecryptageToutePlateforme(LOCAL bufCrypte est un Buffer, LOCAL sCle_UNICODE est une chaîne UNICODE)

sCle_UTF8 est un Buffer = ChaîneVersUTF8(sCle_UNICODE)
bufCle est un Buffer
bufResultat est une Buffer

bufCle= HashChaîne(HA_MD5_128, sCle_UTF8)
bufResultat = DécrypteStandard(bufCrypte, bufCle, crypteAES128)

RENVOYER UTF8VersUnicode(bufResultat)
Ezéchias D.
31 mai 2020

Dernière modification : 09/07/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale