Adicionar assinaturas digitais a apresentações no Android
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; não criptografa a apresentação.
- Proteção por senha controla se um usuário pode abrir ou modificar uma apresentação. É separada da assinatura digital e é descrita em Apresentações protegidas por senha.
O PowerPoint fornece o comando Adicionar uma assinatura digital em Arquivo > Informações > 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 através de IPresentation.getDigitalSignatures, que retorna uma IDigitalSignatureCollection cujos itens implementam IDigitalSignature. Uma apresentação pode conter várias assinaturas.
Entender certificados PFX e senhas
Um arquivo PFX, também conhecido como arquivo PKCS#12 e comumente 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 PFX protege o pacote de 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 armazenamento 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 um DigitalSignature a partir de um certificado PFX e sua senha, adicione a assinatura à coleção da apresentação e salve em um arquivo PPTX.
import com.aspose.slides.*;
String certificatePassword = System.getenv("PFX_PASSWORD");
if (certificatePassword == null || certificatePassword.isEmpty()) {
throw new IllegalStateException("Set the PFX_PASSWORD environment variable.");
}
Presentation presentation = new Presentation("InputPresentation.pptx");
try {
DigitalSignature 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();
}
Salvar o resultado com um novo nome preserva o arquivo fonte não assinado. O valor definido por IDigitalSignature.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 IPresentation.getDigitalSignatures. O método IDigitalSignature.isValid indica se a assinatura incorporada é válida para o conteúdo atual da apresentação.
import com.aspose.slides.*;
Presentation presentation = new Presentation("InputPresentation-signed.pptx");
try {
IDigitalSignatureCollection signatures = presentation.getDigitalSignatures();
int signatureCount = signatures.size();
if (signatureCount == 0) {
System.out.println("The presentation does not contain digital signatures.");
} else {
boolean allSignaturesAreValid = true;
java.text.SimpleDateFormat signTimeFormat = new java.text.SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
java.security.cert.CertificateFactory certificateFactory = java.security.cert.CertificateFactory.getInstance("X.509");
for (IDigitalSignature signature : signatures) {
boolean signatureIsValid = signature.isValid();
String signatureStatus = signatureIsValid ? "VALID" : "INVALID";
java.util.Date signTime = signature.getSignTime();
String formattedSignTime = signTimeFormat.format(signTime);
byte[] certificateData = signature.getCertificate();
java.io.ByteArrayInputStream certificateStream = new java.io.ByteArrayInputStream(certificateData);
java.security.cert.X509Certificate certificate = (java.security.cert.X509Certificate) certificateFactory.generateCertificate(certificateStream);
javax.security.auth.x500.X500Principal signerPrincipal = certificate.getSubjectX500Principal();
String signerName = signerPrincipal.getName();
System.out.println(signerName + ", " + formattedSignTime + " -- " + signatureStatus);
allSignaturesAreValid &= signatureIsValid;
}
if (allSignaturesAreValid) {
System.out.println("All embedded signatures are valid for the current presentation.");
} else {
System.out.println("At least one embedded signature is invalid.");
}
}
} finally {
presentation.dispose();
}
Um resultado inválido geralmente 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 esperadas dos signatários 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 esperada, verificar o uso da chave e avaliar um carimbo de tempo confiável. O valor de IDigitalSignature.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 IDigitalSignatureCollection.clear, e salva uma cópia não assinada.
Presentation presentation = new Presentation("InputPresentation-signed.pptx");
try {
presentation.getDigitalSignatures().clear();
presentation.save("InputPresentation-unsigned.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Para remover apenas uma assinatura, chame IDigitalSignatureCollection.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 mudanças no conteúdo assinado normalmente invalidam a assinatura existente.
- Conclua todas as edições previstas 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 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 ser capaz de criar assinaturas que parecem vir do titular do certificado.
- Preserve o arquivo fonte não assinado ou outra cópia controlada quando sua política de retenção de documentos exigir.
FAQ
A assinatura digital criptografa a apresentação?
Não. Uma assinatura digital fornece evidência sobre a origem e a 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 precisar 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. Os destinatários não o confiarão automaticamente, a menos que o certificado tenha sido explicitamente adicionado ao ambiente confiável deles. Fluxos de trabalho públicos ou entre organizações geralmente utilizam um certificado emitido por uma CA confiável.
O que torna uma assinatura inválida?
Alterar o conteúdo assinado da apresentação ou os dados da assinatura após a assinatura pode invalidar a assinatura. Danos ao arquivo também podem fazer a validação falhar. Se todas as assinaturas forem removidas, a apresentação ficará não assinada, não contendo 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 deve também verificar a cadeia de certificados, período de validade, status de revogação, identidade esperada, 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 prova que a assinatura foi feita enquanto o certificado ainda era válido. Não confie apenas no horário de assinatura exibido como 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 invalida a assinatura existente, portanto finalize 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 IPresentation.getDigitalSignatures antes de salvar. Durante a validação, inspecione cada assinatura e confirme que todos os signatários requeridos 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 PPT e OpenDocument não são suportados por esse fluxo de 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.