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;
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. 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.

💡
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.

Restrição de acesso

Caso sua arquitetura exija camadas adicionais de segurança, é possível solicitar a configuração de restrições de acesso às APIs da BigDataCorp, limitando chamadas a domínios específicos (CORS) ou a ranges de IP autorizados.

Para habilitar qualquer uma dessas configurações, entre em contato com o seu representante de Customer Success, informando o domínio que deverá ser autorizado (CORS) ou os ranges de IP permitidos.

Limite de requisições

Por motivos de segurança e estabilidade da plataforma, as APIs possuem um rate limit de 5.000 consultas a cada 5 minutos (por endereço IP). As requisições devem ser distribuídas ao longo desse intervalo, evitando picos de chamadas em curtos períodos.

Caso o limite seja excedido, a API retornará o erro HTTP 429 — Too Many Requests.