Démarrage rapide : premier horodatage

Ce parcours utilise le point d’accès standard RFC 3161. Il convient à une intégration qui calcule l’empreinte du document sur son propre système.

Avant de commencer

Préparez un compte API TSA activé, un fichier de test et les outils OpenSSL et cURL. L’URL de production documentée est https://my.datasure.net. Utilisez l’URL et les identifiants remis pour votre environnement ; les jetons de test ne doivent pas servir de preuves de production.

Le mot de passe ci-dessous est demandé de manière interactive par cURL. Évitez de le placer dans un script, dans l’historique du terminal ou dans un dépôt Git.

1. Créer la requête

openssl ts -query -data document.pdf -sha256 -cert -out demande.tsq

Cette commande produit une requête DER contenant l’empreinte SHA-256. L’option -cert demande le certificat de l’unité d’horodatage. Le fichier original n’est pas inclus dans la TSQ.

2. Appeler Datasure TSA

curl --fail-with-body --silent --show-error \
  --user 'UTILISATEUR_API' \
  --header 'Content-Type: application/timestamp-query' \
  --header 'Accept: application/timestamp-reply' \
  --data-binary @demande.tsq \
  --output reponse.tsr \
  'https://my.datasure.net/api/timestamp'

En cas d’erreur HTTP, le fichier de sortie peut contenir une erreur textuelle ou JSON : ne le considérez pas comme une TSR valide. Ne relancez pas automatiquement cette commande en boucle.

3. Lire puis vérifier le résultat

openssl ts -reply -in reponse.tsr -text

Contrôlez le statut RFC 3161, le numéro de série, la date, l’algorithme et l’empreinte. Cette lecture n’effectue pas une validation complète.

Avec les certificats de confiance et intermédiaires applicables, récupérés depuis le site de publication Datasure, vous pouvez contrôler la réponse et sa correspondance avec la demande :

openssl ts -verify -queryfile demande.tsq -in reponse.tsr \
  -CAfile racines-de-confiance.pem \
  -untrusted certificats-intermediaires.pem

Ces noms désignent des fichiers à préparer avec les certificats adaptés, pas des fichiers distribués avec ce guide. Complétez le contrôle par la politique de confiance, le statut des certificats et les exigences de votre application ; voir Vérification.

4. Conserver et relier les preuves

Enregistrez le document exact, demande.tsq, reponse.tsr, le numéro de série et votre référence métier. Calculez une empreinte de la TSR conservée pour vos contrôles internes. Un horodatage ultérieur sera une nouvelle opération.

Avec TSA Premium, vous pouvez ensuite retrouver les détails et générer un certificat d’opération. L’indexation des détails est asynchrone : un jeton reçu peut précéder sa disponibilité dans la recherche.