Ajouter des signatures numériques aux présentations en PHP
Vue d’ensemble
Une signature numérique aide le destinataire à déterminer qui a signé une présentation et si le contenu signé a été modifié. Trois concepts de sécurité associés sont importants ici :
- Un certificat numérique est un justificatif électronique qui associe une identité à une clé publique. Une autorité de certification (CA) de confiance peut délivrer un certificat, ou une organisation peut utiliser un certificat auto‑signé pour les flux de travail internes.
- Une signature numérique est créée à partir du contenu de la présentation et de la clé privée du titulaire du certificat. La clé publique du certificat peut ensuite être utilisée pour vérifier la signature. Une signature fournit une preuve d’origine et d’intégrité ; elle n’encrypte pas la présentation.
- La protection par mot de passe contrôle si un utilisateur peut ouvrir ou modifier une présentation. Elle est distincte de la signature numérique et est décrite dans Présentations protégées par mot de passe.
PowerPoint propose la commande Ajouter une signature numérique sous Fichier > Informations > Protéger la présentation.
Après l’ouverture d’une présentation signée, PowerPoint peut afficher une notification d’état de signature.
Aspose.Slides expose les signatures via Presentation::getDigitalSignatures, qui renvoie une DigitalSignatureCollection, dont les éléments sont représentés par des objets DigitalSignature. Une présentation peut contenir plusieurs signatures.
Comprendre les certificats PFX et les mots de passe
Un fichier PFX, également appelé fichier PKCS#12 et généralement doté d’une extension .pfx ou .p12, peut contenir un certificat X.509, sa clé privée et la chaîne de certificats. La clé privée est ce qui permet au titulaire de créer une signature. Un certificat sans clé privée accessible ne peut pas être utilisé pour signer une présentation.
Le mot de passe PFX protège le paquet du certificat et la clé privée. Il n’est pas un mot de passe pour ouvrir ou modifier la présentation. Ne validez pas les fichiers PFX ni leurs mots de passe dans le contrôle de version. En production, limitez l’accès au fichier de certificat et récupérez son mot de passe depuis un magasin de secrets ou une autre source de configuration protégée. Les exemples ci‑dessous utilisent uniquement une variable d’environnement pour éviter d’intégrer le mot de passe dans le code.
Ajouter une signature numérique à une présentation
Pour signer un flux de travail réel, chargez un fichier PPTX existant, créez un DigitalSignature à partir d’un certificat PFX et de son mot de passe, ajoutez la signature à la collection de la présentation, puis enregistrez dans un fichier PPTX.
$certificatePassword = getenv("PFX_PASSWORD");
if ($certificatePassword === false || $certificatePassword === "") {
throw new RuntimeException("Set the PFX_PASSWORD environment variable.");
}
$presentation = new Presentation("InputPresentation.pptx");
try {
$signature = new DigitalSignature("signing-certificate.pfx", $certificatePassword);
$signature->setComments("Approved for release.");
$presentation->getDigitalSignatures()->add($signature);
$presentation->save("InputPresentation-signed.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Enregistrer le résultat sous un nouveau nom préserve le fichier source non signé. La valeur définie par DigitalSignature::setComments décrit le but de la signature ; ce n’est pas un contrôle de sécurité.
Valider les signatures numériques
Lorsque vous chargez un fichier PPTX signé, inspectez chaque élément renvoyé par Presentation::getDigitalSignatures. La méthode DigitalSignature::isValid indique si la signature intégrée est valide pour le contenu actuel de la présentation.
$presentation = new Presentation("InputPresentation-signed.pptx");
try {
$signatures = $presentation->getDigitalSignatures();
$signatureCount = java_values($signatures->size());
if ($signatureCount === 0) {
echo "The presentation does not contain digital signatures." . PHP_EOL;
} else {
$allSignaturesAreValid = true;
$signTimeFormat = new Java("java.text.SimpleDateFormat", "yyyy-MM-dd HH:mm:ss");
$certificateFactoryClass = new JavaClass("java.security.cert.CertificateFactory");
$certificateFactory = $certificateFactoryClass->getInstance("X.509");
for ($index = 0; $index < $signatureCount; $index++) {
$signature = $signatures->get_Item($index);
$signatureIsValid = java_values($signature->isValid());
$signatureStatus = $signatureIsValid ? "VALID" : "INVALID";
$formattedSignTime = java_values($signTimeFormat->format($signature->getSignTime()));
$certificateData = $signature->getCertificate();
$certificateStream = new Java("java.io.ByteArrayInputStream", $certificateData);
try {
$certificate = $certificateFactory->generateCertificate($certificateStream);
$signerName = java_values($certificate->getSubjectX500Principal()->getName());
} finally {
$certificateStream->close();
}
echo $signerName . ", " . $formattedSignTime . " -- " . $signatureStatus . PHP_EOL;
$allSignaturesAreValid = $allSignaturesAreValid && $signatureIsValid;
}
if ($allSignaturesAreValid) {
echo "All embedded signatures are valid for the current presentation." . PHP_EOL;
} else {
echo "At least one embedded signature is invalid." . PHP_EOL;
}
}
} finally {
$presentation->dispose();
}
Un résultat invalide signifie généralement que le contenu de la présentation signée ou les données de la signature ont été modifiés après la signature, ou que le fichier est endommagé. Supprimer toutes les signatures produit une présentation non signée, donc vérifier uniquement la validité des éléments n’est pas suffisant : un flux de travail sensible à la sécurité doit également vérifier que le nombre attendu de signatures et les identités attendues des signataires sont présents.
Ce résultat de validité ne doit pas être considéré comme une décision complète de confiance du certificat. Selon votre politique de sécurité, votre application peut également devoir construire et valider la chaîne de certificats X.509, vérifier les dates de validité et l’état de révocation du certificat, confirmer le sujet ou l’empreinte attendu(e), vérifier l’usage de la clé et évaluer un horodatage fiable. La valeur renvoyée par DigitalSignature::getSignTime à elle seule n’est pas une preuve provenant d’une autorité d’horodatage fiable.
Supprimer les signatures numériques
La suppression des signatures modifie l’état de sécurité de la présentation. L’exemple suivant charge un fichier PPTX signé, supprime toutes les signatures avec DigitalSignatureCollection::clear, et enregistre une copie non signée.
$presentation = new Presentation("InputPresentation-signed.pptx");
try {
$presentation->getDigitalSignatures()->clear();
$presentation->save("InputPresentation-unsigned.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Pour supprimer une seule signature, appelez DigitalSignatureCollection::removeAt avec son indice basé sur zéro. Enregistrez dans un nouveau fichier sauf si l’écrasement de l’original signé fait explicitement partie de votre flux de travail.
Considérations d’édition et de format
- Une signature ne rend pas une présentation en lecture seule. Les utilisateurs et les applications peuvent toujours modifier le fichier, mais les changements du contenu signé invalident généralement la signature existante.
- Effectuez toutes les modifications prévues avant de signer. Si une présentation doit être modifiée, enregistrez la version révisée et signez à nouveau cette révision.
- Conservez la sortie finale au format PPTX. Convertir une présentation signée dans un autre format ne transfère pas la signature PPTX originale comme signature valide pour le fichier converti.
- Considérez la clé privée du certificat comme sensible. Toute personne qui obtient la clé privée et son mot de passe peut créer des signatures qui semblent provenir du titulaire du certificat.
- Conservez la source non signée ou une autre copie contrôlée lorsque votre politique de rétention documentaire l’exige.
FAQ
Une signature numérique chiffre-t-elle la présentation ?
Non. Une signature numérique fournit une preuve d’origine et d’intégrité, mais le contenu de la présentation reste lisible à moins qu’un chiffrement séparé ne soit appliqué. Utilisez protection par mot de passe lorsque l’accès au contenu doit être restreint.
Le mot de passe PFX est‑il identique au mot de passe d’une présentation ?
Non. Le mot de passe PFX débloque la clé privée stockée dans le paquet du certificat. Il ne contrôle pas qui peut ouvrir ou modifier le fichier PPTX.
Puis‑je utiliser un certificat auto‑signé ?
Techniquement, un certificat auto‑signé peut être utilisé lorsqu’il inclut une clé privée accessible. Les destinataires ne le feront pas automatiquement confiance, à moins que ce certificat n’ait été explicitement ajouté à leur environnement de confiance. Les flux de travail publics ou inter‑organisationnels utilisent généralement un certificat émis par une CA de confiance.
Qu’est‑ce qui rend une signature invalide ?
Modifier le contenu signé de la présentation ou les données de la signature après la signature peut invalider la signature. La corruption du fichier peut également entraîner un échec de validation. Si toutes les signatures sont supprimées, la présentation est non signée plutôt qu’un fichier contenant une signature invalide.
Une signature valide signifie‑t‑elle que je dois faire confiance au signataire ?
Pas en soi. L’intégrité de la signature et la confiance envers le signataire sont des décisions séparées. Une politique de validation en production doit également vérifier la chaîne de certificats, la période de validité, l’état de révocation, l’identité attendue, l’usage de la clé et tout besoin d’horodatage fiable.
Que se passe‑t‑il lorsque le certificat expire ?
L’expiration du certificat n’altère pas les octets de la présentation, mais affecte l’évaluation de la confiance du certificat. Le fait qu’une signature reste acceptable dépend de votre politique et de l’existence d’un horodatage fiable prouvant que la signature a été effectuée alors que le certificat était valide. Ne vous fiez pas uniquement à l’heure d’inscription affichée comme horodatage fiable.
Une présentation signée peut‑elle encore être éditée ?
Oui. La signature ne verrouille pas le fichier. Modifier le contenu signé rend généralement la signature existante invalide, donc terminez d’abord la présentation et signez la révision finale.
Une présentation peut‑elle contenir plusieurs signatures ?
Oui. Ajoutez chaque signature à la collection renvoyée par Presentation::getDigitalSignatures avant d’enregistrer. Lors de la validation, inspectez chaque signature et confirmez que tous les signataires requis sont présents.
Quels formats de présentation prennent en charge ces opérations ?
Aspose.Slides prend en charge les opérations de signature numérique décrites ici uniquement pour PPTX. Les formats PPT et OpenDocument ne sont pas pris en charge par ce flux de travail d’API.
Puis‑je supprimer une signature sans affecter les diapositives ?
Oui. Vous pouvez supprimer une signature ou vider toute la collection, puis enregistrer la présentation. Le contenu des diapositives demeure disponible, mais le fichier enregistré ne comporte plus la preuve de signature supprimée.