Começando

O MD2 Portal do Titular é o componente da solução que o titulares de dados conseguem ter parte de seus direitos atendidos. Detalhes: https://docs.md2net.com/books/portal-do-titular/page/portal-do-titular

Para licenças de hospedagem própria (on-premise), o MD2 Portal do Titular é distribuído em formato de arquivo "Web Application Archive" (war). Para baixar o MD2 Portal do Titular, entre em contato através do site https://www.md2qualitymanager.com.br.

Requisitos: https://docs.md2net.com/books/geral/page/md2-portal-do-titular

Instalação

Envie o arquivo "portal-titular-ws.war" para o diretório do webserver Tomcat.

cp portal-titular-ws.war /var/lib/tomcat/webapps

Reinicie o Tomcat

systemctl restart tomcat.service

Os nomes dos diretórios e serviços podem variar de acordo com a instalação. Verifique se não é o caso se tiver algum erro durante o procedimento.

Configuração

Os passos abaixo devem ser seguidos para funcionamento completo do MD2 Portal do Titular. O funcionamento é esclarecido na página de Arquitetura.

Comunicação MD2 Portal do Titular com MD2 QualityManager

Crie ou edite o arquivo de parâmetros "configPortal.properties"

vim /var/lib/tomcat/conf/configPortal.properties

Referência de parâmetros:

config.portal.enabled=true
config.portal.host=qm.dominio.com
config.portal.port=
config.portal.app=
config.portal.unity=5
config.portal.useSslContext=true
config.portal.ws.prefix=/rest
config.portal.version=v2

Parâmetro	Descrição
config.portal.enabled	Obrigatório. Tipo "boolean". Habilita o MD2 Portal do Titular
config.portal.host	Obrigatório. Tipo "string". Endereço do MD2 QualityManager
config.portal.port	Opcional. Tipo "string". Porta do MD2 QualityManager. Padrão 80.
config.portal.app	Opcional. Tipo "string". Compõe URL path na chamada de comunicação com MD2 QualityManager
config.portal.unity	Obrigatório. Tipo "string". Código do cadastro da unidade no MD2 QualityManager. Padrão 5.
config.portal.useSslContext	Obrigatório. Tipo "boolean". Habilita SSL.
config.portal.ws.prefix	Obrigatório. Compõe URL path na chamada de comunicação com MD2 QualityManager
config.portal.version	Obrigatório. Compõe URL path na chamada de comunicação com MD2 QualityManager

MD2 Portal do Titular com autenticação

O MD2 Portal do Titular tem duas formas de acesso:

1. Não autenticado
2. Autenticado

Cada uma dessas formas alteram as funcionalidades apresentadas ao usuário do MD2 Portal do titular. Detalhes: https://docs.md2net.com/books/portal-do-titular

Não autenticado

A forma "não autenticado" é acessada através da requisição HTTP ao MD2 Portal do Titular sem parâmetro. 

curl -vL 'https://dominio.com/portal-titular-ws'

Autenticado

A forma "autenticado" é acessada através da requisição HTTP ao MD2 Portal do Titular com parâmetro "token". 

curl -vL 'https://dominio.com/portal-titular-ws?token=eyJhbGciOiJIUzI1NiJ9'

O MD2 Portal do Titular valida este "token" através de uma segunda requisição a uma API externa e espera "cpf" como resposta.

curl -vL 'https://dominio.com/sistema-cliente-valida-token' \
-H 'tokenClient: eyJhbGciOiJIUzI1NiJ9'

Resposta da API externa:

{
    "cpf": "86265355031"
}

A configuração da requisição de validação é feita no MD2 QualityManager.

Link: https://docs.md2net.com/books/quality-manager/page/parametros-port-tit-parametros-do-portal-do-titular