Configurando a Verificação de Assinatura de Pacote

A assinatura do pacote é uma ferramenta usada por pacotes NuGet para verificar sua origem como confiável. Essa verificação é feita usando um certificado que ajuda a confirmar a identidade da entidade que emitiu ou criou o pacote.

Quando você habilita a verificação de certificados, a UiPath valida se os pacotes que estão sendo usados provêm de um autor aprovado ou de um repositório permitido, melhorando a segurança da implantação garantindo que apenas pacotes confiáveis sejam usados.

Modos de validação

Os valores do parâmetro do modo de validação signatureValidationMode determinam quais tipos de pacotes podem ser instalados.

• Se você usar accept, pode instalar pacotes assinados e não assinados.
• Se você usar require, só poderá instalar um pacote se os detalhes da assinatura tiverem que corresponder aos da seção <trustedSigners> do arquivo NuGet.config.

Configuração manual para verificação de assinatura

Antes da versão do Robot 2021.2, durante a instalação, o arquivo NuGet.config seria preenchido automaticamente com certas configurações:

• signatureValidationMode, definido como accept

• A UiPath® está listada como um signatário confiável

In Robot versions 2021.2 and later, you are encouraged to make a conscious choice, so these settings are not automatically populated. To continue using the package signature feature, you need to manually edit the NuGet.config file and add the signatureValidationMode parameter, and list UiPath as a trusted source.

Importante:

• Se você usar o NuGet.org feed, adicione-o para ambos modos de validação accept e require, pois o NuGet anuncia todo o repositório como assinado.
• Se não quiser usar a verificação de assinatura do pacote, remova a tag <trustedSigners> do arquivo NuGet.config.

Habilitando assinaturas de pacote

Você pode configurar a assinatura do pacote durante a instalação da linha de comando ou após a instalação, editando o arquivo NuGet.config:

1. Durante a instalação da linha de comando: adicione o argumento ENFORCE_SIGNED_EXECUTION=1 ao comando de instalação.
2. Após a instalação: no arquivo Nuget.config, adicione o parâmetro signatureValidationMode e defina-o como require.
   Observação:

   • O arquivo NuGet.config é armazenado na pasta %ProgramFiles%\UiPath\Studio.
   • Para que as alterações no arquivo NuGet.config entrem em vigor:

     1. Reiniciar o Serviço de Robôs da UiPath.

     2. Remova todos os pacotes NuGet existentes de %ProgramFiles%\UiPath\Studio\Packages e %userprofile%\.nuget\packages.

     3. Reinicie o Studio e o Assistant.

Adicionando origens confiáveis

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

1. Abra o arquivo NuGet.config.
2. Na seção <trustedSigners>, adicione a tag <author> e forneça os valores de um autor confiável. Por exemplo, a UiPath tem os seguintes valores de autor:

   <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>
   </trustedSigners>

3. Abaixo da seção <trustedSigners>, adicione a tag <repository> e informe os valores de um repositório confiável. Por exemplo, a UiPath tem os seguintes valores de repositório:

   <config>
        <add key="signatureValidationMode" value="require" />
   </config>
   <trustedSigners>
      <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>

4. Para adicionar uma lista de proprietários confiáveis, adicione a tag <owners> e informe os nomes dos autores confiáveis. Isso permite apenas pacotes assinados por vários autores confiáveis.

   <config>
        <add key="signatureValidationMode" value="require" />
   </config>
   <trustedSigners>
       <repository name="UiPath Repository" serviceIndex="https://uipath.repository">
           <certificate fingerprint="1234512345123451234512345123123123123123123123123123112312312E5" hashAlgorithm="SHA256" allowUntrustedRoot="true" />
           <owners>Author1;Author2;Author3</owners> 
       </repository>
   </trustedSigners>