Agregar firmas digitales a presentaciones en Android
Visión general
Una firma digital ayuda al destinatario a determinar quién firmó una presentación y si el contenido firmado ha cambiado. Aquí son importantes tres conceptos de seguridad relacionados:
- Un digital certificate es una credencial electrónica que asocia una identidad con una clave pública. Una autoridad certificadora (CA) de confianza puede emitir un certificado, o una organización puede usar un certificado autofirmado para flujos de trabajo internos.
- Una digital signature se crea a partir del contenido de la presentación y la clave privada del titular del certificado. La clave pública del certificado puede entonces usarse para verificar la firma. Una firma proporciona evidencia de origen e integridad; no cifra la presentación.
- Password protection controla si un usuario puede abrir o modificar una presentación. Es independiente de la firma digital y se describe en Presentaciones protegidas con contraseña.
PowerPoint proporciona el comando Agregar una firma digital bajo File > Info > Protect Presentation.
Después de abrir una presentación firmada, PowerPoint puede mostrar una notificación de estado de la firma.
Aspose.Slides expone firmas a través de IPresentation.getDigitalSignatures, que devuelve una IDigitalSignatureCollection cuyos elementos implementan IDigitalSignature. Una presentación puede contener varias firmas.
Comprender los certificados PFX y las contraseñas
Un archivo PFX, también conocido como archivo PKCS#12 y habitualmente con extensión .pfx o .p12, puede contener un certificado X.509, su clave privada y la cadena de certificados. La clave privada es lo que permite al titular crear una firma. Un certificado sin una clave privada accesible no puede usarse para firmar una presentación.
La contraseña del PFX protege el paquete del certificado y la clave privada. No es una contraseña para abrir o editar la presentación. No incluya archivos PFX ni sus contraseñas en el control de versiones. En producción, limite el acceso al archivo del certificado y obtenga su contraseña desde un almacén de secretos u otra fuente de configuración protegida. Los ejemplos a continuación usan una variable de entorno solo para evitar incrustar la contraseña en el código.
Agregar una firma digital a una presentación
Para firmar un flujo de trabajo real, cargue un archivo PPTX existente, cree un DigitalSignature a partir de un certificado PFX y su contraseña, añada la firma a la colección de la presentación y guarde el archivo 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();
}
Guardar el resultado con un nombre nuevo conserva el archivo fuente sin firmar. El valor establecido mediante IDigitalSignature.setComments describe el propósito de la firma; no es un control de seguridad.
Validar firmas digitales
Al cargar un archivo PPTX firmado, inspeccione cada elemento devuelto por IPresentation.getDigitalSignatures. El método IDigitalSignature.isValid indica si la firma incrustada es válida para el contenido actual de la presentación.
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();
}
Un resultado inválido suele significar que el contenido firmado de la presentación o los datos de la firma cambiaron después de la firma, o que el archivo está dañado. Eliminar todas las firmas produce una presentación sin firmar, por lo que comprobar solo la validez de los elementos no es suficiente: un flujo de trabajo sensible a la seguridad también debe verificar que el número esperado de firmas y las identidades esperadas de los firmantes estén presentes.
Este resultado de validez no debe tomarse como una decisión completa de confianza en el certificado. Según la política de seguridad, su aplicación también puede necesitar construir y validar la cadena de certificados X.509, comprobar fechas de validez y estado de revocación del certificado, confirmar el sujeto o la huella esperada, verificar el uso de la clave y evaluar una marca de tiempo confiable. El valor devuelto por IDigitalSignature.getSignTime por sí solo no constituye prueba de una autoridad de marca de tiempo confiable.
Eliminar firmas digitales
Eliminar firmas cambia el estado de seguridad de la presentación. El siguiente ejemplo carga un archivo PPTX firmado, elimina todas las firmas con IDigitalSignatureCollection.clear, y guarda una copia sin firmar.
Presentation presentation = new Presentation("InputPresentation-signed.pptx");
try {
presentation.getDigitalSignatures().clear();
presentation.save("InputPresentation-unsigned.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Para eliminar solo una firma, llame a IDigitalSignatureCollection.removeAt con su índice basado en cero. Guarde en un archivo nuevo salvo que sobrescribir el original firmado sea una parte explícita de su flujo de trabajo.
Consideraciones de edición y formato
- Una firma no hace que la presentación sea de solo lectura. Los usuarios y aplicaciones aún pueden editar el archivo, pero los cambios en el contenido firmado normalmente invalidan la firma existente.
- Realice todas las ediciones previstas antes de firmar. Si la presentación debe modificarse, guarde la versión revisada y firme esa revisión nuevamente.
- Mantenga el resultado final en formato PPTX. Convertir una presentación firmada a otro formato no transfiere la firma PPTX original como una firma válida para el archivo convertido.
- Trate la clave privada del certificado como información sensible. Cualquiera que obtenga la clave privada y su contraseña puede crear firmas que aparenten provenir del titular del certificado.
- Conserve la fuente sin firmar u otra copia controlada cuando su política de retención de documentos lo requiera.
Preguntas frecuentes
¿Una firma digital cifra la presentación?
No. Una firma digital proporciona evidencia sobre el origen y la integridad, pero el contenido de la presentación sigue siendo legible a menos que se aplique un cifrado separado. Use presentaciones protegidas con contraseña cuando el acceso al contenido deba estar restringido.
¿La contraseña del PFX es la misma que la contraseña de la presentación?
No. La contraseña del PFX desbloquea la clave privada almacenada en el paquete del certificado. No controla quién puede abrir o editar el archivo PPTX.
¿Puedo usar un certificado autofirmado?
Técnicamente, un certificado autofirmado puede usarse siempre que incluya una clave privada accesible. Sin embargo, los destinatarios no lo confiarán automáticamente, a menos que ese certificado se haya añadido explícitamente a su entorno de confianza. Los flujos de trabajo públicos o interorganizacionales generalmente usan un certificado emitido por una CA de confianza.
¿Qué hace que una firma sea inválida?
Cambiar el contenido firmado de la presentación o los datos de la firma después de la firma puede invalidar la firma. La corrupción del archivo también puede provocar que la validación falle. Si se eliminan todas las firmas, la presentación queda sin firmar, no contiene una firma inválida.
¿Una firma válida significa que debo confiar en el firmante?
No por sí sola. La integridad de la firma y la confianza en el firmante son decisiones separadas. Una política de validación en producción también debe comprobar la cadena de certificados, el período de validez, el estado de revocación, la identidad esperada, el uso de la clave y cualquier requisito de marca de tiempo confiable.
¿Qué ocurre cuando el certificado expira?
La expiración del certificado no altera los bytes de la presentación, pero afecta la evaluación de confianza del certificado. Si una firma sigue siendo aceptable depende de su política y de si una marca de tiempo confiable prueba que la firma se realizó mientras el certificado era válido. No confíe únicamente en la hora de firma mostrada como una marca de tiempo confiable.
¿Una presentación firmada todavía puede editarse?
Sí. Firmar no bloquea el archivo. Editar el contenido firmado generalmente invalida la firma existente, por lo que debe terminar la presentación y firmar la revisión final.
¿Una presentación puede contener más de una firma?
Sí. Añada cada firma a la colección devuelta por IPresentation.getDigitalSignatures antes de guardar. Durante la validación, inspeccione cada firma y confirme que todos los firmantes requeridos estén presentes.
¿Qué formatos de presentación admiten estas operaciones?
Aspose.Slides admite las operaciones de firma digital descritas aquí solo para PPTX. Los formatos PPT y OpenDocument no son compatibles con este flujo de trabajo de la API.
¿Puedo eliminar una firma sin afectar las diapositivas?
Sí. Puede eliminar una firma o vaciar la colección completa y luego guardar la presentación. El contenido de las diapositivas sigue disponible, pero el archivo guardado ya no lleva la evidencia de la firma eliminada.