From d180e6b62795fe0606dca9858d40af0f4115b92e Mon Sep 17 00:00:00 2001 From: tmarcorfl Date: Mon, 15 Jun 2026 16:05:57 -0300 Subject: [PATCH 1/5] ARNG-720: Add fill-registration-agents-certificate-thumbprint.md documentation --- ...istration-agents-certificate-thumbprint.md | 41 +++++++++++++++++++ .../amplia-reg/on-premises/tool/index.md | 1 + ...istration-agents-certificate-thumbprint.md | 4 ++ 3 files changed, 46 insertions(+) create mode 100644 docs.en-us/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md create mode 100644 docs.pt-br/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md diff --git a/docs.en-us/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md b/docs.en-us/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md new file mode 100644 index 00000000..3e241763 --- /dev/null +++ b/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 `: Number of records to process per iteration. Default: 100 +* `--logfrequency `: 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) diff --git a/docs.en-us/articles/amplia-reg/on-premises/tool/index.md b/docs.en-us/articles/amplia-reg/on-premises/tool/index.md index b695c0c1..00f7365f 100644 --- a/docs.en-us/articles/amplia-reg/on-premises/tool/index.md +++ b/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 diff --git a/docs.pt-br/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md b/docs.pt-br/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md new file mode 100644 index 00000000..e58dc459 --- /dev/null +++ b/docs.pt-br/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md @@ -0,0 +1,4 @@ +# Comando do Amplia Reg: **fill-registration-agents-certificate-thumbprint** + + +
From fdacacbe49d5c44f0881ca4a85f96221000b6f98 Mon Sep 17 00:00:00 2001 From: tmarcorfl Date: Tue, 16 Jun 2026 11:28:52 -0300 Subject: [PATCH 2/5] ARNG-720: Add fill-registration-agents-certificate-thumbprint.md in portuguese --- ...istration-agents-certificate-thumbprint.md | 42 +++++++++++++++++-- 1 file changed, 39 insertions(+), 3 deletions(-) diff --git a/docs.pt-br/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md b/docs.pt-br/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md index e58dc459..64debaa3 100644 --- a/docs.pt-br/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md +++ b/docs.pt-br/articles/amplia-reg/on-premises/tool/fill-registration-agents-certificate-thumbprint.md @@ -1,4 +1,40 @@ -# Comando do Amplia Reg: **fill-registration-agents-certificate-thumbprint** +# 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 `: Número de registros processados por iteração. Padrão: `100`. +* `--logfrequency `: 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. From ba87ed089ea138b06ab3c539a72f3fe8a2b56cbb Mon Sep 17 00:00:00 2001 From: tmarcorfl Date: Wed, 17 Jun 2026 17:59:50 -0300 Subject: [PATCH 3/5] ARNG-720: Add article to show how to update to AmpliaRegNg version 7.0.0 --- .../amplia-reg/on-premises/update-70.md | 27 +++++++++++++++++++ .../amplia-reg/on-premises/update-70.md | 27 +++++++++++++++++++ 2 files changed, 54 insertions(+) create mode 100644 docs.en-us/articles/amplia-reg/on-premises/update-70.md create mode 100644 docs.pt-br/articles/amplia-reg/on-premises/update-70.md diff --git a/docs.en-us/articles/amplia-reg/on-premises/update-70.md b/docs.en-us/articles/amplia-reg/on-premises/update-70.md new file mode 100644 index 00000000..02eb7395 --- /dev/null +++ b/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. diff --git a/docs.pt-br/articles/amplia-reg/on-premises/update-70.md b/docs.pt-br/articles/amplia-reg/on-premises/update-70.md new file mode 100644 index 00000000..81754422 --- /dev/null +++ b/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. From b8678f27d2c052287df69073b9bd3fe2e3b56a39 Mon Sep 17 00:00:00 2001 From: tmarcorfl Date: Wed, 17 Jun 2026 18:09:19 -0300 Subject: [PATCH 4/5] ARNG-720: Add session showing the improvements of AmpliaRegNg version 7.0.0 --- docs.pt-br/articles/amplia-reg/changelog.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs.pt-br/articles/amplia-reg/changelog.md b/docs.pt-br/articles/amplia-reg/changelog.md index bbf171f6..b2eebc99 100644 --- a/docs.pt-br/articles/amplia-reg/changelog.md +++ b/docs.pt-br/articles/amplia-reg/changelog.md @@ -16,6 +16,23 @@ Atualiza modelo do banco de dados: nao // ### Correções de bugs // --> + +## 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 + +... + ## 5.24.0 (2026-04-07) From 0d1514829f60a481da2ce73cd9042851c448107d Mon Sep 17 00:00:00 2001 From: tmarcorfl Date: Wed, 17 Jun 2026 18:11:29 -0300 Subject: [PATCH 5/5] ARNG-720: Add fill-registration-agents-certificate-thumbprint.md in index.md --- docs.pt-br/articles/amplia-reg/on-premises/tool/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs.pt-br/articles/amplia-reg/on-premises/tool/index.md b/docs.pt-br/articles/amplia-reg/on-premises/tool/index.md index 86412609..a8891316 100644 --- a/docs.pt-br/articles/amplia-reg/on-premises/tool/index.md +++ b/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