Adicionar assinaturas digitais a apresentações em JavaScript
Visão geral
Uma assinatura digital ajuda o destinatário a determinar quem assinou uma apresentação e se o conteúdo assinado foi alterado. Três conceitos de segurança relacionados são importantes aqui:
- Um certificado digital é uma credencial eletrônica que associa uma identidade a uma chave pública. Uma autoridade certificadora (CA) confiável pode emitir um certificado, ou uma organização pode usar um certificado autoassinado para fluxos de trabalho internos.
- Uma assinatura digital é criada a partir do conteúdo da apresentação e da chave privada do titular do certificado. A chave pública do certificado pode então ser usada para verificar a assinatura. Uma assinatura fornece evidência de origem e integridade; ela não criptografa a apresentação.
- Proteção por senha controla se um usuário pode abrir ou modificar uma apresentação. Ela é separada da assinatura digital e está descrita em Apresentações protegidas por senha.
O PowerPoint fornece o comando Adicionar assinatura digital em Arquivo > Info > Proteger Apresentação.
Depois que uma apresentação assinada é aberta, o PowerPoint pode exibir uma notificação de status da assinatura.
Aspose.Slides expõe assinaturas por meio de Presentation.getDigitalSignatures, que devolve uma DigitalSignatureCollection contendo objetos DigitalSignature. Uma apresentação pode conter várias assinaturas.
Entender certificados PFX e senhas
Um arquivo PFX, também conhecido como arquivo PKCS#12 e geralmente com extensão .pfx ou .p12, pode conter um certificado X.509, sua chave privada e a cadeia de certificados. A chave privada é o que permite ao titular criar uma assinatura. Um certificado sem uma chave privada acessível não pode ser usado para assinar uma apresentação.
A senha do PFX protege o pacote do certificado e a chave privada. Ela não é uma senha para abrir ou editar a apresentação. Não faça commit de arquivos PFX ou suas senhas no controle de versão. Em produção, limite o acesso ao arquivo de certificado e obtenha sua senha de um cofre de segredos ou outra fonte de configuração protegida. Os exemplos abaixo usam uma variável de ambiente apenas para evitar incorporar a senha no código.
Adicionar uma assinatura digital a uma apresentação
Para assinar um fluxo de trabalho de apresentação real, carregue um arquivo PPTX existente, crie uma DigitalSignature a partir de um certificado PFX e sua senha, adicione a assinatura à coleção da apresentação e salve em um arquivo PPTX.
const slides = require("aspose.slides.via.java");
const certificatePassword = process.env.PFX_PASSWORD;
if (!certificatePassword) {
throw new Error("Set the PFX_PASSWORD environment variable.");
}
const presentation = new slides.Presentation("InputPresentation.pptx");
try {
const signature = new slides.DigitalSignature("signing-certificate.pfx", certificatePassword);
signature.setComments("Approved for release.");
presentation.getDigitalSignatures().add(signature);
presentation.save("InputPresentation-signed.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Salvar o resultado com um novo nome preserva o arquivo fonte não assinado. O valor definido por DigitalSignature.setComments descreve o propósito da assinatura; não é um controle de segurança.
Validar assinaturas digitais
Ao carregar um arquivo PPTX assinado, inspecione cada item retornado por Presentation.getDigitalSignatures. O método DigitalSignature.isValid indica se a assinatura incorporada é válida para o conteúdo atual da apresentação.
O exemplo a seguir também usa a classe Node.js X509Certificate para ler o nome do assunto de cada certificado incorporado.
const { X509Certificate } = require("node:crypto");
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("InputPresentation-signed.pptx");
try {
const signatures = presentation.getDigitalSignatures();
const signatureCount = signatures.size();
if (signatureCount === 0) {
console.log("The presentation does not contain digital signatures.");
} else {
let allSignaturesAreValid = true;
for (let index = 0; index < signatureCount; index++) {
const signature = signatures.get_Item(index);
const signatureIsValid = signature.isValid();
const signatureStatus = signatureIsValid ? "VALID" : "INVALID";
const signTime = signature.getSignTime().toString();
const certificateData = signature.getCertificate();
const certificate = new X509Certificate(Buffer.from(certificateData));
const signerName = certificate.subject;
console.log(`${signerName}, ${signTime} -- ${signatureStatus}`);
allSignaturesAreValid = allSignaturesAreValid && signatureIsValid;
}
if (allSignaturesAreValid) {
console.log("All embedded signatures are valid for the current presentation.");
} else {
console.log("At least one embedded signature is invalid.");
}
}
} finally {
presentation.dispose();
}
Um resultado inválido normalmente significa que o conteúdo da apresentação assinada ou os dados da assinatura foram alterados após a assinatura, ou que o arquivo está danificado. Remover todas as assinaturas produz uma apresentação não assinada, portanto, verificar apenas a validade dos itens não é suficiente: um fluxo de trabalho sensível à segurança também deve verificar se o número esperado de assinaturas e as identidades dos signatários esperados estão presentes.
Esse resultado de validade não deve ser tratado como uma decisão completa de confiança no certificado. Dependendo da sua política de segurança, sua aplicação pode também precisar construir e validar a cadeia de certificados X.509, verificar datas de validade e status de revogação do certificado, confirmar o sujeito ou impressão digital esperados, validar o uso da chave e avaliar um carimbo de tempo confiável. O valor de DigitalSignature.getSignTime por si só não é prova de uma autoridade de carimbo de tempo confiável.
Remover assinaturas digitais
Remover assinaturas altera o estado de segurança da apresentação. O exemplo a seguir carrega um arquivo PPTX assinado, remove todas as assinaturas com DigitalSignatureCollection.clear, e salva uma cópia não assinada.
const slides = require("aspose.slides.via.java");
const presentation = new slides.Presentation("InputPresentation-signed.pptx");
try {
presentation.getDigitalSignatures().clear();
presentation.save("InputPresentation-unsigned.pptx", slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Para remover apenas uma assinatura, chame DigitalSignatureCollection.removeAt com seu índice baseado em zero. Salve em um novo arquivo, a menos que sobrescrever o original assinado seja uma parte explícita do seu fluxo de trabalho.
Considerações de edição e formato
- Uma assinatura não torna a apresentação somente leitura. Usuários e aplicações ainda podem editar o arquivo, mas alterações no conteúdo assinado normalmente invalidam a assinatura existente.
- Conclua todas as edições pretendidas antes de assinar. Se a apresentação precisar ser alterada, salve a apresentação revisada e assine essa revisão novamente.
- Mantenha a saída final no formato PPTX. Converter uma apresentação assinada para outro formato não transfere a assinatura original do PPTX como uma assinatura válida para o arquivo convertido.
- Trate a chave privada do certificado como sensível. Qualquer pessoa que obtenha a chave privada e sua senha pode criar assinaturas que pareçam vir do titular desse certificado.
- Mantenha a fonte não assinada ou outra cópia controlada quando sua política de retenção de documentos exigir.
Perguntas frequentes
A assinatura digital criptografa a apresentação?
Não. Uma assinatura digital fornece evidência sobre a origem e integridade, mas o conteúdo da apresentação permanece legível a menos que uma criptografia separada seja aplicada. Use proteção por senha quando o acesso ao conteúdo deve ser restrito.
A senha PFX é a mesma que a senha da apresentação?
Não. A senha PFX desbloqueia a chave privada armazenada no pacote do certificado. Ela não controla quem pode abrir ou editar o arquivo PPTX.
Posso usar um certificado autoassinado?
Tecnicamente, um certificado autoassinado pode ser usado quando inclui uma chave privada acessível. Contudo, os destinatários não o confiarão automaticamente, a menos que esse certificado tenha sido explicitamente adicionado ao ambiente confiável deles. Fluxos de trabalho públicos ou entre organizações geralmente usam um certificado emitido por uma CA confiável.
O que torna uma assinatura inválida?
Alterar o conteúdo da apresentação assinada ou os dados da assinatura após a assinatura pode invalidar a assinatura. A corrupção do arquivo também pode fazer a validação falhar. Se todas as assinaturas forem removidas, a apresentação fica não assinada, em vez de conter uma assinatura inválida.
Uma assinatura válida significa que devo confiar no assinante?
Não, por si só. A integridade da assinatura e a confiança no assinante são decisões distintas. Uma política de validação em produção também deve verificar a cadeia de certificados, o período de validade, o status de revogação, a identidade esperada, o uso da chave e quaisquer requisitos de carimbo de tempo confiável.
O que acontece quando o certificado expira?
A expiração do certificado não altera os bytes da apresentação, mas afeta a avaliação de confiança do certificado. Se uma assinatura permanece aceitável depende da sua política e de se um carimbo de tempo confiável válido comprova que a assinatura ocorreu enquanto o certificado era válido. Não confie apenas no horário de assinatura exibido como um carimbo de tempo confiável.
Uma apresentação assinada ainda pode ser editada?
Sim. A assinatura não bloqueia o arquivo. Editar o conteúdo assinado geralmente torna a assinatura existente inválida, portanto, termine a apresentação primeiro e assine a revisão final.
Uma apresentação pode conter mais de uma assinatura?
Sim. Adicione cada assinatura à coleção retornada por Presentation.getDigitalSignatures antes de salvar. Durante a validação, inspecione cada assinatura e confirme que todos os signatários necessários estão presentes.
Quais formatos de apresentação suportam essas operações?
Aspose.Slides suporta as operações de assinatura digital descritas aqui apenas para PPTX. Os formatos de apresentação PPT e OpenDocument não são suportados por este fluxo de trabalho da API.
Posso remover uma assinatura sem afetar os slides?
Sim. Você pode remover uma assinatura ou limpar toda a coleção e então salvar a apresentação. O conteúdo dos slides permanece disponível, mas o arquivo salvo não contém mais a evidência da assinatura removida.