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.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/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) 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..64debaa3 --- /dev/null +++ b/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 `: 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. 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 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.