---
title: "Atualizando o Rest PKI Core da versão 2.x para 3.0"
description: "Passos adicionais para atualizar o Rest PKI Core de 2.x para 3.0, que passou a usar o ASP.NET Core 8.0: instale o novo runtime antes de atualizar uma instância on-premises."
canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/update-30"
locale: "pt-BR"
product: "Rest PKI Core"
last_updated: "2026-10-12"
---

# Atualizando o Rest PKI Core da versão 2.x para 3.0

Como o ASP.NET Core 6.0 foi descontinuado, a versão [3.0](https://docs.lacunasoftware.com/articles/rest-pki/core/changelog#v3-0-0) do [Rest PKI Core](https://docs.lacunasoftware.com/articles/rest-pki/core) foi migrada para o ASP.NET Core 8.0, que é
a versão LTS mais recente do ASP.NET Core, [com suporte da Microsoft até novembro de 2026](https://dotnet.microsoft.com/platform/support/policy/dotnet-core#lifecycle).

Por isso, antes de atualizar a sua instância [on-premises](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises), você precisa seguir alguns passos adicionais.

## 1. Instale o ASP.NET Core Runtime 8.0

Consulte a seção *Instale o ASP.NET Core Runtime 8.0* do procedimento de instalação correspondente à sua plataforma:

* Linux
  * [Ubuntu Server](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/linux/install-ubuntu#install-aspnet-core)
  * [Rocky Linux](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/linux/install-rocky#instale-o-aspnet-core-runtime-100)

> **Dica**
>
> Não é necessário desinstalar as versões anteriores do ASP.NET Core Runtime: várias versões podem coexistir no mesmo sistema sem problemas

> **Observação**
>
> No Docker, este passo não é necessário, pois a nova imagem 3.x já vem com o ASP.NET Core Runtime 8.0 embutido

## 2. Defina um AppDiscriminator explícito

Verifique se o seu arquivo de configuração contém uma configuração chamada `AppDiscriminator` na seção `General` (ou `General__AppDiscriminator`, se você usa variáveis de ambiente).
Se essa configuração existir e estiver preenchida, pule para o próximo passo. Se ela não existir (ou estiver com valor vazio), siga as instruções abaixo.

Abra o log da aplicação e procure a seguinte entrada:

```text
Application starting: Lacuna Rest PKI Core (version: *, spaVersion: *, appDiscriminator: 'YOUR_APP_DISCRIMINATOR')
                                                                                          ^^^^^^^^^^^^^^^^^^^^^^
```

Copie o valor do campo *appDiscriminator* **sem as aspas simples ao redor** (no exemplo acima, o valor correto seria `YOUR_APP_DISCRIMINATOR`,
e não `'YOUR_APP_DISCRIMINATOR'`) e adicione a configuração `AppDiscriminator`, com esse valor, na seção `General` do seu arquivo de configuração.

Exemplo (arquivo *.ini* ou *.conf*):

```ini
[General]
AppDiscriminator=YOUR_APP_DISCRIMINATOR
```

Exemplo (variáveis de ambiente):

```sh
General__AppDiscriminator=YOUR_APP_DISCRIMINATOR
```

Em seguida, reinicie a aplicação e verifique os logs novamente. Deve ser registrado um novo log "application starting", sem alteração no campo *appDiscriminator*.

## 3. Atualize o Rest PKI Core

Depois de seguir os passos acima, prossiga com as instruções de atualização.

## Solução de problemas com erros de certificado no SQL Server

Diferentemente do .NET 6, no .NET 8 o padrão é validar o certificado do SQL Server. Isso pode fazer com que a sua instância falhe
ao iniciar, com o seguinte erro nos logs:

> Microsoft.Data.SqlClient.SqlException: 'A connection was successfully established with the server, but then an error occurred during the login process. (provider: SSL Provider, error: 0 - The certificate chain was issued by an authority that is not trusted.)'

Nesse caso, certifique-se de que o seu SQL Server está configurado com um certificado TLS confiável e que ele não expirou.

Se preferir ignorar a validação do certificado do SQL Server, acrescente `;TrustServerCertificate=True` à connection string do banco de dados no arquivo de configuração.

## Azure App Services

Se a sua instância do Rest PKI Core estiver hospedada no Azure App Services:

1. No portal do Azure, acesse a configuração do seu App Service
1. Clique em **Configuration** e selecione a aba **General settings**
1. Na seção *Stack settings*:
   1. A configuração *Stack* deve estar definida como **.NET**
   1. A configuração *.NET version* deve estar definida como **.NET 8 (LTS)**

> **Dica**
>
> A seção *Stack settings* mencionada acima só aparece se o App Service Plan for baseado em Windows. Nos planos baseados em Linux, nenhuma alteração é necessária.