ARNG-720 Bloquear login se o certificado do AGR for diferente do certificado cadastrado

docs.en-us/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md

@@ -0,0 +1,41 @@
+# Amplia Reg command: **fill-registration-agents-certificate-thumbprint**
+
+## Name
+
+`fill-registration-agents-certificate-thumbprint` - Fills the certificate thumbprint for registration agents
+
+## Syntax
+
+```sh
+dotnet Lacuna.AmpliaRegNg.Site.dll [settings] -- fill-registration-agents-certificate-thumbprint
+```
+
+Or, on Docker:
+
+```sh
+docker run -i lacunasoftware/ampliareg:x.y.z [settings] -- fill-registration-agents-certificate-thumbprint
+```
+
+> [!IMPORTANT]
+> Replace `x.y.z` above with the version of Amplia Reg you are running
+
+[!include[About settings](includes/about-settings.md)]
+
+Options:
+
+* `--batchsize <batch-size>`: Number of records to process per iteration. Default: 100
+* `--logfrequency <log-frequency>`: Frequency of progress logging. Default: 100
+
+## Description
+
+The `fill-registration-agents-certificate-thumbprint` command reads the stored certificates from blob storage for registration
+agents that have a certificate stored but no thumbprint recorded, calculates the thumbprint for each certificate, and persists it.
+
+> [!IMPORTANT]
+> This command must be run **once** after upgrading to the version that introduced certificate thumbprint validation.
+> Failing to run it will cause registration agents with previously stored certificates to be unable to sign in
+> until their certificate is re-uploaded.
+
+## See also
+
+* [Amplia Reg command-line tool](index.md)

docs.en-us/articles/amplia-reg/on-premises/tool/index.md

@@ -35,6 +35,7 @@ Available commands:
 * [test-email](test-email.md)
 * [test-cert-renewal-alert](test-certificate-renewal-alert.md)
 * [migrate-data](migrate-data.md)
+* [fill-registration-agents-certificate-thumbprint](fill-registration-agents-certificate-thumbprint.md)
 
 ## See also
 

docs.en-us/articles/amplia-reg/on-premises/update-70.md

@@ -0,0 +1,27 @@
+# Update Amplia Reg from Version 6.x to 7.0
+
+## 1. Before Updating (Brazil Only)
+
+This command populates the `CertificateThumbprint` column in the `RegistrationAgent` table.
+
+## 2. Update Amplia Reg
+
+Update AmpliaRegNg to version `7.0.0`. Earlier versions **must not** be used. Later versions are **not recommended**.
+
+## 3. Migrate Data
+
+Follow the steps described in [fill-registration-agents-certificate-thumbprint](tool/fill-registration-agents-certificate-thumbprint.md).
+
+On Linux:
+
+```sh
+dotnet Lacuna.AmpliaRegNg.Site.dll -- fill-registration-agents-certificate-thumbprint
+```
+
+On Docker:
+
+```sh
+docker run -i lacunasoftware/ampliareg:7.0.0 -- fill-registration-agents-certificate-thumbprint
+```
+
+Make sure to follow the steps described in the referenced article to ensure that no errors occurred during the data migration process.

docs.pt-br/articles/amplia-reg/changelog.md

@@ -16,6 +16,23 @@ Atualiza modelo do banco de dados: nao //
 ### Correções de bugs
 
 // -->
+<a name="7.0.0" />
+## 7.0.0 (2026-06-19)
+
+Atualiza modelo do banco de dados: sim
+
+### Melhorias
+
+ARNG-720 Bloquear login se o certificado do AGR for diferente do certificado cadastrado
+
+> [!IMPORTANT]
+> Após atualizar para esta versão, é obrigatório executar o comando `fill-registration-agents-certificate-thumbprint`. Consulte as instruções de migração para garantir que a coluna `CertificateThumbprint` da tabela `RegistrationAgent` seja preenchida corretamente antes de os usuários realizarem login.
+
+
+### Correções de bugs
+
+...
+
 
 <a name="5.24.0" />
 ## 5.24.0 (2026-04-07)

docs.pt-br/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md

@@ -0,0 +1,40 @@
+# Comando Amplia Reg: `fill-registration-agents-certificate-thumbprint`
+
+## Nome
+
+`fill-registration-agents-certificate-thumbprint` – Preenche a impressão digital (thumbprint) do certificado para os agentes de registro.
+
+## Sintaxe
+
+```sh
+dotnet Lacuna.AmpliaRegNg.Site.dll [configurações] -- fill-registration-agents-certificate-thumbprint
+```
+
+Ou, no Docker:
+
+```sh
+docker run -i lacunasoftware/ampliareg:x.y.z [configurações] -- fill-registration-agents-certificate-thumbprint
+```
+
+> [!IMPORTANT]
+> Substitua `x.y.z` acima pela versão do Amplia Reg que você está utilizando.
+
+Consulte a documentação de configurações para mais detalhes sobre os parâmetros disponíveis.
+
+### Opções
+
+* `--batchsize <tamanho-do-lote>`: Número de registros processados por iteração. Padrão: `100`.
+* `--logfrequency <frequencia-do-log>`: Frequência de registro do progresso em log. Padrão: `100`.
+
+## Descrição
+
+O comando `fill-registration-agents-certificate-thumbprint` lê os certificados armazenados no blob storage para agentes de registro que possuem um certificado armazenado, mas não têm uma impressão digital (thumbprint) registrada. Em seguida, calcula a thumbprint de cada certificado e a persiste no banco de dados.
+
+> [!IMPORTANT]
+> Este comando deve ser executado **uma única vez** após a atualização para a versão que introduziu a validação da impressão digital (thumbprint) do certificado.
+>
+> Caso ele não seja executado, os agentes de registro que já possuíam certificados armazenados anteriormente não conseguirão fazer login até que o certificado seja reenviado (upload) novamente.
+
+## Veja também
+
+* Ferramenta de linha de comando do Amplia Reg.

docs.pt-br/articles/amplia-reg/on-premises/tool/index.md

@@ -35,6 +35,7 @@ Comandos disponíveis:
 * [test-email](test-email.md)
 * [test-cert-renewal-alert](test-certificate-renewal-alert.md)
 * [migrate-data](migrate-data.md)
+* [fill-registration-agents-certificate-thumbprint](fill-registration-agents-certificate-thumbprint.md)
 
 ## Veja também
 

docs.pt-br/articles/amplia-reg/on-premises/update-70.md

@@ -0,0 +1,27 @@
+# Atualizando o Amplia Reg da versão 6.x para 7.0
+
+## 1. Antes de atualizar (somente Brasil)
+
+Este comando preenche a coluna CertificateThumbprint da tabela RegistrationAgent.
+
+## 2. Atualizar o Amplia Reg
+
+Atualize o AmpliaRegNg para a versão `7.0.0`. Versões anteriores **não** devem ser usadas. Versões posteriores **não** são recomendadas.
+
+## 3. Migrar dados
+
+Siga os passos de [fill-registration-agents-certificate-thumbprint](tool/fill-registration-agents-certificate-thumbprint.md).
+
+No Linux:
+
+```sh
+dotnet Lacuna.AmpliaRegNg.Site.dll -- fill-registration-agents-certificate-thumbprint
+```
+
+No Docker:
+
+```sh
+docker run -i lacunasoftware/ampliareg:7.0.0 -- fill-registration-agents-certificate-thumbprint
+```
+
+Certifique-se de seguir as etapas descritas no artigo mencionado para garantir que não ocorreram erros durante a migração de dados.