Autenticação
OAuth 2.0 client credentials, conta do token e validade.
A API usa OAuth 2.0 com o fluxo client credentials: o seu servidor troca o client id e o client secret por um access token (JWT) e o envia em toda chamada:
Authorization: Bearer <access_token>Gerando o token
curl -s https://auth.u2dtecnologia.com.br/realms/u2d-nota-fiscal/protocol/openid-connect/token \
-u "$CLIENT_ID:$CLIENT_SECRET" \
-d grant_type=client_credentials- No Sandbox, o token sai do realm
u2d-nota-fiscal-sandbox, com as credenciais do Sandbox (veja Ambientes). - As credenciais vão no header
Authorization: Basic(o-udocurl), como recomenda a RFC 6749. - O token vale 5 minutos (
expires_in: 300) e não tem refresh token: perto de expirar, peça outro com as mesmas credenciais. - Guarde o token em memória no servidor e reaproveite-o. Pedir um token por chamada deixa a integração mais lenta.
O secret nunca vai para o navegador ou app
O fluxo client credentials é para servidor. Não use o secret em front-end, app mobile ou repositório de código. Se ele vazar, peça a troca pelo Atendimento.
Conta do token
Cada client pertence a uma conta, e a API usa o token para saber de quem é a chamada. Você nunca envia o id da
conta: os emitentes cadastrados ficam na conta do token, e as consultas só enxergam os dados dela. Recurso de outra
conta responde 404, como se não existisse.
O que a conta pode emitir depende dos produtos contratados, não de escopos do token: veja Conta e emitentes.
Rotas sem autenticação
| Rota | Para quê |
|---|---|
GET /api/v1/status-servico | Status dos web services da SEFAZ por UF (Status da SEFAZ) |
GET /public/status | Status da própria API (Ambientes) |
Erros de autenticação
| Status | type | Quando | Header WWW-Authenticate |
|---|---|---|---|
401 | nao-autenticado | Token ausente | Bearer |
401 | nao-autenticado | Token inválido, expirado ou de outro ambiente | Bearer error="invalid_token" |
403 | acesso-negado | Token válido, mas sem conta associada | Bearer error="insufficient_scope" |
403 | conta-inativa | A conta foi desativada | — |
Num 401 com invalid_token, gere um token novo e repita a chamada uma vez. Se persistir, confira as credenciais
do ambiente.