Links

Conector Local - Release Note

Conector v0.18.3

Aderente ao XSD V1.04.1 do MEC

17/10/2022

Atenção:

1. É recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. Os volumes dos containers do Conector e do Banco de Integração devem ser sempre persistidos, além da aplicação de estratégias de backup.

Adicionado

  • Camada de validação de assinatura de tag para evitar que documentos sejam assinados em estados proibidos.
  • Interceptadores de requisição para repetir a autenticação do RAP Conector no RAP Server.
  • Log de erros de validação do MEC no campo aditionalInfo da rota de estado de um documento.
  • Suporte à emissão, assinatura e visualização da Lista de Diplomas Anulados.
  • Suporte à emissão, assinatura e visualização do Arquivo de Fiscalização da Registradora.
  • Suporte à emissão, assinatura e visualização do Arquivo de Fiscalização de Emissora.
  • RAPSign Web 0.3.12 com suporte à Lista de Diplomas Anulados, Arquivo de Fiscalização da Registradora e Arquivo de Fiscalização de Emissora.
  • Aba de informações adicionais no visualizador gráfico de documentos.
  • Filtro de data na rota de listagem de documentos.
  • Opção de atualização de dados de revogação na rota de atualização de documentos. Na rota PUT /documents/{docId} é possível atualizar as informações de revogação de um documento no campo revocationData: MotivoAnulacao (“reson”) e AnotacaoAnulacao (“notes”); que serão utilizados para geração da Lista de Diplomas Anulados.

Alterado

  • Limite de caracteres máximo aumentados para 5k no campo InformacoesAdicionais do JSON do diploma.
  • (breaking change) Para atender os motivos de revogação especificados pelo MEC na Lista de Diplomas Anulados, o campo ‘reason’ da rota POST /documents/{docId}/revoke deve receber um dos seguintes valores; [Erro de Fato, Erro de Direito, Decisão Judicial, Reemissão para Complemento de Informação, Reemissão para Inclusão de Habilitação ou Reemissão para Anotaçao de Registro. Também é possível informar na chamada de revogação o campo “notes” (AnotacaoAnulacao) que será utilizado para a geração da Lista de Diplomas Anulados.

Corrigido

  • Visualização de documentação comprobatória que não suportava vários documentos do mesmo tipo.
  • Falha que não atualizava o estado de documentos dentro de um grupo de documentos.
  • Suporte à segunda via nato física do histórico acadêmico integral.

Observações:

Obs1.: Para os Arquivos Auxiliares (Lista de Diplomas Anulados, Arquivo de Fiscalização da Registradora e Arquivo de Fiscalização da Emissora), existem duas formas de listar os diplomas que farão parte dessa lista:
  • Inserindo os dados completos (definidos pelo MEC para cada um dos Arquivos Auxiliares) para os diplomas.
  • Inserindo o docId (e dados complementares, quando necessário) dos diplomas. Nesse caso o docId informado deve ser sempre de documentos do tipo 2 (diploma digital)
Obs2.: Segundo recomendação do MEC, sempre que houver a troca de XSD entre expedição e emissão dos documentos, deve-se alinhar a data de expedição (informada no arquivo XML) para funcionar com a versão do XSD mais atual.
Obs3.: A versão 1.04.1 do normativo criou o elemento Assinantes tanto para a Documentação Acadêmica quanto para o Diploma Digital. O elemento Assinantes é opcional e informa os cargos dos assinantes do nó DadosDiploma (para a Documentação Acadêmica) e do nó DadosRegistro (para o Diploma Digital). Caso esteja presente, deve possuir o CPF e cargo de todas as autoridades assinaram os respectivos nós. Sendo assim, se optarem por preencher esse elemento (que é opcional), cada IES deve gerenciar quem serão os assinantes que irão assinar aquele documento específico já levando em consideração se algum substituto irá substituir um assinante titular.
Obs4.: Os certificados de Pessoa Jurídica que assinam a Documentação Acadêmica, Diploma Digital e o Histórico Escolar devem possuir os mesmos dados informados nos elementos da IES Emissora e da IES Registradora.
Obs5.: A versão 1.04.1 do normativo criou o elemento “ambiente” para a Documentação Acadêmica, Diploma Digital e Histórico Escolar. Para os documentos oficiais emitidos em produção, o elemento deve ser preenchido com o termo “Produção”.
Obs6.: Os documentos anexos à Documentação Acadêmica, mesmo os que sejam assinados digitalmente, devem estar no formato PDF/A.

Versões anteriores

Conector v0.18.1

Aderente ao XSD V1.04.1 do MEC
27/09/2022

Atenção:

1. É recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. Os volumes dos containers do Conector e do Banco de Integração devem ser sempre persistidos, além da aplicação de estratégias de backup.

Adicionado

  • Suporte à emissão, assinatura e visualização da Lista de Diplomas Anulados.
  • Suporte à emissão, assinatura e visualização do Arquivo de Fiscalização da Registradora.
  • Suporte à emissão, assinatura e visualização do Arquivo de Fiscalização de Emissora.
  • RAPSign Web 0.3.12 com suporte à Lista de Diplomas Anulados, Arquivo de Fiscalização da Registradora e Arquivo de Fiscalização de Emissora.
  • Aba de informações adicionais no visualizador gráfico de documentos.
  • Filtro de data na rota de listagem de documentos.
  • Opção de atualização de dados de revogação na rota de atualização de documentos. Na rota PUT /documents/{docId} é possível atualizar as informações de revogação de um documento no campo revocationData: MotivoAnulacao (“reson”) e AnotacaoAnulacao (“notes”); que serão utilizados para geração da Lista de Diplomas Anulados.

Alterado

  • (breaking change) Para atender os motivos de revogação especificados pelo MEC na Lista de Diplomas Anulados, o campo ‘reason’ da rota POST /documents/{docId}/revoke deve receber um dos seguintes valores; [Erro de Fato, Erro de Direito, Decisão Judicial, Reemissão para Complemento de Informação, Reemissão para Inclusão de Habilitação ou Reemissão para Anotaçao de Registro. Também é possível informar na chamada de revogação o campo “notes” (AnotacaoAnulacao) que será utilizado para a geração da Lista de Diplomas Anulados.

Corrigido

  • Falha que não atualizava o estado de documentos dentro de um grupo de documentos.
  • Suporte à segunda via nato física do histórico acadêmico integral.

Observações:

Obs1.: Para os Arquivos Auxiliares (Lista de Diplomas Anulados, Arquivo de Fiscalização da Registradora e Arquivo de Fiscalização da Emissora), existem duas formas de listar os diplomas que farão parte dessa lista:
  • Inserindo os dados completos (definidos pelo MEC para cada um dos Arquivos Auxiliares) para os diplomas.
  • Inserindo o docId (e dados complementares, quando necessário) dos diplomas. Nesse caso o docId informado deve ser sempre de documentos do tipo 2 (diploma digital)
Obs2.: Segundo recomendação do MEC, sempre que houver a troca de XSD entre expedição e emissão dos documentos, deve-se alinhar a data de expedição (informada no arquivo XML) para funcionar com a versão do XSD mais atual.
Obs3.: A versão 1.04.1 do normativo criou o elemento Assinantes tanto para a Documentação Acadêmica quanto para o Diploma Digital. O elemento Assinantes é opcional e informa os cargos dos assinantes do nó DadosDiploma (para a Documentação Acadêmica) e do nó DadosRegistro (para o Diploma Digital). Caso esteja presente, deve possuir o CPF e cargo de todas as autoridades assinaram os respectivos nós. Sendo assim, se optarem por preencher esse elemento (que é opcional), cada IES deve gerenciar quem serão os assinantes que irão assinar aquele documento específico já levando em consideração se algum substituto irá substituir um assinante titular.
Obs4.: Os certificados de Pessoa Jurídica que assinam a Documentação Acadêmica, Diploma Digital e o Histórico Escolar devem possuir os mesmos dados informados nos elementos da IES Emissora e da IES Registradora.
Obs5.: A versão 1.04.1 do normativo criou o elemento “ambiente” para a Documentação Acadêmica, Diploma Digital e Histórico Escolar. Para os documentos oficiais emitidos em produção, o elemento deve ser preenchido com o termo “Produção”.
Obs6.: Os documentos anexos à Documentação Acadêmica, mesmo os que sejam assinados digitalmente, devem estar no formato PDF/A.

Conector v0.17.1

Aderente ao XSD V1.04.1 do MEC
19/08/2022

Atenção:

1. É recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. Os volumes dos containers do Conector e do Banco de Integração devem ser sempre persistidos, além da aplicação de estratégias de backup.

Adicionado

  • Aba de informações adicionais no visualizador gráfico de documentos

Corrigido

  • Falha que não atualizava o estado de documentos dentro de um grupo de documentos.
  • Suporte à segunda via nato física do histórico acadêmico integral.
Observações:
Obs1.: Segundo recomendação do MEC, sempre que houver a troca de XSD entre expedição e emissão dos documentos, deve-se alinhar a data de expedição (informada no arquivo XML) para funcionar com a versão do XSD mais atual.
Obs2.: A versão 1.04.1 do normativo criou o elemento Assinantes tanto para a Documentação Acadêmica quanto para o Diploma Digital. O elemento Assinantes é opcional e informa os cargos dos assinantes do nó DadosDiploma (para a Documentação Acadêmica) e do nó DadosRegistro (para o Diploma Digital). Caso esteja presente, deve possuir o CPF e cargo de todas as autoridades assinaram os respectivos nós. Sendo assim, se optarem por preencher esse elemento (que é opcional), cada IES deve gerenciar quem serão os assinantes que irão assinar aquele documento específico já levando em consideração se algum substituto irá substituir um assinante titular.
Obs3.: Os certificados de Pessoa Jurídica que assinam a Documentação Acadêmica, Diploma Digital e Histórico Escolar devem possuir os mesmos dados informados nos elementos da IES Emissora e da IES Registradora.
Obs4.: A versão 1.04.1 do normativo criou o elemento “ambiente” tanto para a Documentação Acadêmica, Diploma Digital e Histórico Escolar. Para os documentos oficiais emitidos em produção, o elemento deve ser preenchido com o termo “Produção”.
Obs5.: Os documentos anexos à Documentação Acadêmica, mesmo os que sejam assinados digitalmente, devem estar no formato PDF/A.

Conector v0.17.0

Aderente ao XSD V1.04.1 do MEC

10/08/2022

Atenção:

1. É recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. Os volumes dos containers do Conector e do Banco de Integração devem ser sempre persistidos, além da aplicação de estratégias de backup.

Adicionado

  • Documentação da API para histórico acadêmico parcial.
  • Rota de inserção de histórico acadêmico parcial.
  • Utilitários de construção e validação de DDR para o histórico acadêmico parcial.
  • Esquemas JSON e XSD do histórico acadêmico parcial.

Corrigido

  • Visualização do Histórico Escolar Final no RAPSign WEB 0.3.9.
Observações:
Obs1.: Segundo recomendação do MEC, sempre que houver a troca de XSD entre expedição e emissão dos documentos, deve-se alinhar a data de expedição (informada no arquivo XML) para funcionar com a versão do XSD mais atual.
Obs2.: A versão 1.04.1 do normativo criou o elemento Assinantes tanto para a Documentação Acadêmica quanto para o Diploma Digital. O elemento Assinantes é opcional e informa os cargos dos assinantes do nó DadosDiploma (para a Documentação Acadêmica) e do nó DadosRegistro (para o Diploma Digital). Caso esteja presente, deve possuir o CPF e cargo de todas as autoridades assinaram os respectivos nós. Sendo assim, se optarem por preencher esse elemento (que é opcional), cada IES deve gerenciar quem serão os assinantes que irão assinar aquele documento específico já levando em consideração se algum substituto irá substituir um assinante titular.
Obs3.: Os certificados de Pessoa Jurídica que assinam a Documentação Acadêmica, Diploma Digital e Histórico Escolar devem possuir os mesmos dados informados nos elementos da IES Emissora e da IES Registradora.
Obs4.: A versão 1.04.1 do normativo criou o elemento “ambiente” tanto para a Documentação Acadêmica, Diploma Digital e Histórico Escolar. Para os documentos oficiais emitidos em produção, o elemento deve ser preenchido com o termo “Produção”.
Obs5.: Os documentos anexos à Documentação Acadêmica, mesmo os que sejam assinados digitalmente, devem estar no formato PDF/A.

Conector v0.16.0

Aderente ao XSD V1.04.1 do MEC

21/07/2022

Atenção:

1. É recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. Os volumes dos containers do Conector e do Banco de Integração devem ser sempre persistidos, além da aplicação de estratégias de backup.

Adicionado

  • Documentação da API para histórico acadêmico.
  • Rota de inserção de histórico acadêmico.
  • Algoritmo de geração de código de validação do histórico acadêmico com as regras do MEC.
  • Utilitários de construção e validação de DDR para o histórico acadêmico.
  • Esquemas JSON e XSD do histórico acadêmico.
  • Informações detalhadas de erros de validação de documentos do MEC.
  • Verificação de disponibilidade de slot em grupo para histórico acadêmico.

Corrigido

  • Rota de busca de recibo que retornava erro para documentos revogados.
  • Falha que não atualizava o recibo de um documento revogado.
  • Regra de atributos obrigatórios para os elementos "IntercambioNacional" e "IntercambioInternacional".
  • Builder de DDR que não processava o elemento "Habilitacao".
  • Propriedades com definição de tipo errada nos esquemas JSON da versão 1.04.1 do diploma digital.
  • Rota de atualização de documentos que permitia a atualização de metadados. Apenas o campo data do JSON deve ser enviado na rota PUT /documents/{docId}

Modificado

  • Modificação da arquitetura do RAPSign WEB na versão 0.3.8.

Removido

  • Suporte à inserção de documentos na versão 1.03 do diploma digital.
Observações:
Obs.1: Segundo recomendação do MEC, sempre que houver a troca de XSD entre expedição e emissão dos documentos, deve-se alinhar a data de expedição (informada no arquivo XML) para funcionar com a versão do XSD mais atual.
Obs2.: A versão 1.04.1 do normativo criou o elemento Assinantes tanto para a Documentação Acadêmica quanto para o Diploma Digital. O elemento Assinantes é opcional e informa os cargos dos assinantes do nó DadosDiploma (para a Documentação Acadêmica) e do nó DadosRegistro (para o Diploma Digital). Caso esteja presente, deve possuir o CPF e cargo de todas as autoridades assinaram os respectivos nós. Sendo assim, se optarem por preencher esse elemento (que é opcional), cada IES deve gerenciar quem serão os assinantes que irão assinar aquele documento específico já levando em consideração se algum substituto irá substituir um assinante titular.
Obs3.: Os certificados de Pessoa Jurídica que assinam a Documentação Acadêmica e o Diploma Digital devem possuir os mesmo dados informando nos elementos da IES Emissora e da IES Registradora.
Obs4.: A versão 1.04.1 do normativo criou o elemento “ambiente” tanto para a Documentação Acadêmica quanto para o Diploma Digital. Para os documentos oficiais emitidos em produção, o elemento deve ser preenchido com o termo “Produção”.
Obs5.: Os documentos anexos à Documentação Acadêmica, mesmo os que sejam assinados digitalmente, devem estar no formato PDF/A.

Conector v0.15.1

Aderente ao XSD V1.04.1 do MEC

29/06/2022

Atenção:

1. É fortemente recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. A emissão de documentos no ambiente de produção deve ser feita apenas com o Conector v0.15.0 (não usar o Conector v0.15.0-rc1 em Produção).

Adicionado

  • Verificação de disponibilidade de slot em grupo para histórico acadêmico.
  • Novo fluxo de validação de PDF/A para verificar assinaturas.
  • Aumento de verbosidade dos logs no fluxo de assinatura de documentos.
  • Validação da SituacaoAtualDiscente de acordo com as recomendações da norma.
  • Esquemas JSON da versão 1.04.1 do diploma digital.
  • Esquemas XSD da versão 1.04.1 do diploma digital.
  • Verificação de assinantes habilitados para assinar um documento.
  • Filtragem por CPF na rota de listagem dos documentos.
  • Data em que o documento foi assinado pelo assinador na rota de obter o estado atual do documento.
  • Rota para atualização de tokens expirados.
  • Atributos groupId, yourNumber e authorization ao listar documentos.
  • Suporte a visualização em formato JSON na rota de visualização de documentos.
  • Rota para a visualização gráfica de diplomas digitais.

Corrigido

  • Propriedades com definição de tipo errada nos esquemas JSON da versão 1.04.1 do diploma digital.
  • Algoritmo de geração de código de validação.
  • Propriedades que faltavam nos esquemas JSON da versão 1.04.1 do diploma digital.
  • Corrigido o log de erro de conversão de PDF/A para informar corretamente a etapa em que houve falha.
  • Corrigida uma condição de tratamento de erro que mantinha documentos no estado 12.
  • (break change) Rota de atualização de documentos que permitia a atualização de metadados. Apenas o campo data do JSON deve ser enviado na rota PUT /documents/{docId}
  • Falha que não incluía documentos com erro de inicialização na rota de listagem de documentos.

Modificado

  • Modificação da arquitetura do RAPSign WEB na versão 0.3.8.
  • Aprimorado o esquema de log e respostas de erro da API para incluir dados mais precisos.
  • Rota de health check para incluir informações mais precisas de saúde do Conector e seus componentes.

Removido

  • Suporte à inserção de documentos na versão 1.03 do diploma digital.
Observações:
Obs.1: Segundo recomendação do MEC, sempre que houver a troca de XSD entre expedição e emissão dos documentos, deve-se alinhar a data de expedição (informada no arquivo XML) para funcionar com a versão do XSD mais atual.
Obs2.: A versão 1.04.1 do normativo criou o elemento Assinantes tanto para a Documentação Acadêmica quanto para o Diploma Digital. O elemento Assinantes é opcional e informa os cargos dos assinantes do nó DadosDiploma (para a Documentação Acadêmica) e do nó DadosRegistro (para o Diploma Digital). Caso esteja presente, deve possuir o CPF e cargo de todas as autoridades assinaram os respectivos nós. Sendo assim, se optarem por preencher esse elemento (que é opcional), cada IES deve gerenciar quem serão os assinantes que irão assinar aquele documento específico já levando em consideração se algum substituto irá substituir um assinante titular.
Obs3.: Os certificados de Pessoa Jurídica que assinam a Documentação Acadêmica e o Diploma Digital devem possuir os mesmo dados informando nos elementos da IES Emissora e da IES Registradora.
Obs4.: A versão 1.04.1 do normativo criou o elemento “ambiente” tanto para a Documentação Acadêmica quanto para o Diploma Digital. Para os documentos oficiais emitidos em produção, o elemento deve ser preenchido com o termo “Produção”.
Obs5.: Os documentos anexos à Documentação Acadêmica, mesmo os que sejam assinados digitalmente, devem estar no formato PDF/A.

Conector V0.15.0

Aderente ao XSD V 1.04.1 do MEC

23/06/2022

Atenção:

1. É fortemente recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. A emissão de documentos no ambiente de produção deve ser feita apenas com o Conector v0.15.0 (não usar o Conector v0.15.0-rc1 em Produção).

Adicionado

  • Novo fluxo de validação de PDF/A para verificar assinaturas.
  • Aumento de verbosidade dos logs no fluxo de assinatura de documentos.
  • Validação da SituacaoAtualDiscente de acordo com as recomendações da norma.
  • Esquemas JSON da versão 1.04.1 do diploma digital.
  • Esquemas XSD da versão 1.04.1 do diploma digital.
  • Verificação de assinantes habilitados para assinar um documento.
  • Filtragem por CPF na rota de listagem dos documentos.
  • Data em que o documento foi assinado pelo assinador na rota de obter o estado atual do documento.
  • Rota para atualização de tokens expirados.
  • Atributos groupId, yourNumber e authorization ao listar documentos.
  • Suporte a visualização em formato JSON na rota de visualização de documentos.
  • Rota para a visualização gráfica de diplomas digitais.

Modificado

  • Aprimorado o esquema de log e respostas de erro da API para incluir dados mais precisos.
  • Rota de health check para incluir informações mais precisas de saúde do Conector e seus componentes.

Corrigido

  • Algoritmo de geração de código de validação.
  • Propriedades que faltavam nos esquemas JSON da versão 1.04.1 do diploma digital.
  • Corrigido o log de erro de conversão de PDF/A para informar corretamente a etapa em que houve falha.
  • Corrigida uma condição de tratamento de erro que mantinha documentos no estado 12.
  • (break change) Rota de atualização de documentos que permitia a atualização de metadados. Apenas o campo data do JSON deve ser enviado na rota PUT /documents/{docId}
  • Falha que não incluía documentos com erro de inicialização na rota de listagem de documentos.

Removido

  • Suporte à inserção de documentos na versão 1.03 do diploma digital.
Observações:
Obs.1: Segundo recomendação do MEC, sempre que houver a troca de XSD entre expedição e emissão dos documentos, deve-se alinhar a data de expedição (informada no arquivo XML) para funcionar com a versão do XSD mais atual.
Obs2.: A versão 1.04.1 do normativo criou o elemento Assinantes tanto para a Documentação Acadêmica quanto para o Diploma Digital. O elemento Assinantes é opcional e informa os cargos dos assinantes do nó DadosDiploma (para a Documentação Acadêmica) e do nó DadosRegistro (para o Diploma Digital). Caso esteja presente, deve possuir o CPF e cargo de todas as autoridades assinaram os respectivos nós. Sendo assim, se optarem por preencher esse elemento (que é opcional), cada IES deve gerenciar quem serão os assinantes que irão assinar aquele documento específico já levando em consideração se algum substituto irá substituir um assinante titular.
Obs3.: Os certificados de Pessoa Jurídica que assinam a Documentação Acadêmica e o Diploma Digital devem possuir os mesmo dados informando nos elementos da IES Emissora e da IES Registradora.
Obs4.: A versão 1.04.1 do normativo criou o elemento “ambiente” tanto para a Documentação Acadêmica quanto para o Diploma Digital. Para os documentos oficiais emitidos em produção, o elemento deve ser preenchido com o termo “Produção”.
Obs5.: Os documentos anexos à Documentação Acadêmica, mesmo os que sejam assinados digitalmente, devem estar no formato PDF/A.

Conector V0.13.2

Aderente ao XSD V 1.03 do MEC

24/01/2022

Atenção:

1. É fortemente recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. Os limites de tamanho atual do serviço são: 25MB por documento e 50 MB por requisição (para envio de documentos em lote).

Corrigido

  • Falha na atualização de recibos de metadados dos documentos.
  • Falha na atualização de recibos de documentos revogados.

Conector V0.13.0

20/12/2021

Atenção:

1. É fortemente recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. Para a correta utilização do RAP Sign WEB, o Conector e o próprio RAP Sign WEB devem estar configurados para serem acessados via HTTPS.

Adicionado

  • Suporte à versão 1.03 dos XSDs do MEC;
  • Suporte do RAPSign Web ao sistema operacional Linux (distribuição Ubuntu);
  • Suporte do RAPSign Web à certificados digitais em nuvem dos tipos SafeID e NeoID *. Para mais informações, contatar o suporte.
*Requisitos adicionais

Corrigido

  • Tamanho máximo da requisição de conversão e validação de PDF/A aumentado para 50MB;
  • Concorrência no processo de construção de documentos assinados simultaneamente;
  • Utilitário de construção de DDR que podia não adicionar os dados corretos do endereço do Polo;
  • Logging de inicialização de assinatura que apresentava apenas uma mensagem genérica.

Removido

  • Suporte à versão 1.02 dos XSDs do MEC.

Observações:

  • Comandos para realizar backup do banco de dados da integração:
sudo docker exec -it <containerId> bash
#pg_dump -U rapproduser -W rapproddb > db.dump
sudo docker cp <containerId>:/db.dump ./
  • É possível utilizar a ferramenta ngrok para se criar uma conexão HTTPS provisória para realizar os testes iniciais com o RAP Sign WEB. O ngrok pode ser instalado com o seguinte comando:
sudo snap install ngrok
  • E para criar a conexão é possível utilizar o comando:
ngrok http <porta>

Conector v0.12.0

17/11/2021

Atenção:

1. É fortemente recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. Para a correta utilização do RAP Sign WEB, o Conector e o próprio RAP Sign WEB devem estar configurados para serem acessados via HTTPS.

Modificado

  • Aumentada a quantidade de tentativas de conversão e validação de PDF/A antes de entrar em estado de erro.

Corrigido

  • Falha na rota de reiniciar registro de documentos em estado e erro local e preservados no RAP Server.
  • Falha no carregamento da propriedade visual Código EMEC para cursos que possuem apenas o número do processo.
  • Erro no utilitário de construção de DDR que, eventualmente, não incluía o atributo DataConclusao no XML gerado.

Observações:

  • Comandos para realizar backup do banco de dados da integração:
sudo docker exec -it <containerId> bash
#pg_dump -U rapproduser -W rapproddb > db.dump
sudo docker cp <containerId>:/db.dump ./
  • É possível utilizar a ferramenta ngrok para se criar uma conexão HTTPS provisória para realizar os testes iniciais com o RAP Sign WEB. O ngrok pode ser instalado com o seguinte comando:
sudo snap install ngrok
  • E para criar a conexão é possível utilizar o comando:
ngrok http <porta>

Conector v0.11.3

25/10/2021

Atenção:

1. É fortemente recomendado que seja feito um backup do banco de dados do Conector ANTES da realização da atualização.

2. Para a correta utilização do RAP Sign WEB, o Conector e o próprio RAP Sign WEB devem estar configurados para serem acessados via HTTPS.

Adicionado

  • Disponibilização do RAP Sign WEB para Firefox (ao acessar o RAPSign WEB no navegador Firefox o usuário será redirecionado, no primeiro uso, para a instalação da extensão).
  • Atualização do RAP Sign Desktop Linux (v 1.0.5).
  • Detecção de arquivos PDF assinados durante a conversão automática para PDF/A.
  • Atributo signerId (CPF) na lista de assinaturas do documento na rota de busca de estado de documentos.

Modificado

  • Arquivos de deploy do Docker para ajuste de segurança e permissões de escrita nos volumes.

Corrigido

  • Padrão do dado “Número” para Atos Regulatórios (Autorização, Credenciamento, Reconhecimento, etc).
  • Falha no filtro de busca de documentos por propriedades visuais na rota de coleta de assinaturas.
  • Erro de assinatura para documentos grandes.
  • Erro ao exportar certificados pelo RAP Sign WEB.
  • Erro de assinar com assinante substituto.

Observações:

  • Comandos para realizar backup do banco de dados da integração:
sudo docker exec -it <containerId> bash
#pg_dump -U rapproduser -W rapproddb > db.dump
sudo docker cp <containerId>:/db.dump ./
  • É possível utilizar a ferramenta ngrok para se criar uma conexão HTTPS provisória para realizar os testes iniciais com o RAP Sign WEB. O ngrok pode ser instalado com o seguinte comando:
sudo snap install ngrok
  • E para criar a conexão é possível utilizar o comando:
ngrok http <porta>

Conector v0.11.0

20/08/2021

  • A primeira vez que o Conector v0.11.0 for executado será realizado a migração dos arquivos do banco de dados de integração para um sistema de arquivos. O local default desse sistema de arquivo é indicado pela variável RAP_DATA_STORAGE_DIR do arquivo docker-compose.
  • Para seguir o normativo do MEC, após a atualização para a versão 0.11.0 do Conector, não serão mais aceitos documentos baseado na versão 1.01 dos XSDs.
Adicionado
  • Disponibilização do RAP Sign WEB para Google Chrome e Windows.
  • Novo utilitário de construção e validação de DDR para a versão 1.02 do diploma digital.
  • Esquemas JSON e XSD da versão 1.02 do diploma digital.
  • Melhorada a rota de reinicialização de registro de documentos para cancelar automaticamente registros em andamento no servidor de preservação do RAP.
  • Alterado o esquema de armazenamento de arquivos de documentos processados para usar a persistência em volumes Docker.
  • Cancelamento de registro de documentos na rota de reiniciar registro.
Modificado
  • Ajustadas as propriedades visuais de documentos para exibir Nome, Matrícula, Curso e Código EMEC no RAPSign.
  • Melhorada a mensagem de inicialização da API com informações sobre a versão, modo de execução e a porta do servidor.
Corrigido
  • Ajustada a validação do yourNumber na rota de recuperação de documentos registrados para permitir caracteres especiais.
  • Erro que mantinha documentos no estado de inicialização de registro indefinidamente.
Removido
  • Utilitário de construção e validação de DDR para a versão 1.01 do diploma digital.

Conector v0.9.0

17/05/2021

Adicionado

  • Geração de código de validação com dados opcionais na versão 1.01 do diploma digital;
  • Verificação de uso de yourNumber na inserção de documentos;
  • Filtro para listar documentos por tipo;
  • Novo utilitário de construção e validação de DDR para a versão 1.01 do diploma digital;
  • Esquemas JSON e XSD da versão 1.01 do diploma digital;
  • Validação de JSON Web Tokens usando o RAP Server;
  • Melhorias no log de erros dos serviços;
  • Atributos documentType e securityCode ao listar documentos
  • Atributos documentType, groupId e yourNumber ao buscar um documento;
  • Metadados para o registro de documentos na versão 1.01 do diploma digital do RAP;
  • Propriedades visíveis para a assinatura de documentos na versão 1.01 do diploma digital.

Modificado

  • Nomenclatura dos metadados de inserção de documento para o formato camelCase (clientId, yourNumber, docType, dltId, mimeType, clientSignature, isDocSigned);
  • Regex da referência do diploma no JSON de inserção da representação visual (ReferenciaDiploma pode ser preenchido com valor securityCode da rota GET /documents/{docId}/);
  • Porta 80 como padrão do Conector (podendo ser alterado no docker-compose).

Corrigido

  • Campos que poderiam conter valores null nas respostas das requisições;
  • Tipo do metadado isDocSigned para ser uma string "true" ou "false";
  • Erro na codificação de PDFs na rota de recuperação de documentos preservados;
  • Filtro de estado não aplicado corretamente em documentos em estados de erro após a geração;
  • Atributo securityCode que permanecia omitido ao invés de uma string vazia ao buscar documentos não processados;
  • Transações nas operações de atualizar e remover informações para garantir a consistência de dados.

Removido

  • Dados inutilizados enviados para o registro de documentos no servidor do RAP;
  • Suporte à inserção de documentos na versão 1.00 do diploma digital;
  • Esquemas JSON com suporte a XML na versão 1.01 do diploma digital;
  • Dependências inutilizadas.

Conector v0.8.1

0.8.1 - 22-03-2021

Adicionado

● Melhorias da documentação da API no Swagger. ● Estado de assinaturas do documento na rota de busca de estado de documentos. ● Opção de remoção em cascata de documentos. ● Validador de sequência de remoção de documentos. ● Validador de sequência de inserção de documentos. ● Rotas de inserção, listagem e remoção de grupos de documentos. ● Atualização automática de recibo de documentos. ● Conversão e validação de PDF/A para anexos de Documentação Acadêmica e arquivos de Representação Visual. ● Arquivos de Documentação Comprobatória e AtoDesignacao, caso anexados na Documentação Acadêmica, devem ser no formatos PDF/A.

Modificado

● Regra de inserção de Representação Visual ajustada para impedir arquivos duplicados. ● Porta padrão da API alterada para 80. ● Networking do docker ajustado para usar o driver padrão. ● Procedures de retry reimplementadas em JavaScript.

Corrigido

● Inconsistência em atributos no esquema JSON da Documentação Acadêmica (TermoResponsabilidade e DocumentacaoComprobatoria são opcionais). ● Rota de autenticação de documentos que retornava vazio para documentos inválidos. ● Falha na reinserção de um documento após deletá-lo. ● Recibo do documento que permanecia null ao invés de um objeto vazio para documentos não registrados.

Removido

● Rota de remoção de documentos por intervalo de tempo. ● Suporte à upload de arquivos XML para a inserção de Documentação acadêmica e Diploma.