libriciel / trusted-timestamps

1.1.3 2026-07-24 12:24 UTC

Requires

• ext-curl: *

Requires (Dev)

• phpunit/phpunit: ^7.3

MIT

Published on Packagist.org on 2026-08-10 07:02 UTC

README

Horodatage certifié RFC 3161 : création d'une requête d'horodatage, signature par une autorité d'horodatage (TSA) et lecture ou vérification de la réponse.

Dépendance de

Projet	Build	Coverage
asalae
asalae-core

Prérequis

• Extension PHP curl
• openssl (sous-commande openssl ts)

Installation

composer require libriciel/trusted-timestamps:~1.1

Utilisation

TrustedTimestamps

TrustedTimestamps\TrustedTimestamps :

• createRequestfile($hash, $hash_algo = 'sha1') : crée la requête d'horodatage d'une empreinte
• signRequestfile($requestfile_path, $tsa_url, $curlOpts = [], $timestamp_format = null) : envoie la requête à l'autorité d'horodatage (TSA) et renvoie la réponse (response_string en base64)
• getTimestampFromAnswer() : date d'horodatage contenue dans une réponse
• validate() : vérifie une réponse avec le certificat de la TSA

tests/TestCase/TrustedTimestampsTest.php

        $sha1 = sha1('foo');
        /** @var \PHPUnit\Framework\string|string $requestFile (suppress IDE warning) */
        $requestFile = TrustedTimestamps::createRequestfile($sha1);
        $this->assertFileExists($requestFile);
        $this->toUnlink[] = $requestFile;

        $signature = TrustedTimestamps::signRequestfile($requestFile, self::TSA_URL);
        $this->assertTrue(!empty($signature));
        $this->assertTrue(!empty($signature['response_string']));

        $timestamp = TrustedTimestamps::getTimestampFromAnswer($signature['response_string']);
        $this->assertTrue(!empty($timestamp));

src/Driver/Timestamping/TimestampingGeneric.php (asalae-core)

        $token = $this->trustedTimestampClass::signRequestfile(
            $requestFile,
            $this->tsaUrl,
            $opts,
            $this->timestampFormat
        );
        return base64_decode($token['response_string']);

Tests

vendor/bin/phpunit

Licence

Licence MIT. D'après Dealing with trusted timestamps in PHP (RFC 3161).