Navegación
El servicio de firma remota de código ofrece varios clientes, proveedores de sistema, interfaces de desarrollo y métodos de integración automatizados.
Si no estás seguro de qué método elegir, puedes empezar según el escenario de uso a continuación.
Cómo elegir el método de integración
| Escenario de uso | Método recomendado |
|---|---|
| Usar la herramienta oficial de línea de comandos para firmar directamente archivos EXE, DLL, MSI, etc. | Herramienta de cliente |
| Instalar el cliente de firma de código mediante Homebrew en macOS | Herramienta de cliente |
| Herramientas de Windows como Microsoft SignTool, Visual Studio, MSBuild que necesitan usar directamente la clave privada remota | Windows Provider |
| Necesidad de compatibilidad con aplicaciones tradicionales de Windows CryptoAPI / CSP | Windows Provider |
Usar jarsigner para firmar archivos Java JAR | Integración Java |
| Automatizar la firma de código en GitHub Actions | CI/CD y herramientas de compilación |
| Usar Electron Builder para automatizar la firma de aplicaciones de Windows | CI/CD y herramientas de compilación |
| Usar Advanced Installer para crear y firmar el paquete de instalación | CI/CD y herramientas de compilación |
| Desarrollar un cliente propio o llamar directamente al servicio de firma remota | Integración de API |
| Consultar el número de firmas, servidores de marca de tiempo y otra información pública | Material de referencia |
Herramientas del cliente
Adecuado para usuarios que desean utilizar directamente el cliente oficial de sslTrus para completar la firma de código.
Incluye principalmente:
- SignTool CLI: completa la firma de archivos directamente mediante la línea de comandos.
- Consulta de créditos de firma: consulta los créditos de firma restantes y totales del certificado.
- Actualización del cliente: consulta e instala la versión más reciente.
- Homebrew: instala la CLI o el cliente de escritorio en macOS.
Ver herramientas del cliente →
Windows Provider
Adecuado para Microsoft SignTool, Visual Studio, MSBuild, herramientas de empaquetado y otros programas compatibles con la API de criptografía de Windows.
Se ofrecen dos proveedores:
- KSP (Key Storage Provider): basado en Windows CNG, adecuado para los flujos de firma modernos de Windows.
- CSP (Cryptographic Service Provider): basado en la CryptoAPI tradicional, adecuado para aplicaciones que requieren compatibilidad con CSP.
La clave privada de firma siempre se conserva en el HSM en la nube, y el proveedor local se encarga de enviar las solicitudes de firma al servicio remoto de firma de código.
Integración con Java
Adecuado para escenarios de firma de código Java.
Con el proveedor de Java de sslTrus, puede utilizar la herramienta estándar jarsigner para ejecutar la firma remota de código en archivos JAR.
CI/CD y herramientas de compilación
Adecuado para escenarios en los que es necesario integrar la firma de código en procesos de compilación, publicación o empaquetado automatizados.
Actualmente incluye:
- GitHub Actions
- Electron Builder
- Advanced Installer
Más adelante, en esta página también se proporcionarán los métodos de integración de otras herramientas de CI/CD o de compilación.
Ver CI/CD y herramientas de compilación →
Integración de la API
Adecuado para desarrolladores que necesitan crear su propio cliente de firma de código o integrar la capacidad de firma remota en sistemas existentes.
La API de firma remota de código admite:
- Enviar el resumen pendiente de firma y obtener el resultado de la firma.
- Informar el estado final del procesamiento de la firma por parte del cliente.
La parte que realiza la llamada es responsable de completar localmente el cálculo del resumen del archivo, el procesamiento de la estructura de firma y la escritura del resultado final de la firma.
Material de referencia
Aquí se ofrece información de referencia común aplicable a múltiples métodos de integración, que incluye:
- Explicación del cálculo de las veces de firma: explica cómo se calculan las veces de firma en escenarios como CLI, KSP, CSP, Jarsigner, Electron y paquetes de instalación.
- Servidor de sello de tiempo: presenta Authenticode, RFC 3161 y los servicios de sello de tiempo de firma de código de uso común.