PDFToolkit objet par objet

Guides

Bundle PDF 2.0 : mécanismes et vérifications

Le core 0.7 complète les fondations PDF 2.0 avec les spécifications distribuées par la PDF Association. Les mécanismes restent des objets PDF explicites. L’application choisit la version du fichier, les algorithmes, les espaces de noms, les métadonnées, les relations et sa politique de vérification. Aucun registre global ni conversion implicite d’un fichier externe n’intervient.

Périmètre par document

Document Mécanismes exécutables Vérifications et limites
ISO 32000-2:2020 EC3 Inventaire des dictionnaires propre à l’édition, encodages textuels, fichiers associés, R=6, espaces de noms, parties documentaires, enveloppes chiffrées, DSS et horodatages 306 tableaux de dictionnaires et 1 709 objets d’entrées ; corrections EC3 sélectionnées et limites sémantiques restent distinctes.
ISO/TS 32001:2022 EC3 SHA3-256/384/512 et SHAKE256 fixe de 64 octets ; déclaration d’extension ISO et objets de sélection du condensat Vérifications indépendantes des condensats et CMS ; la suppression EC3 de la clause 5.1.3 est respectée au lieu d’étendre la règle barrée sur les références de signature.
ISO/TS 32002:2022 EC3 Courbes nommées P-256/P-384/P-521 et Brainpool, Ed25519/Ed448, combinaisons exactes courbe/condensat et construction CMS Vérification indépendante de 23 combinaisons. La confiance dans le certificat et sa révocation relèvent de la politique applicative.
ISO/TS 32003:2023 AES-GCM/AESV4 avec V=6/R=7, étiquette d’authentification, séquence de nonces par clé et algorithmes d’authentification R=6 pyHanko déchiffre les fichiers natifs ; un contenu chiffré altéré est refusé. AES-CBC R=6 reste un choix distinct.
ISO/TS 32004:2024 KDFSalt, bit de permission 13, HKDF, enveloppement de clé AES, CMS AuthenticatedData, MAC autonome ou attaché à une signature pyHanko vérifie les fichiers initiaux, incrémentaux et linéarisés ; le MAC occupe exactement sa longueur DER, sans bourrage.
ISO/TS 32005:2023 Rôles qualifiés, espaces de noms standards/personnalisés, résolution des correspondances, rôles communs PDF 2.0 et règles d’inclusion du tableau 5 La matrice source complète est reproductible. Les résolutions publiées se sélectionnent explicitement ; aucune interprétation d’une ambiguïté n’est inventée silencieusement.
PDF Declarations Objets Declaration/ClaimData, dates et schéma d’extension XMP PDF/A facultatif Une déclaration est une assertion de l’auteur, avec une portée de métadonnées précise ; ce n’est pas un certificat d’audit.
WTPDF 1.0.0 Niveaux explicites d’audit réutilisation/accessibilité ; contrôles de structure, métadonnées, annotations et utilisation des fontes Le rapport distingue les erreurs détectées des vérifications sémantiques et des programmes de fonte encore à examiner. Aucune certification PDF/UA-2 automatique n’est annoncée.
Note d’application 001 UseBlackPtComp avec exactement ON, OFF ou Default Vérification de version PDF 2.0 et des valeurs, y compris dans les ressources graphiques brutes sans entrée Type. Le périphérique de sortie effectue la gestion des couleurs.
Note d’application 002 Fichiers associés aux objets d’information, contenu marqué, descripteur de contenu chiffré et enveloppe documentaire Les contrôles du graphe effectif couvrent la découverte des fichiers, les relations, la collection masquée et le document extérieur non chiffré.
Note d’application 003 Flux de métadonnées d’objets, portée des ressources, propriétés nommées de contenu marqué, parties documentaires et DPM La sérialisation XMP native produit du XML UTF-8 échappé. Le XML et les contenus opaques fournis par l’appelant demandent leur propre validation.

Le catalogue de base ISO 32000-2 inventorie 440 tableaux et modélise 306 tableaux de dictionnaires avec 1 709 entrées fixes ou variables. Les pages de continuation et les corrections d’extraction sont traçables. Cette couverture et les mécanismes complémentaires n’établissent pas la conformité à toutes les clauses de la norme. Le guide PDF 2.0 et la couverture conservent cette distinction. Le périmètre d’entrée du lecteur optionnel reste inchangé ; les nouveaux mécanismes d’écriture n’en font pas un lecteur PDF 2.0.

Des algorithmes sélectionnés indépendamment

ModernStandardSecurityHandler construit les données d’authentification R=6 AES-CBC ou R=7 AES-GCM à partir des mots de passe utilisateur et propriétaire explicitement préparés. ModernFileEncryption lie ces données, la clé du fichier et l’opération cryptographique. Pdf20Permissions maintient la cohérence entre les permissions et l’exigence de MAC. Une extension ISO est un élément de tableau sous Extensions.ISO_ ; déclarer le niveau 32004 ne déclare pas implicitement les niveaux 32001, 32002 ou 32003.

PdfMacTokenComposer se lie à la clé de chiffrement réellement utilisée et au KDFSalt de 32 octets. Le writer réserve une case hexadécimale exacte, fixe les plages d’octets, calcule le condensat des octets définitifs et insère le jeton DER sans déplacer les offsets. L’écriture incrémentale conserve les octets antérieurs et demande une nouvelle opération MAC pour la nouvelle révision. Ces règles s’appliquent aussi à la sortie linéarisée.

$mac = new PdfMacTokenComposer($encryption->key, $salt, new SystemRandomSource());
$revision = (new FileWriter(encryption: $encryption, mac: $mac))->revision($file);

$nextMac = new PdfMacTokenComposer($encryption->key, $salt, new SystemRandomSource());
$next = (new IncrementalWriter(mac: $nextMac))->serialize(
    new IncrementalUpdate($revision, $explicitDelta),
);

Pour une révision signée, sélectionner macSignature: $pending sur le writer et passer mac: $mac à PreparedSignature. Le MAC devient un attribut CMS non signé lié aux plages d’octets du PDF et aux octets réels de la signature du SignerInfo. Un MAC autonome ne peut pas être conservé tel quel lorsque la signature modifie les octets réservés. La capacité inclut le MAC attaché ; un dépassement exige une nouvelle réservation et une nouvelle signature.

L’extension OpenSSL de PHP exécute les primitives RSA/ECDSA prises en charge. Ed25519 et Ed448 utilisent un exécutable OpenSSL sélectionné explicitement via le fournisseur dédié, car PHP 8.3 n’expose pas l’opération EdDSA nécessaire. Ce fournisseur reçoit explicitement l’exécutable et la clé ; choisir les autres algorithmes ne lance aucun processus. Voir le tutoriel des signatures et de l’intégrité.

Les métadonnées et déclarations ont un propriétaire

XmpPacket compose les propriétés, collections RDF, alternatives linguistiques et déclarations. MetadataStream écrit le flux XML ; MetadataEntry le relie indirectement à son propriétaire PDF. Une déclaration dans les métadonnées du document porte sur ce document. Sur un objet ou une séquence marquée, sa portée se limite à cet élément. Les propriétés de métadonnées ne deviennent pas automatiquement du texte visible sur la page.

Les propriétés nommées du contenu marqué se résolvent dans les ressources de la page, du Form XObject, du motif de pavage ou de la fonte Type 3 concernés. Les faits d’émission sont figés avec le flux réellement sérialisé : une modification non écrite du constructeur ne réinterprète pas une révision antérieure. Les références directes à un flux de métadonnées dans le contenu sont refusées.

DocumentPart, DocumentPartRoot et DocumentPartMetadata représentent les parties documentaires et leurs données. Le contrôle du graphe vérifie la hiérarchie, les plages de pages et les associations réciproques entre pages et parties. Un contenu chiffré emploie un document extérieur distinct, un fichier associé de relation EncryptedPayload, un descripteur EP et une collection masquée. Le document extérieur reste lisible sans déchiffrer son PDF intérieur. Les tutoriels expliquent les métadonnées et parties et l’enveloppe chiffrée.

Règles de structure et audit WTPDF

StructureNamespace, StructureRole et NamespaceRoleMap font de l’espace de noms une partie de l’identité du rôle. NamespaceRoleResolver suit les correspondances qualifiées et refuse les cibles introuvables et les cycles. Le document effectif doit être PDF 2.0 lorsque ces mécanismes sont utilisés, y compris pour les objets conservés dans une révision incrémentale.

StructureInclusionRules applique la matrice source aux rôles réels des parents et enfants, avec l’exemption PDF 1.7 et les règles de mélange des espaces de noms. Les corrections 336 et 440 se sélectionnent explicitement. L’occurrence littérale c du document fourni est conservée dans l’inventaire ; la résolution publiée sélectionnée en fournit l’interprétation.

WtPdfAudit produit les observations du niveau de conformité choisi. Le rapport n’assimile pas « aucune erreur détectée » à « conforme » : l’ordre de lecture pertinent, les descriptions alternatives appropriées, la fidélité des correspondances Unicode et les faits relatifs aux programmes de fonte externes demandent encore des preuves. Le tutoriel des espaces de noms présente un rapport concret à côté du PDF balisé réellement généré.

Conserver les signatures avec horodatages et données de validation

PendingDocumentTimestamp possède un dictionnaire /DocTimeStamp avec le SubFilter ETSI.RFC3161. Rfc3161TimestampBackend envoie à un fournisseur explicite l’empreinte réelle du document et un nonce, puis vérifie le jeton reçu, la liaison à l’autorité et la signature CMS. LocalTimestampAuthority est un fournisseur hors ligne choisi explicitement ; il ne lance aucune requête réseau et n’établit aucune confiance publique.

DocumentSecurityStore contient des flux indirects de certificats, CRL et OCSP. ValidationRelatedInformation exige une politique de validation choisie par l’appelant qui réussit et identifie les Contents exacts d’une signature antérieure, bourrage compris. Le graphe refuse un VRI antérieur à sa signature ou des preuves absentes des tableaux DSS correspondants. Un horodatage ultérieur couvre aussi les preuves ajoutées.

ISO 32000-2 exclut les horodatages et le DSS de l’évaluation DocMDP. DocumentTimestampRevisionPolicy prouve une révision de maintenance limitée par comparaison avec tous les objets précédents figés avant de l’autoriser sous P1 : pages, contenu, widgets et signatures ordinaires ne peuvent pas être modifiés en même temps. FieldMDP et les verrous de champs supplémentaires restent actifs. Le tutoriel d’horodatage explique trois révisions réelles ; l’oracle indépendant vérifie aussi les historiques certifiés, chiffrés et linéarisés.

Les mesures géospatiales conservent leur système de coordonnées

GeographicCoordinateSystem et ProjectedCoordinateSystem identifient un code EPSG ou une chaîne WKT explicites. GeospatialControlPoints apparie les positions locales et réelles pour construire les tableaux LPTS/GPTS correspondants. GeospatialMeasure, Viewport et Viewports relient ces mesures à leur véritable page, Form ou image. PreferredDisplayUnits, ProjectedCoordinateSystemMatrix et PointDataCollection complètent les préférences d’affichage, le calcul affine et les objets de nuage de points.

La validation native et celle du graphe effectif contrôlent les contextes, valeurs finies, dimensions appariées, limites normalisées et exigences de version. Elles ne consultent pas de registre SIG et ne convertissent pas de projections. Le tutoriel géospatial explique deux zones d’exemple déclarées indépendamment et leurs données sérialisées.

La navigation peut cibler un élément logique

StructureDestination désigne un véritable membre de l’arbre de structure et un DestinationView explicite. La résolution de page suit le premier contenu dans l’ordre déclaré des enfants, avec repli sur la première page si aucun contenu ne convient. Actions GoTo et dictionnaires de destination nommés conservent leur repli de page à côté de SD. Les formes distantes ou incorporées utilisent des ID en chaînes d’octets explicites sans ouvrir un autre fichier. Les contrôles du graphe effectif préservent ces relations dans les révisions conservées. Le tutoriel des destinations de structure montre les liens sémantiques et leurs véritables objets PDF.

Vérifications indépendantes

La suite PHP est exécutée sous PHP 8.3, 8.4 et 8.5. Les contrôles complémentaires emploient des implémentations distinctes :

  • pyHanko valide les fichiers AES-CBC et AES-GCM protégés par mot de passe ou certificat, leurs MAC autonomes et attachés, les révisions historiques et le refus des altérations.
  • cryptography et les outils ASN.1 vérifient les signatures courbe/condensat et les jetons MAC.
  • pyHanko et OpenSSL vérifient les jetons RFC3161, DSS/VRI, certifications et chaque préfixe historique signé, au-delà de la seule dernière révision.
  • qpdf contrôle les structures écrites et déchiffre indépendamment le contenu de l’enveloppe ; pypdf et un analyseur XML inspectent métadonnées et relations.
  • La matrice TS 32005 est régénérée à partir de toutes ses pages et comparée à la ressource et à la représentation PHP enregistrées.

Ces contrôles établissent les comportements testés. Ils ne promettent pas que n’importe quelle donnée applicative est sûre ni qu’une déclaration de conformité fournie par l’auteur est vraie.

Originaux conservés et provenance

Les onze originaux conservent leurs noms et octets fournis dans le dossier resources/reference-documents/ du core. Le manifeste des sources enregistre leurs empreintes, tailles, pages physiques et collections de corrections. Le site les relie au dépôt sans les ajouter aux installations Composer ni dupliquer ces fichiers volumineux dans la documentation.

Source de ce guide au commit documenté ↗