PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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 CrypteStantard peut être relativement long car il est nécessaire d'initialiser la randomisation.
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les sites PHP à partir de la version 200051.
// Cryptage d’une chaîne de caractères en utilisant l'algorithme AES
// ------------------------------------------------------------------
sMessage est un Buffer = "Message à crypter"
bufCle est un Buffer = HashChaîne(HA_MD5_128, "mot de passe")
bufCrypte est un Buffer = CrypteStandard(sMessage, bufCle, crypteAES128)

// Décryptage en WLangage
-------------------------
sRésultat est un Buffer = DécrypteStandard(bufCrypte, bufCle, crypteAES128)
Info(sRésultat)
// Cryptage en WLangage
// ---------------------
sMessage est un Buffer = "Message à crypter"
bufCle est un Buffer = HashChaîne(HA_MD5_128, "mot de passe")
bufCrypte est un Buffer = CrypteStandard(sMessage, bufCle, crypteAES128)

//---------------------------------------------------------------
// Décryptage via un appel à l'API Mcrypt de PHP
nTailleIV est un entier = 128 / 8
bufIV est un Buffer = bufCrypte[[ À nTailleIV]]
bufDonnees est un Buffer = bufCrypte[[nTailleIV+1 À]]

EXTERNE mcrypt_decrypt//API PHP (à faire dans un traitement serveur WEBDEV PHP)
Trace(mcrypt_decrypt( "rijndael-128", bufCle, bufDonnees, "cbc", bufIV))
Syntaxe
<Résultat> = CrypteStandard(<Message> , <Clé> [, <Algorithme> [, <Mode d’opération> [, <Remplissage>]]])
<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 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 multi-plateforme : 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 :
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.
Versions 23 et supérieures
crypteAES256
Nouveauté 23
crypteAES256
crypteAES256
Advanced Encryption Standard.
  • Taille de la clé : 256 bits.
  • Taille des blocs : 128 bits.
  • Taille du vecteur d’initialisation (IV) : 128 bits.
AndroidWidget AndroidJavaPHP Cette constante n'est pas disponible.
crypteDESData Encryption Standard.
  • Taille de la clé : 64 bits.
  • Taille des blocs : 64 bits.
  • Taille du vecteur d’initialisation (IV) : 64 bits.
crypte3DESTriple Data Encryption Standard.
  • Taille de la clé : 192 bits.
  • Taille des blocs : 64 bits.
  • Taille du vecteur d’initialisation (IV) : 64 bits.
<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
Versions 23 et supérieures
crypteCFB
Nouveauté 23
crypteCFB
crypteCFB
Cipher Feedback - Chiffrement à rétroaction. Ce mode de traitement est disponible uniquement si l'algorithme utilisé correspond à la constante crypteAES256.
AndroidWidget AndroidJavaPHP Cette constante n'est pas disponible.
Versions 23 et supérieures
crypteCTR
Nouveauté 23
crypteCTR
crypteCTR
Cipher Counter - Chiffrement basé sur un compteur. Ce mode de traitement est disponible uniquement si l'algorithme utilisé correspond à la constante crypteAES256.
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é.
<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.
Liste des exemples associés :
Les fonctions Crypte Exemples unitaires (WINDEV) : Les fonctions Crypte
[ + ] Utilisation des fonctions de cryptage / décryptage de WINDEV.
Cet exemple permet de :
- Crypter une chaîne de caractères
- Décrypter une chaîne de caractères
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd230com.dll
Java wd230java.jar
Linux wd230com.so
Android wd230android.jar
Version minimum requise
  • Version 20
Documentation également disponible pour…
Commentaires
AES256
Le support AES256 est t'il prévu ?
DV
31 mai 2017