Skip to content
PDF Oxide

Digitale Signaturen

Hinzugefügt in v0.3.38. PDF Oxide liest Signaturen aus /AcroForm /Fields → /Sig, inspiziert den CMS-Umschlag innerhalb von /Contents und führt die RFC 5652 §5.4-Prüfung der Signer-Attribute gegen das eingebettete Zertifikat sowie die §11.2-messageDigest-Prüfung gegen die vom Aufrufer bereitgestellten Dokumentbytes durch.

Umfang. Diese Seite behandelt das Lesen und Verifizieren vorhandener Signaturen: Aufzählung, kryptografische CMS-Prüfung, PAdES-Niveau-Klassifizierung, DSS-Inspektion und RFC 3161-Zeitstempel. Um eine Signatur zu erstellen — PKCS#12/PEM-Anmeldedaten laden und eine CMS- oder PAdES B-B/B-T/B-LT-Signatur erzeugen — siehe PDF signieren: Digitale Signaturen & PAdES (erschienen in v0.3.50, Issue #235).

Was geprüft wird

  • RSA-PKCS#1 v1.5 over SHA-1 / SHA-256 / SHA-384 / SHA-512 — das Padding-Schema praktisch aller signierten PDFs — gibt Valid / Invalid zurück.
  • RSA-PSS und ECDSA erscheinen als Unknown / UnsupportedFeatureException. Aufrufer, die diese benötigen, können das eingebettete Zertifikat weiterhin über Signature.GetCertificate() / .get_certificate() abrufen und eine eigene Prüfung durchführen.
  • Vertrauensanker, Gültigkeitszeitraum und Signer-DN werden aus dem eingebetteten Zertifikat in das Verifikationsergebnis übertragen.

Schnellbeispiel

Rust

use pdf_oxide::PdfDocument;

let doc = PdfDocument::open("signed.pdf")?;
for sig in doc.signatures() {
    println!("{} → {:?}", sig.signer_name(), sig.verify()?);

    // End-to-end with document bytes
    let pdf_bytes = std::fs::read("signed.pdf")?;
    println!("detached ok = {:?}", sig.verify_detached(&pdf_bytes)?);

    // Cert inspection + trust-root / expiry / signer DN
    let result = pdf_oxide::SignatureVerifier::verify(&sig, &pdf_bytes)?;
    println!("signer DN = {}", result.signer_dn);
}

Python

from pdf_oxide import PdfDocument

doc = PdfDocument("signed.pdf")
for sig in doc.signatures():
    print(sig.signer_name, "→", sig.verify())

# End-to-end with document bytes
with open("signed.pdf", "rb") as f:
    pdf_bytes = f.read()
for sig in doc.signatures():
    print("detached ok =", sig.verify_detached(pdf_bytes))

Node / TypeScript

import { PdfDocument } from "pdf-oxide";
import { readFileSync } from "fs";

const doc = PdfDocument.open("signed.pdf");
for (const sig of doc.signatures()) {
  console.log(sig.signerName, "→", sig.verify());
  console.log("detached ok =", sig.verifyDetached(readFileSync("signed.pdf")));
}

C#

using PdfOxide;

using var doc = PdfDocument.Open("signed.pdf");
foreach (var sig in doc.Signatures)
{
    Console.WriteLine($"{sig.SignerName} → {sig.Verify()}");
    var cert = sig.GetCertificate();
    Console.WriteLine($"subject={cert.Subject} issuer={cert.Issuer} valid={cert.IsValid}");
}

Go (CGo-only)

import (
    "fmt"
    "os"

    pdfoxide "github.com/yfedoseev/pdf_oxide/go"
)

doc, _ := pdfoxide.Open("signed.pdf")
defer doc.Close()

pdfBytes, _ := os.ReadFile("signed.pdf")

sigs, _ := doc.Signatures()
for _, sig := range sigs {
    ok, _ := sig.Verify()
    fmt.Printf("%s → %v\n", sig.SignerName, ok)

    // End-to-end with document bytes
    detachedOk, _ := sig.VerifyDetached(pdfBytes)
    fmt.Println("detached ok =", detachedOk)
}

WASM

import init, { PdfDocument } from "pdf-oxide-wasm/web";
await init();

const doc = new PdfDocument(bytes);
for (const sig of doc.signatures()) {
  console.log(sig.signerName, "→", sig.verify());
}

C++

#include <pdf_oxide/pdf_oxide.hpp>
#include <fstream>

auto doc = pdf_oxide::Document::open("signed.pdf");

std::ifstream f("signed.pdf", std::ios::binary);
std::vector<std::uint8_t> pdf_bytes((std::istreambuf_iterator<char>(f)), {});

for (int i = 0; i < doc.get_signature_count(); ++i) {
    auto sig = doc.get_signature(i);
    std::cout << sig.signer_name() << " → " << sig.verify() << "\n";   // 1 valid / 0 invalid / -1 unknown
    std::cout << "detached ok = " << sig.verify_detached(pdf_bytes) << "\n";
}

Swift

import PdfOxide
import Foundation

let doc = try Document.open("signed.pdf")
let pdfBytes = [UInt8](try Data(contentsOf: URL(fileURLWithPath: "signed.pdf")))

for i in 0..<(try doc.signatureCount()) {
    guard let sig = try doc.signature(i) else { continue }
    print(try sig.signerName(), "→", try sig.verify())   // 1 valid / 0 invalid / -1 unknown
    print("detached ok =", try sig.verifyDetached(pdfBytes))
}

Dart

import 'dart:io';
import 'package:pdf_oxide/pdf_oxide.dart';

final doc = PdfDocument.open('signed.pdf');
final pdfBytes = File('signed.pdf').readAsBytesSync();

for (var i = 0; i < doc.getSignatureCount(); i++) {
  final sig = doc.getSignature(i);
  print('${sig.signerName} → ${sig.verify()}');   // 1 valid / 0 invalid / -1 unknown
  print('detached ok = ${sig.verifyDetached(pdfBytes)}');
}

R

library(pdfoxide)

doc <- pdf_open("signed.pdf")
pdf_bytes <- readBin("signed.pdf", "raw", file.info("signed.pdf")$size)

for (i in seq_len(pdf_signature_count(doc)) - 1L) {
  sig <- pdf_get_signature(doc, i)
  cat(pdf_signature_signer_name(sig), "→", pdf_signature_verify(sig), "\n")  # 1 valid / 0 invalid / -1 unknown
  cat("detached ok =", pdf_signature_verify_detached(sig, pdf_bytes), "\n")
}

Julia

using PdfOxide

doc = open_document("signed.pdf")
pdf_bytes = read("signed.pdf")

for i in 0:(get_signature_count(doc) - 1)
    sig = get_signature(doc, i)
    println(signature_get_signer_name(sig), " → ", signature_verify(sig))   # 1 valid / 0 invalid / -1 unknown
    println("detached ok = ", signature_verify_detached(sig, pdf_bytes))
end

Zig

const pdf_oxide = @import("pdf_oxide");
const a = std.heap.page_allocator;

var doc = try pdf_oxide.Document.open("signed.pdf");
const pdf_bytes = try std.fs.cwd().readFileAlloc(a, "signed.pdf", 1 << 30);

var i: i32 = 0;
const count = try doc.signatureCount();
while (i < count) : (i += 1) {
    var sig = try doc.signature(i);
    const name = try sig.signerName(a);
    std.debug.print("{s} → {}\n", .{ name, try sig.verify() });   // 1 valid / 0 invalid / -1 unknown
    std.debug.print("detached ok = {}\n", .{try sig.verifyDetached(pdf_bytes)});
}

Objective-C

#import "POXPdfOxide.h"
NSError *err = nil;

POXDocument *doc = [POXDocument openPath:@"signed.pdf" error:&err];
NSData *pdfBytes = [NSData dataWithContentsOfFile:@"signed.pdf"];

int32_t count = [doc signatureCountWithError:&err];
for (int32_t i = 0; i < count; i++) {
    POXSignatureInfo *sig = [doc signatureAtIndex:i error:&err];
    NSLog(@"%@ → %d", [sig signerNameError:&err], [sig verifyError:&err]);   // 1 valid / 0 invalid / -1 unknown
    NSLog(@"detached ok = %d", [sig verifyDetached:pdfBytes error:&err]);
}

Elixir

{:ok, doc} = PdfOxide.open("signed.pdf")
pdf_bytes = File.read!("signed.pdf")

{:ok, count} = PdfOxide.signature_count(doc)
for i <- 0..(count - 1) do
  {:ok, sig} = PdfOxide.signature(doc, i)
  {:ok, name} = PdfOxide.signature_signer_name(sig)
  {:ok, verdict} = PdfOxide.signature_verify(sig)          # 1 valid / 0 invalid / -1 unknown
  {:ok, detached} = PdfOxide.signature_verify_detached(sig, pdf_bytes)
  IO.puts("#{name} → #{verdict}")
  IO.puts("detached ok = #{detached}")
end

Signature

Signaturen aufzählen und inspizieren. In allen Bindings verfügbar.

Eigenschaft / Methode Beschreibung
.signer_name / .SignerName Common Name aus dem Zertifikat des Unterzeichners. C ABI / Swift: signing_name / signerName().
.reason / .Reason Signaturgrund (z. B. „Ich genehmige dieses Dokument"). C ABI / Swift: signing_reason / signingReason().
.location / .Location Ortsfeld. C ABI / Swift: signing_location / signingLocation().
.contact_info Kontaktinformationsfeld
.signing_time / .SigningTime UTC-Signaturzeitpunkt aus dem CMS-Umschlag (DateTimeOffset? in C#)
.pades_level / padesLevel() PAdES-Baseline, ausschließlich aus CMS-Attributen klassifiziert (B_B/B_T). Für B_LT wird zusätzlich /DSS des Dokuments benötigt — mit dss unten kombinieren.
.has_timestamp() / hasTimestamp() True, wenn diese Signatur einen eingebetteten RFC 3161-Zeitstempel trägt.
.add_timestamp(ts) / addTimestamp(_:) Hängt einen geparsten Timestamp an die Signatur an (C ABI / Swift).
.verify() / .Verify() RFC 5652 §5.4-Signer-Attributprüfung gegen eingebettetes Zertifikat. Gibt Valid / Invalid / Unknown zurück.
.verify_detached(pdf_bytes) / .VerifyDetached(pdfBytes) Fügt die RFC 5652 §11.2-messageDigest-Prüfung gegen die vom Aufrufer gelieferten Dokumentbytes hinzu.
.get_certificate() / .GetCertificate() Gibt ein Certificate zur tieferen Inspektion zurück.

Auf Dokumentebene führt verify_all_signatures() / verifyAllSignatures() die Signaturprüfung für jede Signatur durch und liefert ein einziges Gesamtergebnis: 1 = alle gültig, 0 = mindestens eine ungültig, -1 = mindestens eine unbekannt/nicht unterstützt.

use pdf_oxide::PdfDocument;

let doc = PdfDocument::open("signed.pdf")?;
for sig in doc.signatures() {
    println!("level={:?} timestamped={}", sig.pades_level(), sig.has_timestamp());
}

Certificate

X.509-Zertifikat, das über x509-parser aus dem /Contents-Blob extrahiert wird. Ab v0.3.38 in allen Bindings verfügbar (Python / Go / WASM-Zugriffsmethoden kamen kurz nach dem Erstrelease hinzu).

Eigenschaft / Methode Beschreibung
.subject Distinguished Name des Zertifikatsinhabers
.issuer DN der ausstellenden CA
.serial Seriennummer (als Big-Endian-Bytes oder String)
.not_before Beginn des Gültigkeitszeitraums (DateTimeOffset)
.not_after Ende des Gültigkeitszeitraums
.is_valid True, wenn not_before ≤ now ≤ not_after

Dss — Document Security Store

Der /DSS (ISO 32000-2 §12.8.4.3) enthält das Langzeitvalidierungsmaterial für PAdES-B-LT-Signaturen: DER-Zertifikate auf Dokumentebene, CRLs, OCSP-Antworten und VRI-Schlüssel je Signatur. Wird aus dem Dokument gelesen; None/null bedeutet, dass das PDF keinen DSS hat (kein Fehler). Verfügbar in Rust, Python, Go, C# und Swift.

Rust

use pdf_oxide::PdfDocument;
use pdf_oxide::signatures::read_dss;

let doc = PdfDocument::open("ltv.pdf")?;
if let Some(dss) = read_dss(&doc)? {
    println!("certs={} crls={} ocsps={} vri={}",
        dss.certificates.len(), dss.crls.len(), dss.ocsp_responses.len(), dss.vri.len());
}

Python

import pdf_oxide

doc = pdf_oxide.PdfDocument("ltv.pdf")
dss = doc.dss()
if dss is not None:
    print("certs", len(dss.certs), "crls", len(dss.crls),
          "ocsps", len(dss.ocsps), "vri", len(dss.vri))

Go

doc, _ := pdfoxide.Open("ltv.pdf")
defer doc.Close()

dss, _ := doc.DSS()           // nil when the PDF has no /DSS
if dss != nil {
    fmt.Printf("certs=%d crls=%d ocsps=%d vri=%d\n",
        len(dss.Certs), len(dss.CRLs), len(dss.OCSPs), dss.VRICount)
}

C#

using var doc = PdfDocument.Open("ltv.pdf");
var dss = doc.GetDss();        // null when the PDF has no /DSS
if (dss is not null)
{
    Console.WriteLine($"certs={dss.Certificates.Count} crls={dss.Crls.Count} " +
                      $"ocsps={dss.OcspResponses.Count} vri={dss.VriCount}");
}

Swift

if let dss = try doc.dss() {
    print("certs=\(try dss.certCount()) crls=\(try dss.crlCount()) " +
          "ocsps=\(try dss.ocspCount()) vri=\(try dss.vriCount())")
}

C++

try {
    auto dss = doc.get_dss();           // throws if the PDF has no /DSS
    std::cout << "certs=" << dss.cert_count() << " crls=" << dss.crl_count()
              << " ocsps=" << dss.ocsp_count() << " vri=" << dss.vri_count() << "\n";
} catch (const pdf_oxide::Error&) {
    // no DSS present
}

Dart

try {
  final dss = doc.getDss();             // throws if the PDF has no /DSS
  print('certs=${dss.certCount} crls=${dss.crlCount} '
        'ocsps=${dss.ocspCount} vri=${dss.vriCount}');
} on PdfOxideError {
  // no DSS present
}

R

dss <- pdf_get_dss(doc)                 # NULL when the PDF has no /DSS
if (!is.null(dss)) {
  cat("certs=", pdf_dss_cert_count(dss), "crls=", pdf_dss_crl_count(dss),
      "ocsps=", pdf_dss_ocsp_count(dss), "vri=", pdf_dss_vri_count(dss), "\n")
}

Julia

dss = document_get_dss(doc)             # nothing when the PDF has no /DSS
if dss !== nothing
    println("certs=", dss_cert_count(dss), " crls=", dss_crl_count(dss),
            " ocsps=", dss_ocsp_count(dss), " vri=", dss_vri_count(dss))
end

Zig

var dss = try doc.dss();                // error if the PDF has no /DSS
std.debug.print("certs={} crls={} ocsps={} vri={}\n", .{
    try dss.certCount(), try dss.crlCount(), try dss.ocspCount(), try dss.vriCount(),
});

Objective-C

POXDss *dss = [doc dssWithError:&err];  // nil when the PDF has no /DSS
if (dss != nil) {
    NSLog(@"certs=%d crls=%d ocsps=%d vri=%d",
          [dss certCount], [dss crlCount], [dss ocspCount], [dss vriCount]);
}

Elixir

case PdfOxide.document_dss(doc) do
  {:ok, dss} ->
    IO.puts("certs=#{PdfOxide.dss_cert_count(dss)} crls=#{PdfOxide.dss_crl_count(dss)} " <>
            "ocsps=#{PdfOxide.dss_ocsp_count(dss)} vri=#{PdfOxide.dss_vri_count(dss)}")
  _ -> :no_dss   # the PDF has no /DSS
end
C ABI / Swift-Methode Äquivalent Python / Go / C# Beschreibung
cert_count() len(dss.certs) / len(dss.Certs) / dss.Certificates.Count DER-Zertifikate auf Dokumentebene (/Certs)
crl_count() len(dss.crls) / len(dss.CRLs) / dss.Crls.Count DER-CRLs auf Dokumentebene (/CRLs)
ocsp_count() len(dss.ocsps) / len(dss.OCSPs) / dss.OcspResponses.Count DER-OCSP-Antworten auf Dokumentebene (/OCSPs)
vri_count() len(dss.vri) / dss.VRICount / dss.VriCount /VRI-Einträge je Signatur (SHA-1 von /Contents als Großbuchstaben-Hex)

Um das B-LTA-Archivierungs-/DocTimeStamp zu prüfen (ein dokumentweites Signal, das pades_level nicht melden kann), rufen Sie has_document_timestamp(pdf_bytes) (Rust/Python), doc.HasDocumentTimestamp() (Go/C#) oder doc.hasTimestamp() (Swift) auf.

Timestamp — RFC 3161 TSTInfo

Parst den Zeitstempel-Blob aus dem TimeStampToken-Attribut einer Signatur oder aus einer eigenständigen RFC 3161-Antwort. In allen Bindings verfügbar (Node-Unterstützung wurde nach dem Release v0.3.38 hinzugefügt).

Rust

use pdf_oxide::Timestamp;

let ts = Timestamp::parse(&tst_bytes)?;
println!("{} serial={} tsa={}", ts.time(), ts.serial(), ts.tsa_name());

Python

from pdf_oxide import Timestamp

ts = Timestamp.parse(tst_bytes)
print(ts.time, ts.serial, ts.policy_oid, ts.tsa_name, ts.hash_algorithm)

C#

var ts = Timestamp.Parse(tstBytes);
Console.WriteLine($"{ts.Time} serial={ts.Serial} tsa={ts.TsaName}");

Node / TypeScript

import { Timestamp } from "pdf-oxide";

const ts = Timestamp.parse(tstBytes);
console.log(ts.time, ts.serial, ts.policyOid, ts.tsaName, ts.hashAlgorithm);
ts.close();

Go

ts, _ := pdfoxide.ParseTimestamp(tstBytes)
fmt.Println(ts.Time, ts.Serial, ts.PolicyOid, ts.TsaName, ts.HashAlgorithm)

WASM

import init, { Timestamp } from "pdf-oxide-wasm/web";
await init();

const ts = Timestamp.parse(tstBytes);
console.log(ts.time, ts.serial, ts.policyOid, ts.tsaName, ts.hashAlgorithm);

C++

auto ts = pdf_oxide::Timestamp::parse(tst_bytes);
std::cout << ts.time() << " serial=" << ts.serial() << " tsa=" << ts.tsa_name()
          << " policy=" << ts.policy_oid() << " hash=" << ts.hash_algorithm() << "\n";

Swift

let ts = try Timestamp.parse(tstBytes)
print(try ts.time(), "serial=\(try ts.serial())", "tsa=\(try ts.tsaName())",
      "policy=\(try ts.policyOid())", "hash=\(try ts.hashAlgorithm())")

Dart

final ts = Timestamp.parse(tstBytes);
print('${ts.time} serial=${ts.serial} tsa=${ts.tsaName} '
      'policy=${ts.policyOid} hash=${ts.hashAlgorithm}');

R

ts <- pdf_timestamp_parse(tst_bytes)
cat(pdf_timestamp_time(ts), "serial=", pdf_timestamp_serial(ts),
    "tsa=", pdf_timestamp_tsa_name(ts), "policy=", pdf_timestamp_policy_oid(ts),
    "hash=", pdf_timestamp_hash_algorithm(ts), "\n")

Julia

ts = timestamp_parse(tst_bytes)
println(timestamp_get_time(ts), " serial=", timestamp_get_serial(ts),
        " tsa=", timestamp_get_tsa_name(ts), " policy=", timestamp_get_policy_oid(ts),
        " hash=", timestamp_get_hash_algorithm(ts))

Zig

const a = std.heap.page_allocator;
var ts = try pdf_oxide.Timestamp.parse(tst_bytes);
const serial = try ts.serial(a);
const tsa = try ts.tsaName(a);
std.debug.print("{} serial={s} tsa={s} hash={}\n", .{
    try ts.time(), serial, tsa, try ts.hashAlgorithm(),
});

Objective-C

POXTimestamp *ts = [POXTimestamp parse:tstBytes error:&err];
NSLog(@"%lld serial=%@ tsa=%@ policy=%@ hash=%d",
      [ts timeError:&err], [ts serialError:&err], [ts tsaNameError:&err],
      [ts policyOidError:&err], [ts hashAlgorithmError:&err]);

Elixir

{:ok, ts} = PdfOxide.timestamp_parse(tst_bytes)
{:ok, time}   = PdfOxide.timestamp_time(ts)
{:ok, serial} = PdfOxide.timestamp_serial(ts)
{:ok, tsa}    = PdfOxide.timestamp_tsa_name(ts)
IO.puts("#{time} serial=#{serial} tsa=#{tsa}")
Eigenschaft Beschreibung
.time Von der TSA beglaubigter UTC-Zeitpunkt
.serial Eindeutige Seriennummer dieses Zeitstempels
.policy_oid TSA-Richtlinien-OID
.tsa_name TSA-Bezeichner
.hash_algorithm Für message_imprint verwendeter Hash-Algorithmus
.message_imprint Hash der signierten Nutzlast
.verify() Prüft die TSTInfo-Signatur gegen das eingebettete TSA-Zertifikat

TsaClient — RFC 3161 HTTP-Client

Fordert einen neuen Zeitstempel von einer Zeitstempelstelle (TSA) per HTTP an. Erfordert das Cargo-Feature tsa-client. In allen Bindings außer WASM verfügbar (Node-Unterstützung nach v0.3.38 hinzugefügt; WASM absichtlich ausgenommen — ureq kompiliert nicht nach wasm32).

Rust

use pdf_oxide::TsaClient;

let client = TsaClient::new("https://freetsa.org/tsr")
    .with_timeout(std::time::Duration::from_secs(30))
    .with_hash_algorithm(pdf_oxide::HashAlgorithm::Sha256)
    .with_nonce(true);
let ts = client.request_timestamp(&pdf_bytes)?;
println!("{} serial={}", ts.time(), ts.serial());

Python

from pdf_oxide import TsaClient

client = TsaClient(
    url="https://freetsa.org/tsr",
    username=None,
    password=None,
    timeout_seconds=30,
    hash_algorithm=2,   # 2 = SHA-256
    use_nonce=True,
    cert_req=True,
)

ts = client.request_timestamp(pdf_bytes)
print(ts.time, ts.serial)

Node / TypeScript

import { TsaClient } from "pdf-oxide";

const client = new TsaClient({
  url: "https://freetsa.org/tsr",
  timeoutSeconds: 30,
  hashAlgorithm: 2,    // 2 = SHA-256
  useNonce: true,
  certReq: true,
});

const ts = client.requestTimestamp(pdfBytes);
console.log(ts.time, ts.serial);
ts.close();
client.close();

C#

var client = new TsaClient("https://freetsa.org/tsr");
var ts = client.RequestTimestamp(pdfBytes);
Console.WriteLine($"{ts.Time} serial={ts.Serial}");

Go

client := pdfoxide.NewTsaClient("https://freetsa.org/tsr")
ts, err := client.RequestTimestamp(pdfBytes)
if err != nil { log.Fatal(err) }
fmt.Println(ts.Time, ts.Serial)

C++

auto client = pdf_oxide::TsaClient::create("https://freetsa.org/tsr");
auto ts = client.request_timestamp(pdf_bytes);
std::cout << ts.time() << " serial=" << ts.serial() << "\n";

Swift

let client = try TsaClient.create(url: "https://freetsa.org/tsr")
let ts = try client.requestTimestamp(pdfBytes)
print(try ts.time(), "serial=\(try ts.serial())")

Dart

final client = TsaClient.create('https://freetsa.org/tsr');
final ts = client.requestTimestamp(pdfBytes);
print('${ts.time} serial=${ts.serial}');

R

client <- pdf_tsa_client_create("https://freetsa.org/tsr")
ts <- pdf_tsa_request_timestamp(client, pdf_bytes)
cat(pdf_timestamp_time(ts), "serial=", pdf_timestamp_serial(ts), "\n")

Julia

client = tsa_client_create("https://freetsa.org/tsr")
ts = tsa_request_timestamp(client, pdf_bytes)
println(timestamp_get_time(ts), " serial=", timestamp_get_serial(ts))

Zig

const a = std.heap.page_allocator;
var client = try pdf_oxide.TsaClient.create("https://freetsa.org/tsr", "", "", 30, 0, true, true);
var ts = try client.requestTimestamp(pdf_bytes);
const serial = try ts.serial(a);
std.debug.print("{} serial={s}\n", .{ try ts.time(), serial });

Objective-C

POXTsaClient *client = [POXTsaClient createWithUrl:@"https://freetsa.org/tsr"
                                          username:nil password:nil
                                           timeout:30 hashAlgo:0
                                          useNonce:YES certReq:YES error:&err];
POXTimestamp *ts = [client requestTimestamp:pdfBytes error:&err];
NSLog(@"%lld serial=%@", [ts timeError:&err], [ts serialError:&err]);

Elixir

{:ok, client} = PdfOxide.tsa_client("https://freetsa.org/tsr")
{:ok, ts} = PdfOxide.tsa_request_timestamp(client, pdf_bytes)
{:ok, time}   = PdfOxide.timestamp_time(ts)
{:ok, serial} = PdfOxide.timestamp_serial(ts)
IO.puts("#{time} serial=#{serial}")

TsaClient sendet einen RFC 3161 TimeStampReq per HTTP POST mit einem Nonce und HTTP-Basic-Authentifizierung (wenn username / password gesetzt sind). Die Antwort wird entpackt und über Timestamp::parse geparst.

Binding-Abdeckung im Überblick

Vollständige Parität ab v0.3.38: jede Signaturfunktion steht in jedem Binding zur Verfügung — mit der einzigen bewussten Ausnahme von TsaClient unter WASM (ureq ist wasm-inkompatibel).

Funktion Rust Python Node C# Go WASM
Signature aufzählen und prüfen ✓ ✓ ✓ ✓ ✓ ✓
Certificate inspizieren ✓ ✓ ✓ ✓ ✓ ✓
Dss (/DSS) inspizieren ✓ ✓ — ✓ ✓ —
Timestamp parsen und prüfen ✓ ✓ ✓ ✓ ✓ ✓
TsaClient HTTP-Anfrage ✓ ✓ ✓ ✓ ✓ —
Signieren (sign_pdf_bytes / PAdES) ✓ ✓ — ✓ ✓ —

Das — bei TsaClient × WASM ist absichtlich und dauerhaft: ureq lässt sich nicht nach wasm32 kompilieren. Rufen Sie TsaClient aus einem serverseitigen Binding auf und übergeben Sie die rohen Zeitstempel-Bytes an Timestamp.parse() im WASM, wenn Sie die Antwort im Browser inspizieren möchten.

Verwandte Seiten