Verificação de Assinatura de Pacote

Package Signature is a method through which NuGet Packages prove that they come from trusted sources. A package is signed by using a certificate to validate the identity of a signer. When the deployment is set to check the Package Signature Verification, UiPath^® validates against the information available in the NuGet.config file to find the requested certificate in order to ensure consumed packages are coming from an allowed author or repository.

Para uma visão geral detalhada de como funciona a Verificação de Assinatura de Pacote, certifique-se de ler as especificações nesta seção do guia da Microsoft sobre o arquivo NuGet.config.

Configurando a Verificação de Assinatura de Pacote

Modos de validação

• accept - Permite que pacotes não assinados sejam instalados.
• require - Para que um pacote seja instalado, seus detalhes de assinatura devem corresponder aos da seção trustedSigners do NuGet.config.

Como impor o uso de pacotes assinados

Para impor o uso de pacotes assinados, o parâmetro signatureValidationMode no arquivo Nuget.config deve ser definido como require. O arquivo está localizado em %ProgramFiles%\UiPath\Studio. Você pode fazer isso de uma dessas maneiras:

• Durante a instalação, instalando da linha de comando com a opção ENFORCE_SIGNED_EXECUTION=1.

  For example, the following command installs Studio, a Robot as a Windows service, and enforces the usage of signed packaged in your UiPath^® environment:

  UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService ENFORCE_SIGNED_EXECUTION=1
  

• Após a instalação, editando manualmente o arquivo NuGet.config.

  Se você definir o parâmetro após a instalação, as alterações entrarão em vigor após você:

  1. Reiniciar o Serviço de Robôs da UiPath.
  2. Remover todos os pacotes .NuGet existentes de %ProgramFiles%\UiPath\Studio\Packages e %userprofile%\.nuget\packages.
  3. Reiniciar o Studio/UiPath Assistant.

Como adicionar origens confiáveis

Para baixar, instalar e executar os pacotes assinados com um certificado específico, adicione o certificado necessário como uma origem confiável.

Para isso, modifique o arquivo NuGet.config na pasta de instalação, na seção <trustedSigners>.

Observação:

More information on how to add or remove activities feeds can be found in this document.

Adding UiPath^® as a trusted signer

Abra o arquivo NuGet.config da Pasta de Instalação e adicione os seguintes valores:

<config>
     <add key="signatureValidationMode" value="require" />
</config>
<trustedSigners>
   <author name="UiPath">
      <certificate fingerprint="D179174EBC1E180D656BFB15BE369DEA8A17C178230FAC7771BF5446940C290C" hashAlgorithm="SHA256" allowUntrustedRoot="false"/>
      <certificate fingerprint="ABD1E1BB749DDC96B46A1DBD91B93A2D8B3B5572D1E20A52F6165ED96FC117E0" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
      <certificate fingerprint="A96ADDC7455443CF702A887BC153CF7844038E2E88081D676C57DDD90EC90245" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
   </author>
   <repository name="UiPathRepository" serviceIndex="https://gallery.uipath.com/api/v3/index.json">
      <certificate fingerprint="D179174EBC1E180D656BFB15BE369DEA8A17C178230FAC7771BF5446940C290C" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
      <certificate fingerprint="ABD1E1BB749DDC96B46A1DBD91B93A2D8B3B5572D1E20A52F6165ED96FC117E0" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
      <certificate fingerprint="A96ADDC7455443CF702A887BC153CF7844038E2E88081D676C57DDD90EC90245" hashAlgorithm="SHA256" allowUntrustedRoot="false" />
   </repository>
</trustedSigners>

Como adicionar um autor confiável

Para adicionar um autor confiável, você precisa abrir o arquivo NuGet.config localizado em %ProgramFiles%\UiPath\Studio\NuGet.config. Em seguida, forneça o certificatefingerprint e o hashAlgorithmconforme o exemplo acima. Confira esta página para obter mais informações sobre a assinatura do certificado.

Como adicionar um repositório confiável

A adição de um repositório confiável é feita de forma semelhante à adição de um autor, com a diferença de que o serviceIndex também deve ser adicionado.

Veja abaixo um exemplo de um repositório confiável adicionado ao arquivo NuGet.config:

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

Como adicionar proprietários confiáveis

Um repositório pode ter vários pacotes assinados pelo autor. Neste caso, a tag <owners> pode ser usada para permitir que apenas pacotes assinados por autores confiáveis sejam instalados.

Adicione os autores confiáveis entre as tags <owners>, como no exemplo abaixo:

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

Comportamento da v2021.2

A partir da v2021.2 , as seguintes configurações para a Verificação de Assinatura de Pacote não são mais preenchidas no arquivo Nuget.config na instalação:

• O parâmetro signatureValidationMode não é mais preenchido no arquivoNuget.config na instalação
• UiPath^® is no longer populated in the Nuget.config file at install as both repository and author in the trustedSigners tag.

Impacto:

• If Package Signature Verification is used, all trusted signers, including UiPath^®, must be added manually in the NuGet.config file.
• Se a Verificação de Assinatura de Pacote não for usada, a tag trustedSignersnão deve estar presente no arquivo NuGet.config.
• Se o feed NuGet.orgfor usado, ele precisa ser adicionado para aceitar e exigir modos, pois o NuGet reconhece todo o repositório como assinado.

To resolve the above, you need to add UiPath^® as a trusted signer.