Histórico da Página

...

Nesta seção, serão apresentadas algumas orientações para o processo de configuração do TOTVS API Hub.

Esta atualização traz o suporte a múltiplas conexões de banco de dados no TOTVS Agro API Hub, permitindo integração simultânea com os produtos Bioenergia, Indústria/PI e Indústria/MI. Cada produto pode operar de forma independente, desde que possua ao menos uma base de dados configurada. Mais detalhes sobre configuração e requisitos estão disponíveis na documentação oficial.

Expandir

title	Ativar protocolo HTTPS, utilizando o certificado SSL

Dica

icon	false
title	Configuração de certificado utilizando arquivo PFX

Obtenção do certificado SSL
Adquira um certificado SSL válido, emitido e assinado por uma autoridade certificadora no formato .pfx (PKCS#12).

Localização do arquivo de configuração
Acesse o arquivo ta-api-hub.xml, localizado no diretório de instalação do TOTVS Agro API Hub.

Configuração das propriedades SSL
Antes da instrução -jar do arquivo de configuração, adicione as seguintes propriedades:

-Dserver.ssl.enabled=true → Habilita o protocolo SSL no servidor.

-Dserver.ssl.key-store → Define o caminho absoluto do arquivo .pfx que será utilizado.

-Dserver.ssl.key-store-password → Informa a senha do arquivo .pfx .

-Dserver.ssl.key-store-type=PKCS12 → Especifica o formato do arquivo de keystore utilizado (PKCS12)

A imagem abaixo apresenta um exemplo do processo de configuração.

Image Added

Expandir

title	Conexão com a Base de Dados do Produto

Nota

icon	false

O processo de conexão com a base do produto pode ser realizado por meio dos seguintes modelos:

Utilização do Owner do próprio produto
Conectar-se utilizando o mesmo Owner do produto, acessando diretamente seus objetos na base de dados.

Utilização de um Owner diferente do produto
Nesse cenário, é necessário utilizar o recurso do Oracle Logon Trigger. Esse mecanismo permite que o Owner definido acesse, de forma transparente, os objetos da base de dados do TOTVS Agro Bioenergia.

Bloco de código

language	sql
title	No arquivo pg_hba.conf

CREATE OR REPLACE TRIGGER TRIGGER_NOME_EXEMPLO
  AFTER LOGON ON USUARIO_ORIGEM.SCHEMA
BEGIN
     EXECUTE IMMEDIATE 'ALTER SESSION SET CURRENT_SCHEMA = USUARIO_DESTINO';
END;

Expandir

title	Erro "nenhuma entrada em pg_hba.conf para o hospedeiro" no PostgreSQL

Nota

icon	false

No PostgreSQL, quando a base de dados e o TOTVS Agro API Hub não estão no mesmo servidor, é necessário informar os IPs/DNS que podem acessar os schemas, deve ser realizada a seguinte configuração:

No arquivo pg_hba.conf
- Caminho: /PostgreSQL/{versão_utilizado}/data/pg_hba.conf
- TYPE: Define o tipo de conexão que a linha permite
- DATABASE: Define a quais bancos de dados essa regra se aplica
- USER: Define a quais usuários essa regra se aplica
- ADDRESS: Indica de quais endereços IP a conexão pode ser feita
- METHOD: Define o método de autenticação que será usado

Exemplo:

Bloco de código

language	sql
title	Criação da Trigger de Logon

host    apihub          all          192.168.0.0/24          md5

Essas configurações vão depender muito do seu contexto e ambiente, mais informações, podem ser achados no link de documentação do PostgreSQL.

https://www.postgresql.org/docs/current/auth-pg-hba-conf.html

Expandir

title	Erro ao subir o serviço do TOTVS Agro API Hub após alterar ta-api-hub.xml no Windows Server 2016

Nota

icon	false

No Windows Server 2016, ocorre um erro ao tentar subir o serviço do TOTVS Agro API Hub após realizar alguma alteração no arquivo ta-api-hub.xml.

Este erro é sistêmico no Windows Server 2016, sendo necessário, como alternativa, reinstalar o serviço do TOTVS Agro API Hub.

Para realizar este processo, podemos seguir da seguinte forma:

Executar o arquivo unistall.bat
- Caso ainda fique instalado o serviço, reinicie o Windows Server 2016
Após, execute o arquivo install-service-only.bat
- Se não iniciar o serviço automaticamente, acesse a página de Serviços do Windows Server 2016 e inicie o serviço do TOTVS Agro API Hub manualmente.

Expandir

title	Alterar clientId e clientSecret (Chaves de acessos às APIs)

Nota

icon	false

Para alterar o clientId e clientSecret padrão, primeiro devemos gerar as novas credenciais através do ta-api-hub-encrypt.jar
Image Added

Com as credenciais geradas, devemos acrescentar ou modificar o argumento na tag <arguments> </arguments> no arquivo de configuração ta-api-hub.xml

Bloco de código

language	java

<arguments>
 -Dta-api-hub.credentials.client-id=ENC(VGnuE7ODZpa8Sj2OFC/bQt5NwBAZQntbLBCDF/myCkqmN0r5tduQhF9mdbGd5ez+)
 -Dta-api-hub.credentials.client-secret=ENC(yullLPu69+0RBWHWcNjwLFJPsdmPPXVr6HuFz6G+E5fResQ0gIGIRZZX3L+iWSiT)
</arguments>

Pronto, agora para realizar um teste, basta codificar SEU_CLIENT_ID:SEU_CLIENT_SECRET (no exemplo: teste:teste:123) para Base64
Agora basta chamar http://SEU_IP:SUA_PORTA/oauth2/token enviando no Headers
1. Key: Authorization
2. Value: BasicdGVzdGU6dGVzdGUxMjM=

Expandir

title	[20/10/2025] TOTVS Agro API Hub com múltiplas conexões/produtos (Bioenergia, Indústria/PI e Indústria/MI)

Nota

icon	false

Para alterar o clientId e clientSecret padrão, primeiro devemos gerar as novas credenciais através do ta-api-hub-encrypt.jar
Image Added

Com as credenciais geradas, devemos acrescentar ou modificar o argumento na tag <arguments> </arguments> no arquivo de configuração ta-api-hub.xml

Bloco de código

language	java

<arguments>
 -Dta-api-hub.credentials.client-id=ENC(VGnuE7ODZpa8Sj2OFC/bQt5NwBAZQntbLBCDF/myCkqmN0r5tduQhF9mdbGd5ez+)
 -Dta-api-hub.credentials.client-secret=ENC(yullLPu69+0RBWHWcNjwLFJPsdmPPXVr6HuFz6G+E5fResQ0gIGIRZZX3L+iWSiT)
</arguments>

Pronto, agora para realizar um teste, basta codificar SEU_CLIENT_ID:SEU_CLIENT_SECRET (no exemplo: teste:teste:123) para Base64
Agora basta chamar http://SEU_IP:SUA_PORTA/oauth2/token enviando no Headers
1. Key: Authorization
2. Value: BasicdGVzdGU6dGVzdGUxMjM=

Expandir

title	[20/10/2025] TOTVS Agro API Hub com múltiplas conexões/produtos (Bioenergia, Indústria/PI e Indústria/MI)

Nota

icon	false

Esta atualização adiciona suporte para múltiplas conexões de banco de dados de produtos externos no TOTVS Agro API Hub (mínimo 1, máximo 3), permitindo integração simultânea com Bioenergia, Indústria PI e Indústria MI. A configuração da base de Bioenergia é obrigatória, enquanto Indústria PI e Indústria MI são opcionais. A seguir, será demonstrado como o XML de argumentos deve ser ajustado, mostrando o antes e depois da atualização para garantir compatibilidade.

Como era antes:

Image Removed

Como ficou:

Image Removed

Para ajustar o XML de argumentos:

Localize as propriedades antigas que começam com -Dta-api-hub.product...
Ajuste para o novo padrão: -Dta-api-hub.products.<produto>..., conforme mostrado na imagem de exemplo;
Para cada produto que deseja ativar (bioenergia, industria-pi, industria-mi), repita o bloco de propriedades, substituindo <produto> pelo nome correspondente e preenchendo os dados necessários;
Caso não utilize algum produto, ajuste a propriedade -Dta-api-hub.products.<produto>.enabled=false;
A propriedade default-instance foi movida para o nível do ta-api-hub:
1. Antes: -Dta-api-hub.product.default-instance;
2. Agora: -Dta-api-hub.default-instance e -Dta-api-hub.default-company.
Após configurar e salvar o ta-api-hub.xml, execute o uninstall.bat para remover o serviço antigo. Em seguida, execute o install-service-only.bat para instalar o serviço com a nova configuração.

Páginas filhas

Versões comparadas

Versão antiga 14

Nova versão 15

Chave