Gerando Tokens de Integração no SankhyaOm

Como Iniciar uma Integração com a Sankhya?

Para iniciar uma integração com uma solução do Ecossistema Sankhya, é necessário seguir alguns passos iniciais obrigatórios. O processo tem início na "Área do Desenvolvedor", onde deve ser registrada uma nova solução de integração. Após o registro, é preciso gerar um token de autenticação vinculado à solução criada — esse token será utilizado para autorizar as requisições às APIs da Sankhya.

Atenção!

Vale ressaltar que o acesso à Área do Desenvolvedor é exclusivo para clientes Sankhya e parceiros comerciais Sankhya (Parceiros Estratégicos e Business Partners).

Para qualquer outro caso é necessário solicitar que o cliente gere as chaves (AppKey e Token) para que as soluções (integração e/ou addon) sejam desenvolvidas. Ou seja, caso você seja um desenvolvedor externo e precise criar uma integração ou addon para um cliente Sankhya, solicite que o cliente realize os procedimentos que vem a seguir.

1º passo - Conceder Acesso à Área do Desenvolvedor

Antes de registrar soluções e gerar chaves de integração, é necessário liberar o acesso para os usuários responsáveis. Para isso:

 - Acesse a Área do Desenvolvedor com um usuário que possua permissão de Gestão da Sankhya ID.

 - No menu lateral, clique em Gestão de Acessos

 - Selecione a empresa em que deseja conceder o acesso.

 - Na aba Usuários, edite o usuário que deve receber a permissão.

 - Vá até a aba Permissões e localize a opção Área do Desenvolvedor.

 - Escolha o tipo de permissão adequada para o perfil do usuário:

1. Criar e editar soluções
2. Administrador
3. Editar soluções

 - Salve as alterações para que o usuário já possa acessar a área conforme sua permissão.

2º passo: Gerando Tokens de Integração no SankhyaOm

Após liberar os acessos na Área do Desenvolvedor, é hora de configurar o Gateway de Integração diretamente no Sankhya Om

 - Acesse o Sankhya Om com o login do usuário que tenha permissão para as Configurações Gateway.

 - No campo de pesquisa do sistema, digite Configurações Gateway e abra a tela correspondente

 - Nessa tela, será possível verificar automaticamente o tipo de ambiente

 - Clique no botão “+” (Adicionar) para incluir uma nova aplicação de integração

 - Preencha as informações necessárias (nome da aplicação, parceiro, status, usuário de integração etc.).

 - Salve as configurações para que o token de integração seja gerado e vinculado ao ambiente.

 Atenção

Verifique se o firewall do servidor de aplicação do SankhyaOm permite conexões de saída para os IPs dos servidores Sankhya. Caso contrário, inclua-os manualmente nas regras de exceção para evitar falhas de comunicação.

144.22.228.211 e 144.22.217.141 para o ambiente de Produção e

150.230.86.234 e 144.22.173.39 para o ambiente de Sandbox (testes).

 O que é um token?

Um token (ou “token de acesso”, “access token”) é uma string (cadeia de caracteres) gerada por um servidor de autenticação, que identifica e autoriza quem está fazendo requisições à API. Ele funciona como uma credencial temporária. Em vez de passar usuário/senha toda vez, você “apresenta” esse token para provar que tem permissão de usar a API. Pode ter “escopos” limitados (apenas para alguns endpoints ou operações), ter validade (expiração), poder ser revogado, etc.

Por que gerar um token na integração com a Sankhya?

1. Segurança — sem token, qualquer pessoa poderia fazer requisições aos seus serviços ou manipular dados indevidamente. O token garante que apenas aplicações autorizadas façam chamadas.
2. Controle — o token pode representar permissões específicas (o que a integração pode ou não fazer). Ex: só leitura, só escrita, somente determinados módulos.
3. Rastreabilidade — ao usar tokens, as requisições podem ser atribuídas à solução/integrador responsável, o que ajuda em auditoria e controle de uso.
4. Expiração / revogação — tokens geralmente têm vida útil e podem ser revogados se necessário, o que aumenta a segurança comparado a credenciais permanentes (ex: usuário/senha).
5. Isolamento por “solução” — no ecossistema Sankhya, cada integração ou “solução” terá seu token próprio, o que ajuda a separar acessos entre diferentes integrações.
   

Boas práticas com o uso de tokens

1. Não compartilhe o token: ele é como uma senha de acesso às APIs. Se for exposto, terceiros podem usar indevidamente sua integração.
2. Armazene em local seguro: evite salvar em arquivos públicos, códigos-fonte abertos ou repositórios versionados (como GitHub).
3. Renove periodicamente: tokens podem expirar ou ser revogados. Sempre que possível, trabalhe com tokens de curta validade.
4. Use variáveis de ambiente: em projetos de desenvolvimento, prefira armazenar o token em variáveis de ambiente em vez de deixá-lo exposto no código.
5. Controle de acesso: limite os privilégios do token ao mínimo necessário para a integração funcionar.

Importante:
A geração do Token é um procedimento que deve ser feito pelo cliente Sankhya ou pela equipe técnica responsável do cliente e não pela Cubus Soluções. A Cubus não tem acesso direto ao processo de criação do token nem responsabilidade pela sua geração.
Após o cliente gerar o Token no SankhyaOm, é necessário informar o valor desse Token à Cubus, para que o eCUBUS seja configurado corretamente e possa se autenticar via API com o Sankhya.

• Related Articles

• Causas de Lentidão no Integrador eCUBUS

  Introdução O integrador eCUBUS é responsável por realizar a comunicação entre sistemas CAD (Inventor, SolidWorks, SolidEdge, entre outros) e sistemas ERP, automatizando a geração de estruturas, propriedades, listas de materiais, documentos e outros ...

• Instruções para Acesso e Utilização do Portal do Cliente

  Preparamos esta documentação completa para orientar você sobre como utilizar o nosso Portal do Cliente, um portal exclusivo para que nossos clientes possam encontrar soluções, tirar dúvidas e gerenciar suas solicitações de suporte. 1. Acessando o ...

• Requisitos de Implantação

  Como se trata de uma integração entre CADs e ERPs, a responsabilidade do Integrador eCUBUS é garantir uma comunicação eficiente e contínua entre as duas interfaces. CADs Compatíveis O Integrador eCUBUS é compatível com diversos sistemas CAD ...

• Erro de Licença Inativa ao Executar o Integrador eCUBUS com ERP Centrium

  Ao clicar no botão “Executar” no integrador eCUBUS, o usuário se deparou com a seguinte mensagem de erro: Esse erro indicava que o integrador não estava conseguindo validar a licença junto ao ERP Centrium, impedindo o funcionamento correto da ...

• Alerta de modo de leitura

  Ao executar o eCUBUS, pode ocorrer o seguinte erro ao buscar a estrutura da montagem: "Falha ao ler o documento do CAD em modo protegido!" Esse erro indica que o arquivo está aberto em modo somente leitura/protegido, o que impede que o eCUBUS consiga ...