UiPath Documentation
studio
latest
false
Guía del usuario de Studio
Importante :
La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Firma de paquetes

Firme los paquetes NuGet publicados desde Studio utilizando la firma del autor o del repositorio, y firme los conjuntos que genera Studio, para garantizar la seguridad e integridad de los procesos y bibliotecas.

La firma de paquetes está disponible con el fin de garantizar la seguridad e integridad de los procesos y bibliotecas publicados desde Studio.

NuGet ofrece dos formas de firmar paquetes, ya sea por un autor o por un repositorio.

Aplicar el uso de paquetes firmados​

To enforce the use of signed packages, the signatureValidationMode parameter in the Nuget.config file must be set to require. The file is located in the Robot installation folder, by default C:\Program Files\UiPathPlatform\Robot\<version>. You can do this in one of two ways:

  • During installation, by installing from the command line with a configuration file that sets the ENFORCE_SIGNED_EXECUTION parameter of the Robot package to "True".
  • Después de la instalación, editando el archivo Nuget.config. Si estás configurando el parámetro después de la instalación, los cambios tienen efecto después de que:
    1. Reinicies el servicio de UiPath Robot.
    2. Elimines todos los paquetes .NuGet existentes de C:\Program Files\UiPathPlatform\Studio\<version>\Packages y %userprofile%\.nuget\packages.
    3. Reinicies Studio/Assistant.

De forma predeterminada, los paquetes de UiPath son repositorio y firmados por autor. Esto significa que dichos paquetes se pueden descargar e instalar usando Administrar paquetes sin tener que realizar ninguna acción adicional. Para obtener información sobre cómo añadir autores de confianza adicionales y/o propietarios de esta página, consulta la siguiente sección de esta página.

Importante:

Cuando se utilizan varias transmisiones, NuGet elige la que responda más rápido. Si una de las transmisiones no incluye paquetes y dependencias firmados, el UiPath Robot podría recibir un paquete o dependencia que no esté firmado, lo que provocará que la automatización falle. Para evitarlo, asegúrate de que todas las transmisiones configuradas tengan paquetes y dependencias firmados.

Añadir fuentes de confianza​

Para descargar, instalar y ejecutar paquetes firmados con un certificado determinado, añade el certificado necesario como fuente de confianza. Para ello, se puede modificar el archivo nuget.config en la carpeta de instalación, principalmente la sección <trustedSigners>.

Añadir un autor de confianza​

Para añadir un autor de confianza, debes abrir el archivo NuGet.config ubicado en C:\Program Files\UiPathPlatform\Robot\<version>\NuGet.config. Después, proporciona el certificatefingerprint y hashAlgorithm. Consulta esta página para obtener más información sobre la huella del certificado.

Establece el allowUntrustedRoot como true o false:

  • allowUntrustedRoot = "true": el/la firmante de confianza debería poder encadenarse a una raíz que no sea de confianza.
  • allowUntrustedRoot = "false": el/la firmante de confianza no debería poder encadenarse a una raíz que no sea de confianza.

La entrada debe ser similar al siguiente ejemplo:

<trustedSigners>
<author name="UiPath">
<certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true"/>
</author>
</trustedSigners>
<trustedSigners>
<author name="UiPath">
<certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true"/>
</author>
</trustedSigners>

Para obtener más información sobre cómo añadir UiPath como firmante de confianza, consulta Verificación de la firma de paquete en la guía de UiPath Robot.

Añadir un repositorio de confianza​

Añadir un repositorio de confianza se hace más o menos igual que añadir un autor, con la diferencia de que el serviceIndex también debe ser añadido.

A continuación se muestra un ejemplo de un repositorio de confianza añadido al archivo NuGet.config:

<trustedSigners>    
<repository name="UiPath Repository" serviceIndex="https://uipath.repository">
<certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true" />
</repository>
</trustedSigners>
<trustedSigners>    
<repository name="UiPath Repository" serviceIndex="https://uipath.repository">
<certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true" />
</repository>
</trustedSigners>

Añadir propietarios de confianza​

Un repositorio puede tener varios paquetes firmados por un autor. En este caso, se puede utilizar la etiqueta <owners> para instalar los paquetes firmados por los autores de confianza.

Agrega los autores de confianza entre las etiquetas <owners>, como en el siguiente ejemplo:

<trustedSigners>
<repository name="UiPath Repository" serviceIndex="https://uipath.repository">
<certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true" />
<owners>Author1;Author2</owners> 
</repository>
</trustedSigners>
<trustedSigners>
<repository name="UiPath Repository" serviceIndex="https://uipath.repository">
<certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true" />
<owners>Author1;Author2</owners> 
</repository>
</trustedSigners>

Firmar un paquete​

  1. En Studio, la firma de paquetes puede realizarse desde la ventana Publicar, la pestaña Firma de certificados, tanto para los procesos como para las bibliotecas.

  2. En la pestaña Firma de certificado, añade la ruta del certificado en tu máquina local. Si es necesario, utiliza el botón botón para navegar a la ruta si es necesario para navegar hasta la ruta. Solo los formatos de archivo .pfx y .p12 se admiten como formatos de archivo de certificado.

  3. A continuación, escribe la Contraseña de certificado y añade un Marcador de tiempo de certificado opcional si es preciso. Selecciona Publicar. El archivo .nupkg resultante se firma con un certificado y un marcador de tiempo, si se indica.

Resultado​

El paquete se publica como un archivo .nupkg firmado.

Las Marcas de tiempo son una forma de mantener la ruta de la fecha y hora en la que se firmó un paquete. Para obtener más información sobre marcas de tiempo en el contexto de la firma del paquete NuGet, consulta este enlace.

Si la marca de tiempo del certificado no es válida, se mostrará un mensaje de error con el nombre del proyecto en Studio después de hacer clic en el botón Publicar. Aparecerá un mensaje de error similar en el panel Salida.

Nota:

Si la verificación de la firma NO se aplica, los procesos creados con Studio antes de la v2019.4 se siguen ejecutando, independientemente de si están firmados o no.

Usa la herramienta Línea de comandos de actualización en masa para firmar varios paquetes y publicarlos en una ubicación.

Nota:

Tener una dependencia sin firmar en el proyecto puede impedir que se resuelvan otras dependencias al utilizar la función Reparación de dependencias. Elimina el paquete no firmado del proyecto para resolver dependencias firmadas.

Signing Assemblies​

Studio can sign the assemblies it generates for a project with your own code signing certificate, both in published packages and when you run or debug the project. Environments with application control policies that allow only signed code, such as Windows Defender Application Control (WDAC), can then load these assemblies.

La firma de ensamblados requiere una de las siguientes herramientas de firma:

  • signtool.exe : establece su ruta en Ruta de la herramienta de firma en Configuración > Ubicaciones o en la variable de entorno SIGNTOOL_PATH . Firmar la ruta de la herramienta tiene prioridad sobre la variable de entorno.
  • osslsigncode : establece su ruta en la variable de entorno OSSLSIGNCODE_PATH . Se utiliza cuando signtool no está configurado.

Firmar los conjuntos de un paquete publicado​

Para firmar los conjuntos en un paquete al publicarlo, establece la herramienta de firma y luego selecciona Firmar conjuntos en la ventana Publicar . La opción Firmar conjuntos solo está disponible cuando Firmar ruta de herramienta apunta a un archivo existente.

  1. En Configuración > Ubicaciones, establece la Ruta de la herramienta de firma en la ruta de signtool.exe.
  2. In the Publish window, open the Certificate signing tab and enter the certificate details, as described in Signing a Package.
  3. Selecciona Firmar conjuntos y, a continuación, Publicar.

Los conjuntos del paquete se firman con el certificado, la contraseña y el marcador de tiempo de la pestaña Firma de certificado antes de crear el paquete. Para rellenar previamente la ruta del certificado en la ventana Publicar , establece Certificado de publicación predeterminado en Configuración > Ubicaciones.

Cuando publiques desde la línea de comandos, utiliza la opción --sign-assemblies junto con --cer-path.

Signing assemblies when running and debugging​

To run and debug a project from signed assemblies, set the certificate that Studio uses to sign them. This is available for projects with the Windows and cross-platform compatibility.

  1. En Configuración > Ubicaciones, establece Certificado de DLL dinámicas en la ruta de un certificado .pfx o .p12 .
  2. Ejecuta o depura el proyecto.
  3. En el cuadro de diálogo Contraseña de certificado , introduce la contraseña del certificado.

Studio copies the assemblies compiled for the project to the .local_signed folder, signs them, and runs the project from the signed copies. Only the assemblies that changed since the previous run are signed again. The certificate password is stored in Windows Credential Manager. If you cancel the Certificate Password dialog, the execution does not start. The .local_signed folder is not included in published packages.

Las políticas de Automation Ops y el archivo de gobernanza pueden establecer las tres ubicaciones. Para obtener más información, consulta Control.

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte(opens in new window)

¿Quiere aprender? UiPath Academy(opens in new window)

¿Tiene alguna pregunta? Foro de UiPath(opens in new window)

Manténgase actualizado