Nesta página serão explicadas as duas formas de se fazer a instalação do TOTVS Agro LGPD:
Para realizar a instalação do TOTVS Agro LGPD via Docker é necessário seguir os passos abaixo:
Com as informações acima, o time vai acessar o servidor e adicioná-lo no pipeline de entrega.
A instalação via serviço windows irá utilizar um instalador (entrar em contato com o time Framework TOTVS Agro ([email protected]) para obtê-lo.
Com o instalador, descompactar no local que será feita a instalação, executar o script install.bat e seguir os passos conforme indicações abaixo:
Código do Banco de Dados: Informação que será usado para configurar o banco de dados do LGPD e da ferramenta de Autenticação, serão apresentados 4 opções:
Obs: Caso informe um código que não esteja na listagem acima o instalador irá cancelar a instalação.
String de conexão JDBC: URL de conexão para a aplicação se conectar com o banco de dados, alguns exemplos de string são:
*Para o MySQL é preciso ter a configuração useSSL=false junto a String de Conexão;
É importante destacar que a aplicação LGPD precisa de dois schemas/databases. Um schema/database é para os dados do LGPD e o outro é para as informações de autenticação/autorização. Os dois databases devem ser do mesmo vendor, ou seja, oracle, postgres, mysql… Mas não precisam ser a mesma instalação do banco. Podendo estar em duas máquinas diferentes, por exemplo.
Após informar os dados dos dois schemas/databases, será solicitado o endereço(IP ou DNS) para acessar a aplicação, este endereço deve ser sem a porta e com o protocolo (HTTP). Exemplos:
http://192.168.0.10, http://10.0.0.1 ou https://lgpd.com.br.
Depois é necessário informar a porta onde a aplicação irá responder e por último uma label para identificar o serviço, se ele é produção ou homologação por exemplo.
Após a finalização da instalação, será criado um serviço no Windows (TOTVS LGPD) e já iniciado. Caso tenha sido informada algum dado errado, basta parar o serviço e executar novamente o script install.bat.
Durante a inicialização do serviço, ele faz o download do aplicativo mais recente (lgpd-artifacts.zip) e o executa, para verificar se correu tudo certo com o serviço deve-se verificar o log lgpd-service.wrapper.
Os logs do aplicativo ficarão no arquivo lgpd.log, nele pode-se verificar se ocorreu algum erro durante a execução.
Ao término da inicialização da aplicação, será necessário configurar a aplicação de autenticação e cadastrar novos usuários.
Para logar na aplicação de autenticação é necessário digitar o seguinte endereço: endereço da máquina + porta + /auth, exemplo: http://192.168.0.1:8090/auth
Deve ser aberta esta tela:
Clicar em Administration Console.
Você será redirecionado para a tela de login, onde já possui um usuário padrão cadastrado:
usuário: admin
senha: admin
Depois é necessário clicar em Clients -> lgpd-api
Nesta tela é possível configurar várias opções relacionadas ao protocolo OAuth2, não recomendamos alterar nenhuma opção, poderá causar falha na aplicação. A única opção que deve ser alterada são as URIs de redirecionamento.
Alterar o valor localhost:4200 para o endereço + porta + /lgpd. Exemplo:
http://192.168.0.1:8090/lgpd/signin-auth-callback
http://192.168.0.1:8090/lgpd/signout-auth-callback
*IMPORTANTE: Verificar o endereço e a porta correta informada na instalação.
Após cadastrar os endereços corretos, é necessário salvar no final da página.
O próximo passo é cadastrar novos usuários. Clicar no menu Users.
Para adicionar um usuário é preciso clicar em Add user. Será aberto um formulário onde pode ser preenchido apenas o username que é obrigatório;
Depois de salvar você será redirecionado para a tela de edição de usuário, agora é preciso definir uma senha para o usuário, clique em Credentials, digite uma senha e depois Set Password. Se deixar a opção Temporary habilitada, essa senha será temporária e na primeira vez que o usuário realizar o login, ele será redirecionado para alterar a senha.
E por último é necessário definir os papéis deste usuário. No LGPD definimos 2 papéis, um é o gestor que é responsável pelos cadastros da aplicação e o segundo papel é o operador que tem a responsabilidade de anonimizar os registros.
Para definir papéis é preciso clicar em Role Mappings e depois escolher a opção lgpd-api no campo Client Roles.
Escolha o papel do usuário e clique em Add selected.
Para logar é preciso entrar na aplicação usando o endereço da máquina + porta + /lgpd, exemplo: http://192.168.0.1:8090/lgpd (ou o DNS configurado)
Você será redirecionado para a tela de login, o produto já possui um usuário padrão cadastrado:
usuário: administrador
senha: administrador
Ao entrar com esse usuário, apenas um item de menu estará disponível, que é a seção de Administração. Ao entrar neste menu, você será redirecionado para a aplicação de gerenciamento de usuários, nela é possível alterar senhas, criar e apagar usuários.
Ao logar com um usuário cadastrado, dependendo do seu papel, os menus irão se alternar.
<!-- esconder o menu --> <style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } </style> |