A autenticação é o ponto de partida para qualquer integração com os produtos da BigDataCorp - e a segurança é parte fundamental deste processo.

Nesta seção, você encontrará tudo o que precisa para acessar as APIs com segurança, gerenciar seus tokens de autenticação e aplicar boas práticas de proteção e rotacionamento.

Aqui você vai aprender a:

Gerar e renovar seus tokens JWT, diretamente pelo BDC Center ou pela API de Tokens;
Configurar corretamente os headers de autenticação nas suas requisições;
Implementar políticas de segurança e rastreabilidade em ambientes de teste e produção;
Adotar práticas recomendadas para armazenamento e uso de credenciais.

Nosso objetivo é garantir que suas integrações sejam seguras, escaláveis e rastreáveis, preservando a integridade dos dados e a confiabilidade das suas aplicações.

💡
As APIs da BigDataCorp utilizam tokens JWT para autenticação. Com eles, você garante segurança, controle de acesso e flexibilidade nas suas integrações.

🔐Autenticação

Se você ainda não é cliente da BigDataCorp, entre em contato com o nosso time comercial pelo e-mail comercial@bigdatacorp.com.br. Eles irão te auxiliar no cadastro e na obtenção das credenciais de acesso.

Se você já é cliente, acesse o BDC Center. Lá, é possível alterar ou redefinir sua senha a qualquer momento.

A autenticação das APIs da BigDataCorp é feita por meio de Tokens JWT. Com seu usuário e senha, você pode gerar quantos tokens precisar, garantindo segurança e flexibilidade para os seus processos de negócio.

Os tokens podem ser gerados diretamente no BDC Center ou pela API de Tokens. Vale lembrar que todos os tokens possuem um prazo de validade — não existem tokens permanentes.

A API de Tokens está disponível sem custo adicional, permitindo que sua empresa implemente uma política de rotacionamento de Tokens mais adequada às suas necessidades. Para saber mais sobre recomendações e boas práticas, consulte a seção Segurança.

⚠️
Atenção: o seu token de acesso é único, e não deve ser compartilhado. Você será responsável pelo custo de todas as consultas realizadas com o seu token de acesso.

Estrutura de autenticação

Todas as chamadas aos Plugins da BigDataCorp seguem o mesmo padrão de autenticação.

Endpoint base:

https://plugin.bigdatacorp.com.br/

Headers obrigatórios:

AccessToken: SEU-ACCESS-TOKEN
TokenId: SEU-TOKENID
Content-Type: application/json
Accept: application/json

Esses tokens podem ser obtidos no BDC Center ou via API de Tokens.

💡
Dica
O formato de autenticação é o mesmo para todos os Plugins da BigDataCorp. Basta ajustar o endpoint de acordo com o plugin desejado. Por exemplo:
• .../qualidadedeimagem/ → chamadas aos plugins de Tratamento de Imagens
• .../validacoes → chamadas aos plugins de Tratamento de Dados

🛡️Segurança

Usuários e senhas

A gestão de usuários e senhas é feita pelo BDC Center. Recomendamos que cada usuário tenha sua própria conta e que as credenciais nunca sejam compartilhadas.

Ao integrar nossas APIs aos seus sistemas, utilize usuários de serviço dedicados, sempre associados a e-mails corporativos válidos.

Em ambientes produtivos, gere e utilize tokens vinculados a esses usuários de serviço, garantindo rastreabilidade e segurança no uso das APIs.

Rotacionamento de Tokens

Embora a API de Tokens permita que Tokens sejam gerados com até 10 anos de validade (87.600 horas), sugerimos que os tokens sejam rotacionados diariamente. Não recomendamos rotacionar os tokens mais de 1 vez dentro de uma mesma hora.

Consulte a documentação da API de Tokens — ela oferece recursos que permitem implementar a política de rotacionamento de tokens mais adequada à sua organização.

Tokens e aplicações web

Utilize os tokens apenas em aplicações que operam no backend. Eles funcionam como a sua autenticação nas APIs da BigDataCorp e podem ser expostos ou comprometidos se usados diretamente no frontend da aplicação.