Vérifier une signature au format XAdES, PAdES ou CAdES avec TMS Cryptography Pack

Vérifier une signature au format XAdES, PAdES ou CAdES avec TMS Cryptography Pack.

Aujourd’hui est sortie la version 3.2 du TMS Cryptography Pack. Les nouveautés sont listées dans l’image ci-dessous.

CAdES, XAdES et PAdES signifient respectivement CMS, XML et PDF Advanced Electronics Signatures. Ce sont des formats de signatures maintenus par l’ETSI (European Telecommunications Standards Institute). Ce sont des extensions de formats de signatures CMS, XML et PDF pour les rendre conformes au règlement européen eIDAS (electronic IDentification, Authentication and trust Services), qui est un règlement de l’UE sur l’identification électronique et les services de confiance pour les transactions électroniques au sein de l’Union Européenne.

Petit point sur chaque format :

• CAdES est une extension du format de signature CMS (Cryptographic Message Syntax). C’est un fichier binaire, qui est, en fait, encodé en ASN.1. On peut signer n’importe quel type de fichier avec. L’extension d’un tel fichier de signature peut être pkcs7 ou p7m. CAdES admet deux modes de signature : detached et enveloping.
  • Le mode detached produit un fichier binaire sans toucher au fichier original et sans référence à celui-ci à l’intérieur, en terme de noms de fichiers. Pour vérifier, il faut donc préciser le nom du fichier original en plus de celui de la signature.
  • Le mode enveloping produit un fichier binaire qui inclut les données du fichier original à l’intérieur. La signature enveloppe les données.
• XAdES est une extension du format XML-DSig. C’est un fichier XML. Avec les modes detached et enveloping, on peut signer n’importe quel type de fichier. Avec le mode enveloped, on ne peut signer que des fichiers XML.
  • Le mode detached produit un fichier XML sans toucher au fichier original et avec le nom du fichier (sans son chemin) dans un champ URL. Pour vérifier, il faut donc préciser le chemin du fichier original en plus du nom de fichier de signature.
  • Le mode enveloping produit un fichier XML qui inclut les données du fichier original à l’intérieur. La signature enveloppe les données.
  • Le mode enveloped ajoute la signature au fichier XML original. On obtient un fichier signé indépendant.
• PAdES est une extension du format de signature des fichiers PDF, qui est par défaut en mode enveloped et qui ajoute la signature au fichier PDF original.

Comme TMS Cryptography Pack est une bibliothèque de composants graphiques, il suffit d’ajouter TXAdES, TCAdES et TPAdES sur votre palette. Vous avez donc un fichier dont vous voulez vérifier la signature. L’idée est de juste fournir le fichier original OriginalFile, le fichier de signature SignatureFile s’il est séparé, et que la fonction vous retourne si la signature est valide ou non.

Si votre fichier est une signature CAdES, le code serait le suivant (on ne sait pas à l’avance si la signature est détachée ou non, donc on précise le nom du fichier original) :

err := CAdES.VerifySignature(SignatureFile, OriginalFile);

Si votre fichier est une signature XAdES, le code serait dans ce cas (il faut le chemin du fichier original pour le mode detached) :

XAdES.PathToOriginalFile := ExtractFilePath(OriginalFile);
err := XAdES.VerifySignature(SignatureFile);

Si votre fichier est une signature PAdES, alors le code est :

err := PAdES.VerifySignature(SignatureFile);

Maintenant, comment savoir si le fichier est une signature CAdES, XAdES ou PAdES ?

On va utiliser la fonction GetFileMIMEType présente dans chacune des classes TXAdES, TCAdES et TPAdES. Elle utilise la fonction GetFileMIMEType d’Indy.

filetype := XAdES.GetFileMimeType(SignatureFile);

Quels sont les types possibles dans notre cas ?

XAdES c’est text/xml et PAdES c’est application/pdf. Pour CAdES, c’est plus compliqué, c’est un fichier binaire, il pourrait avoir n’importe quelle extension. Dans les faits, il a souvent l’extension pkcs7 ou p7m, ce qui donne comme type : application/octet-stream ou application/pkcs7-mime.

Notre fonction est donc :

function VerifySignatureFile(SignatureFile, OriginalFile: string): string;
var
 filetype: string;
 err: Integer;
begin
 filetype := XAdES.GetFileMimeType(SignatureFile);

 if filetype = 'application/pdf' then
 begin
  err := PAdES.VerifySignature(SignatureFile);
  if err = 0 then
   Result := 'Signature valide'
  else
   Result := PAdES.VerifyError(err) + '\n' + PAdES.ErrorDetails;
 end
 else if (filetype = 'application/octet-stream') or (filetype = 'application/pkcs7-mime') then
 begin
  err := CAdES.VerifySignature(SignatureFile, OriginalFile);
  if err = 0 then
   Result := 'Signature valide'
  else
   Result := CAdES.VerifyError(err) + '\n' + CAdES.ErrorDetails;
 end
 else if filetype = 'text/xml' then
 begin
  XAdES.PathToOriginalFile := ExtractFilePath(OriginalFile);
  err := XAdES.VerifySignature(SignatureFile);
  if err = 0 then
   Result := 'Signature valide'
  else
   Result := XAdES.VerifyError(err) + '\n' + XAdES.ErrorDetails;
 end
 else
  raise Exception.Create('Format de signature non reconnu');
end;

Vous pouvez aussi signer des documents avec TXAdES, TCAdES et TPAdES. Si votre signature n’est pas reconnu par TMS CP (notamment pour le format XML-enveloped, pour lequel il est plus délicat de traiter tous les cas), n’hésitez pas à me contacter à marion [at] tmssoftware.com.