Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Conteúdo
Índice minLevel 2
01. Objetivo
Esta documentação tem a finalidade de servir como uma guia no momento da integração com o TOTVS Privacidade de Dados. Para mais informações sobre a ferramenta, acesse TOTVS Privacidade de Dados.
Para tanto, abaixo seguem as instruções para que a integração seja realizada corretamente.
02. Informações
Leia Documentos de Referência do TOTVS Privacidade de Dados.
O produto Logix faz o uso do Smart Link, que é um mecanismo de troca de mensagens entre aplicações TOTVSApps e aplicações On Premises (ou remotas).
- Foi utilizada a biblioteca Smart Link Client Java, que por meio deste foi implementado o processador de mensagens.
- O processador de mensagens é uma aplicação java
Obtenha informações (client, secret, name e id)
do seu tenant para poder realizar as configurações necessárias nos próximos passos.
03. Instalação
Copiar arquivo compactado
O arquivo está localizado no diretório tools/smart-link-client.zip
Extrair os arquivos do arquivo compactado
Expandir | ||
---|---|---|
| ||
Extrair os arquivos em um diretório de sua escolha, sugerimos o uso do nome do seu tenant para complementar e facilitar a organização dos artefatos. Exemplo:
|
Instalador de serviço para Windows
Expandir | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||
Editar o arquivo
Instalação do serviço:
|
Desinstalador de serviço para Windows
Expandir | ||
---|---|---|
| ||
Editar o arquivo
Desinstalação do serviço:
|
Instalador de serviço para Linux
Expandir | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Para a instalação do serviço no Linux certifique-se de que os passos a seguir foram realizados:
Instalando o serviço:
|
Desinstalador de serviço para Linux
Expandir | ||
---|---|---|
| ||
|
04. Configuração
Arquivo de configuração
Arquivo de configuração application.yml
.
Utilizando a pasta de exemplo dos passos anteriores, podemos encontrar o arquivo em: "/client/application.yml"
Configurações do arquivo application.yml
Aviso |
---|
Leia com atenção o detalhamento das configurações abaixo: |
# SERVER
A porta de acesso da aplicação pode ser alterado na propriedade:
Bloco de código | ||||
---|---|---|---|---|
| ||||
# ------------------------------------------------- # SERVER # ------------------------------------------------- server: port: 8777 |
# SPRING
Por padrão estamos utilizando 10MB para poder trafegar metadado no formato JSON.
Bloco de código | ||||
---|---|---|---|---|
| ||||
# ------------------------------------------------- # SPRING # ------------------------------------------------- spring: codec: max-in-memory-size: 10MB |
# LOG
O nome do arquivo de log pode ser alterado na propriedade:
Bloco de código | ||||
---|---|---|---|---|
| ||||
# ------------------------------------------------- # LOG # ------------------------------------------------- logging: file: name: log/smart-link-client.log |
# SMART LINK CLIENT
Bloco de código | ||||
---|---|---|---|---|
| ||||
# ------------------------------------------------- # SMART LINK CLIENT # ------------------------------------------------- totvs: link: auth: url: INFORMAR_URL_RAC client: INFORMAR-CLIENT secret: INFORMAR-SECRET client: subscriptions: - SGDPDataCommand - SGDPMaskCommand - SGDPLogsCommand server: host: INFORMAR_HOST port: 443 secure: true tenant: name: INFORMAR-NOME-TENANT id: INFORMAR-ID-TENANT product: name: 'Logix' url: 'INFORMAR_URL_LogixLOGIX' username: 'INFORMAR_USUÁRIO' password: 'INFORMAR_SENHA' |
Aviso |
---|
Leia com atenção o detalhamento das configurações abaixo: |
Expandir | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
O Smart Link Client Java é uma biblioteca que facilita o desenvolvimento de um LINK Client para a plataforma Java, sendo necessária a implementação de uma aplicação que implemente um processador de mensagens (LINK Client Java Application mais abaixo). No Smart Link Client Java utiliza o protocolo GRPC, sendo necessária a seguinte configuração:
Deve ser informada também uma lista de subscrições, onde somente mensagens com determinados "types" são efetivamente enviadas para o Smart Link Client. No Smart Link Client Java é necessária a seguinte configuração:
O produto está preparado para processar os tipos SGDPDataCommand, SGDPMaskCommand e SGDPLogsCommand. |
Expandir | |||||||
---|---|---|---|---|---|---|---|
| |||||||
O produto suporta apenas o single tenant, sendo necessária a seguinte configuração:
|
Expandir | |||||||
---|---|---|---|---|---|---|---|
| |||||||
Informar os valores do seu Tenant:
|
Expandir | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||
A comunicação acontece nos dois sentidos (TOTVS Privacidade de Dados > Logix) e (Logix > TOTVS Privacidade de Dados) por meio das configurações abaixo:
|
05. Iniciar o serviço instalado
Após concluir as etapas anteriores, basta iniciar o serviço instalado e verificar no log se a aplicação foi iniciada com sucesso.
Starting Application
Bloco de código | ||
---|---|---|
| ||
INFO 15788 --- [main] com.totvs.link.client.Application : Starting Application v12.1.34-NFRW-SNAPSHOT on 00000 with PID 15788 (C:\TOTVS\smart-link-client\client\smart-link-client.jar started by 00000$ in C:\TOTVS\smart-link-client\client) INFO 15788 --- [main] com.totvs.link.client.Application : No active profile set, falling back to default profiles: default INFO 15788 --- [main] com.totvs.link.client.LinkService : *** Connecting to server (link.staging.totvs.app:443) INFO 15788 --- [main] o.s.s.c.ThreadPoolTaskScheduler : Initializing ExecutorService 'taskScheduler' INFO 15788 --- [main] o.s.b.web.embedded.netty.NettyWebServer : Netty started on port(s): 8777 INFO 15788 --- [main] com.totvs.link.client.Application : Started Application in 4.994 seconds |
Após o Started Application é executado o processo:
Expandir | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
Para facilitar a visualização de log foi adicionada a infomação [SMART-LINK-CLIENT] no LOG para as classes java implementadas.
Bloco de código | ||
---|---|---|
| ||
INFO 3528 --- [main] c.totvs.link.client.ApplicationStartup : [SMART-LINK-CLIENT][ApplicationStartup.readyEvent] INFO 3528 --- [main] c.t.l.c.d.ProductSyncDefaultMetadata : [SMART-LINK-CLIENT][ProductSyncDefaultMetadata.sync] INFO 3528 --- [main] c.t.l.client.product.ProductSendMessage : [SMART-LINK-CLIENT][ProductSendMessage.send][REQUEST][GET] to http://----:8380/api/sec/v1/sgdp/metadata/default INFO 3528 --- [main] c.t.l.client.product.ProductSendMessage : [SMART-LINK-CLIENT][ProductSendMessage.send][RESPONSE][GET][200] from http://----:8380/api/sec/v1/sgdp/metadata/default INFO 3528 --- [main] c.t.l.c.d.ProductSyncDefaultMetadata : [SMART-LINK-CLIENT][ProductSyncDefaultMetadata.sync] Sending message to Smart Link Server - type: SGDPUpdateApplicationMetadata - metadado: {"header":{"type":"SGDPUpdateApplicationMetadata"},"content":{"models":{},"codes":{},"package":"Logix","productId":"Logix","readOnly":true,"smartLink":"singleTenant","localLogs":false,"applicationId":"Logix"}} INFO 3528 --- [main] c.t.l.c.d.ProductSyncDefaultMetadata : [SMART-LINK-CLIENT][ProductSyncDefaultMetadata.sync] Sent to Smart Link Server |