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.

Leia Documentos de Referência do TOTVS Privacidade de Dados.

O produto Datasul 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. 

O arquivo está localizado no diretório do Foundation fnd/interfac/smart-link/dts-smart-link-clientsmartlink-service.zip

• • sh
  • C:/TOTVS/smart-link-client/service/Linux/start.sh
  • C:/TOTVS/

• • smart-link-client

• • /service/Linux/stop.sh
  • C:/TOTVS/smart-link-client/service/Linux/uninstall.sh

Arquivo de configuração application.yml.

Utilizando a pasta de exemplo dos passos anteriores, podemos encontrar o arquivo em: "/client/application.yml"

A porta de acesso da aplicação pode ser alterado na propriedade

# -------------------------------------------------
# SMART LINK CLIENT
# -------------------------------------------------
totvs:
  link:
    auth:
      url: INFORMAR_URL_RAC
      client: INFORMAR-CLIENT
      secret: INFORMAR-SECRET
    client:
      subscriptions:      
        - SGDPDataCommand
        - SGDPMaskCommand
    server:
      host: INFORMAR_HOST
      port: 443
      secure: true
  tenant:
    name: INORMAR-NOME-TENANT
    id: INORMAR-ID-TENANT   
  product:
    name: 'Datasul'
    url: 'INFORMAR_URL_DATASUL'
    username: 'INFORMAR_USUÁRIO'
    password: 'INFORMAR_SENHA'
    companies:
      - 'INFORMAR_CÓDIGO_EMPRESA'

O Smart Link Client Java é uma bibloteca 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:

totvs:
  link:
    server:
      host: INFORMAR_HOST
      port: 443
      secure: true

• INFORMAR_HOST:  Utilizar o host conforme o tipo do seu ambiente:
  • DEV: link.dev.totvs.app
  • STAGING: link.staging.totvs.app
  • PROD: link.totvs.app

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. 

:

O produto Datasul está preparado para processar os tipos SGDPDataCommand e SGDPMaskCommand.

O produto Datasul suporta apenas o single tenant, é necessária a seguinte configuração:

totvs:
  link:
    client:
      subscriptions:
        - SGDPDataCommand
        - SGDPMaskCommand

# -------------------------------------------------
# SERVER
# -------------------------------------------------  
server:
  port: 8777

Por padrão estamos utilizando 10MB para poder trafegar metadado no formato JSON.

• INORMAR-NOME-TENANT: Subistituir pelo nome do seu tenant.
• INFORMAR_URL_RAC:  Utilizar a url conforme o tipo do seu ambiente:
  • DEV: https://INORMAR-NOME-TENANT.rac.dev.totvs.app/totvs.rac/connect/token
  • STAGING: https://INORMAR-NOME-TENANT.rac.staging.totvs.app/totvs.rac/connect/token
  • PROD https://INORMAR-NOME-TENANT.rac.totvs.app/totvs.rac/connect/token
• INFORMAR-DEV-PROD-STAGING:  Subistituir pelo tipo do seu ambient tenant (dev, prod, staging).
• INFORMAR-CLIENT: Subistituir pelo valor do seu client.
• INFORMAR-SECRET:  Subistituir pelo valor da sua secret.

totvs:
  link:
    auth:
      url: INFORMAR_URL_RAC
      client: INFORMAR-CLIENT
      secret: INFORMAR-SECRET

# -------------------------------------------------
# SPRING
# ------------------------------------------------- 
spring:
  codec:
    max-in-memory-size: 10MB

https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html#application-properties.core.spring.codec.max-in-memory-size

O nome do arquivo de log pode ser alterado na propriedade:

# -------------------------------------------------
# LOG
# -------------------------------------------------    
logging:
  file:
    name: log/smart-link-client.log

# -------------------------------------------------
# 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
    application:
      url: 'INFORMAR_URL_DATASUL'
      username: 'INFORMAR_USUÁRIO'
      password: 'INFORMAR_SENHA'
      messages:
        - type: SGDPDataResponse
        - type: SGDPMaskResponse
        - type: SGDPLogsResponse
        - type: SGDPUpdateTenantMetadata        
      audiences:
        - type: SGDP               
      subscriptions:
        - subscription: SGDPDataCommand
          route: api/sec/v1/sgdp/commands
          dataSources:
            - companyId: 'INFORMAR_CÓDIGO_EMPRESA'
              rpw: 'INFORMAR_EMPRESA:INFORMAR_RPW'          
        - subscription: SGDPMaskCommand
          route: api/sec/v1/sgdp/commands
          dataSources:
            - companyId: 'INFORMAR_CÓDIGO_EMPRESA'
              rpw: 'INFORMAR_EMPRESA:INFORMAR_RPW'          
        - subscription: SGDPLogsCommand
          route: api/sec/v1/sgdp/commands
          dataSources:
            - companyId: 'INFORMAR_CÓDIGO_EMPRESA'
              rpw: 'INFORMAR_EMPRESA:INFORMAR_RPW' 

totvs:
  tenant:
    name: INORMAR-NOME-TENANT
    id: INORMAR-ID-TENANT 

totvs:
  product:
    name: 'Datasul'
    url: 'INFORMAR_URL_DATASUL'
    username: 'INFORMAR_USUÁRIO'
    password: 'INFORMAR_SENHA'    
    companies:
      - 'INFORMAR_CÓDIGO_EMPRESA'

totvs:
  link:
  

  server:
      

host: INFORMAR_HOST
      

port: 443
   

   secure: true

totvs:
  

link:
    

auth:

      url: INFORMAR_URL_RAC
      client: INFORMAR-CLIENT
      

secret: 

INFORMAR-SECRET

• INFORMAR_URL_RAC:  Utilizar a url conforme o tipo do seu ambiente:
  
  • DEV: https://admin.rac.dev.totvs.app/totvs.rac/connect/token
  • STAGING: https://admin.rac.staging.totvs.app/totvs.rac/connect/token
  • PROD https://admin.rac.totvs.app/totvs.rac/connect/token
• INFORMAR-CLIENT: Substituir pelo valor do seu client.
• INFORMAR-SECRET:  Substituir pelo valor da sua secret.

totvs:
  

tenant:
    

id: INFORMAR-ID-TENANT 

• INFORMAR-ID-TENANT:  Substituir pelo valor do id do seu tenant.

totvs:
  product:
    url: 'INFORMAR_URL_DATASUL'
    username:

Starting Application

Starting Application

INFO 15788 --- [main] com.totvs.link.client.Application        : Starting Application v12.1.34-NFRW-SNAPSHOT on 00000 with PID 15788 (C:\TOTVS\dts-smart-link-client\client\dts-smart-link-client.jar started by 00000$ in C:\TOTVS\dts-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.ThreadPoolTaskSchedulerApplication        : Starting  : Initializing ExecutorService 'taskScheduler'
INFO 15788 --- [main] o.s.b.web.embedded.netty.NettyWebServer  : Netty started on port(s): 8777Application 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        : Started Application in 4.994 seconds

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