Firma de paquetes de proyecto

Firma de paquetes de proyecto

UiPath CLI 25.10 introduce la capacidad de firmar digitalmente paquetes de proyectos de automatización durante la operación de empaquetado. La firma de paquetes proporciona verificación de autenticidad y garantiza que los paquetes no hayan sido manipulados después de su creación, lo que mejora la seguridad en tu proceso de CI/CD.

Al firmar un paquete de proyecto, la CLI:

1. Crea el archivo de paquete .nupkg
2. Aplica una firma digital utilizando su certificado
3. Opcionalmente, marca la fecha de la firma para una validez a largo plazo

Tipos de certificados compatibles

CLI admite el formato de certificado PKCS#12 (.pfx).

Importante:

El certificado debe:

• Incluir una clave privada para firmar
• Ser válido (no caducado)
• Tener capacidades de firma de código

Parámetros

El comando package pack admite los siguientes parámetros de firma:

Parámetro	Descripción	Obligatorio
--certificatePath	Ruta al archivo de certificado (.pfx)	Sí (si firma)
--certificatePassword	Contraseña para el archivo de certificado	No
--timestampServerUrl	URL del servidor de marcas de tiempo RFC 3161	No

Ejemplos de uso

Firma básica con certificado

# Windows
uipcli package pack "C:\Projects\MyRobot\project.json" `
  -o "C:\Packages" `
  --certificatePath "C:\Certificates\codesign.pfx" `
  --certificatePassword "YourPassword123"

# Linux/macOS
uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  --certificatePath "./certificates/codesign.pfx" \
  --certificatePassword "YourPassword123"

Firma con el servidor de marca de tiempo

Añadir una marca de tiempo garantiza que la firma siga siendo válida incluso después de que caduque el certificado.

uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  --certificatePath "./certificates/codesign.pfx" \
  --certificatePassword "YourPassword123" \
  --timestampServerUrl "http://timestamp.digicert.com"

Firma con versión y tipo de salida

uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  -v "1.0.5" \
  --outputType "Process" \
  --certificatePath "./certificates/codesign.pfx" \
  --certificatePassword "YourPassword123" \
  --timestampServerUrl "http://timestamp.digicert.com"

Firmar con certificado sin contraseña

uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  --certificatePath "./certificates/codesign.pfx"

Firmar con dependencias de la biblioteca de Orchestrator

uipcli package pack "./MyRobot/project.json" \
  -o "./packages" \
  --libraryOrchestratorUrl "https://cloud.uipath.com/" \
  --libraryOrchestratorTenant "Default" \
  -A "myorg" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S '********' \
  --libraryOrchestratorApplicationScope "OR.Folders OR.Execution" \
  --certificatePath "./certificates/codesign.pfx" \
  --certificatePassword "YourPassword123" \
  --timestampServerUrl "http://timestamp.digicert.com"

Servidores de marca de tiempo recomendados

Se recomienda utilizar un servidor de marcas de tiempo para garantizar que las firmas sigan siendo válidas después de la expiración del certificado:

• http://timestamp.digicert.com - DigiCert
• http://timestamp.comodoca.com : Sectigo (Comodo)
• http://timestamp.globalsign.com : GlobalSign
• http://timestamp.sectigo.com : sección

Mejores prácticas

Almacenamiento seguro de certificados

• Nunca enviar certificados al control de versiones
• Utiliza soluciones de almacenamiento seguro:
  • Azure Key Vault
  • AWS Secrets Manager
  • HashiCorp Vault
  • Secretos de GitHub/Archivos seguros de Azure DevOps
  • Gestión de secretos de la plataforma CI/CD

Variables de entorno

• Utilizar variables de entorno o gestión de secretos para contraseñas
• Evite codificar información confidencial en los scripts

Uso de la marca de tiempo

• Utilice siempre un servidor de marcas de tiempo en entornos de producción
• Las marcas de tiempo garantizan la validez de la firma más allá de la expiración del certificado

Gestión de certificados

• Utilizar certificados de firma de código dedicados
• Rotar certificados antes de que caduquen
• Mantener copias de seguridad de certificados de forma segura