Pular para o conteúdo principal

Autenticação com NDD ID

O mesmo processo de autenticação atende todos os módulos. Obtenha o token uma vez e envie-o nas operações autorizadas.

Características do acesso​

ProtocoloFluxoValidade informada
OAuth 2.0Client Credentials60 minutos

Prepare seu acesso​

A empresa ou grupo precisa estar habilitado no NDD Space e a integração deve receber as permissões adequadas.

  • Empresa ou grupo habilitado no NDD Space.
  • Integração permissionada.
  • client_id e client_secret válidos.
  • Escopo integracao-api.

Nunca publique o client_secret em código, logs ou documentação distribuída.

Gerar token​

Use suas credenciais no fluxo client_credentials para obter um token Bearer:

curl --request POST \
--url https://spacenddidentityprod.e-datacenter.nddigital.com.br/connect/token \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=YOUR_CLIENT_ID' \
--data-urlencode 'client_secret=YOUR_CLIENT_SECRET' \
--data-urlencode 'scope=integracao-api'

Depois, envie o token nas APIs protegidas:

Authorization: Bearer <access_token>

Endpoints do NDD ID​

AmbienteEndpoint
Homologação NddSpacehttps://spacenddidentityhml.e-datacenter.nddigital.com.br/connect/token
Produção NddSpacehttps://spacenddidentityprod.e-datacenter.nddigital.com.br/connect/token

Boas práticas para esta jornada​

01

Evite reenvios idênticos

Antes de repetir um envio, confirme o resultado da tentativa anterior.

02

Guarde a correlação

Registre protocolos e chaves para rastrear cada etapa do processamento.

03

Proteja credenciais

Nunca exponha segredos em código-fonte, logs, planilhas ou exemplos.

04

Respeite os limites

Implemente espera progressiva e não repita chamadas idênticas em sequência.