CLAV: API de dados e autenticação

Abstract

A Administração Pública portuguesa tem desmaterializado processos e tem promovido a adoção de sistemas de gestão documental eletrónica bem como a digitalização de documentos destinados a serem arquivados. Estas medidas pretendem atingir a otimização de processos, a modernização de procedimentos administrativos e a redução de papel. Com o propósito de atingir estes objetivos e simplificar a gestão documental na Administração Pública, a Classificação e Avaliação da Informação Pública (CLAV) nasce como uma das medidas. A CLAV tem como finalidade a classificação e a avaliação da informação pública por forma a auxiliar os sistemas de informação das entidades públicas alertando-as quando determinado documento deve ser arquivado ou eliminado. Para tal esta possui um referencial comum, a Lista Consolidada, com as funções e processos de negócio das entidades públicas associadas a um catálogo de legislação e de organismos. Nos últimos dois anos, a CLAV tem vindo a ser desenvolvida no departamento de informática da Universidade do Minho em estreita colaboração com a equipa de investigação da área na Direção-Geral do Livro, dos Arquivos e das Bibliotecas. À data de início deste trabalho, a CLAV era constituída por dois servidores de bases de dados que tinham como interlocutor o servidor da API de dados da CLAV. Era com este servidor da API de dados que toda a interação com o exterior passava: acesso de aplicações de terceiras partes e acessos da interface cliente desenvolvida para a CLAV. Nesta dissertação, o grande objetivo era fazer evoluir a arquitetura aplicacional dando resposta a uma série de requisitos e tentando simplificar ao máximo o processo da sua manutenção futura. Nesse sentido, especificou-se e implementou-se um serviço para a proteção da API de dados da CLAV, especificou-se a documentação desta API de dados, definiram-se os formatos de exportação e implementaram-se os exportadores desta API por forma a permitir uma maior interoperabilidade dos dados, implementou-se a autenticação com a Chave Móvel Digital recorrendo ao Autenticação.gov, criaram-se os mecanismos necessários à migração de HTTP para HTTPS e, por fim, adicionou-se uma API Gateway na CLAV por forma a simplificar o funcionamento e gestão da plataforma. Todos estes desenvolvimentos estão em produção e podem ser observados acedendo ao sítio Web oficial da CLAV: https://clav.dglab.gov.pt

The portuguese public administration has dematerialized processes and promoted the adoption of electronic document management systems as well as the scanning of documents intended to be archived. This measures aim to optimize and modernize administrative procedures and reduce paper usage. In order to achieve these objectives and simplify the document management in public administration, CLAV was born as one of the measures. CLAV’s main purpose is the classification and evaluation of the public information in order to help the information systems of public entities, alerting them when certain documents must be filed or deleted. To this end, a common reference, called the consolidated list (Lista Consolidada), is used, with the business functions and processes of public entities associated with a catalogue of legislation and entities. In the last two years, CLAV have been develop in computing department of UM in strict collaboration with the area investigation team at Direção-Geral do Livro, dos Arquivos e das Bibliotecas. At start date of this work, CLAV was constituted by two database servers that had as interlocutor the data API server of CLAV. Was with this data API server that all exterior interaction passed: access from third party applications and access from client interface developed for CLAV. In this dissertation, the big goal was make evolve the application architecture giving answer to a series of requirements and trying to simplify to maximum the process of it future maintenance. In this sense, a protection service for data API of CLAV was specified and developed, the data API documentation was specified, the exportation formats were defined and the API exporters were developed in order to allow a bigger data interoperability, the authentication with Chave Móvel Digital using the Autenticação.gov was developed, the necessary mechanisms of HTTP to HTTPS migration were created and, lastly, an API Gateway on CLAV was added in order to simplify the operation and management of the platform. All these developments are in production and can be observed accessing to the official web page of CLAV: https://clav.dglab.gov.pt