|
|
|
|
|
|
|
|
|
|
- Validité du certificat (syntaxe 1)
- Gestion des certificats en WEBDEV
CertificatSigneChaîne (Fonction) En anglais : CertificateSignString Crée la signature d'une chaîne de caractères. Syntaxe
Signer une chaîne via une signature numérique Masquer les détails
<Résultat> = CertificatSigneChaîne(<Chaîne à  signer> , <Fichier certificat> , <Mot de passe> , <Option>)
<Résultat> : Buffer Signature de la chaîne (au format demandé). Ce buffer pourra être ensuite utilisé par la fonction CertificatVérifieChaîne pour vérifier la correspondance entre la signature et la chaîne. <Chaîne à signer> : Chaîne de caractères Ansi ou Unicode ou Buffer Chaîne de caractères à signer. <Fichier certificat> : Chaîne de caractères ou Buffer - Chemin complet vers un fichier de type PKCS12 (.p12/.pfx) contenant la clé privée et les certificats. Ce fichier peut être intégré dans la librairie (fichier WDL) de l'application.
- Buffer contenant la clé privée et les certificats.
Si la constante certSignatureSeule est utilisée, ce buffer peut contenir uniquement la clé privée.
<Mot de passe> : Chaîne de caractères Mot de passe à utiliser pour décrypter le fichier de certificat si celui-ci est protégé par un mot de passe. <Option> : Constante ou combinaison de constantes de type Entier Permet de spécifier : - l'algorithme de hachage utilisé (facultatif dans le cas d'une signature au format PKCS7) :
| | | certMD5 | Algorithme MD5. Déconseillé car peu fiable. Ce type d'algorithme est interdit avec les signatures de type "elliptic curve". | | certSHA160 | Algorithme SHA1. | | certSHA256 | Algorithme SHA2. Le résultat produit est de 256 bits. | | certSHA384 | Algorithme SHA-384. Le résultat produit est de 384 bits. Ce type d'algorithme n'est pas supporté avec les signatures de type "DSA". | | certSHA512 | Algorithme SHA-512. Le résultat produit est de 512 bits. Ce type d'algorithme n'est pas supporté avec les signatures de type "DSA". |
- le format de la signature :
| | | certPKCS7AvecCertificat | Conteneur au format PKCS7 (DER) contenant la signature et la chaîne des certificats. Remarque : si cette constante est utilisée, l'algorithme de hachage est facultatif. S'il n'est pas précisé, un algorithme approprié sera automatiquement choisi. | | certPKCS7AvecCertificat + certPKCS7PEM | Conteneur au format PKCS7 (PEM) contenant la signature et la chaîne des certificats. Remarque : si cette constante est utilisée, l'algorithme de hachage est facultatif. S'il n'est pas précisé, un algorithme approprié sera automatiquement choisi. | | certPKCS7Enveloppé | Conteneur au format PKCS7 (DER) contenant la signature, la chaîne des certificats et les données signées. Remarque : si cette constante est utilisée, l'algorithme de hachage est facultatif. S'il n'est pas précisé, un algorithme approprié sera automatiquement choisi. | | certPKCS7Enveloppé + certPKCS7PEM | Conteneur au format PKCS7 (PEM) contenant la signature, la chaîne des certificats et les données signées. Remarque : si cette constante est utilisée, l'algorithme de hachage est facultatif. S'il n'est pas précisé, un algorithme approprié sera automatiquement choisi. | | certPKCS7SansCertificat | Conteneur au format PKCS7 (DER) contenant la signature. Remarque : si cette constante est utilisée, l'algorithme de hachage est facultatif. S'il n'est pas précisé, un algorithme approprié sera automatiquement choisi. | | certPKCS7SansCertificat + certPKCS7PEM | Conteneur au format PKCS7 (PEM) contenant la signature. Remarque : si cette constante est utilisée, l'algorithme de hachage est facultatif. S'il n'est pas précisé, un algorithme approprié sera automatiquement choisi. | | certSignatureSeule | La sortie contient uniquement la signature brute, sans conteneur. Cette option est requise dans le cas d'une mise en conformité des logiciels de caisse (norme NF525). Avec cette option, seule la partie clé du fichier PFX est utilisée (la partie certificat qui contient la date n'est pas utilisée). Attention : si cette constante est utilisée, il est nécessaire de préciser l'algorithme de hachage. |
Remarque : L'algorithme de signature est déterminé par la clé privée (RSA, DSA, Elliptic curve). Remarques Validité du certificat (syntaxe 1) Avant de signer une chaîne, il est conseillé de vérifier la validité du certificat (propriété ValidePourSignature de la variable de type Certificat). Cette propriété permet de savoir si le certificat possède une clé privée et toutes les caractéristiques requises pour effectuer une signature. Si cette propriété est à Faux, la fonction CertificatSigneChaîne renvoie une erreur. Classification Métier / UI : Code métier Composante : wd300std.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|