API de gestão

Arquivos e DLP

• Método: POST | Rota: /api/atlasberg/files/scan | Uso: O portal envia um arquivo multipart e recebe o veredito DLP (upload_id, status, motivo, codigos). Bloqueio vem com HTTP 200 e o veredito no corpo; 400, 413 e 503 são falhas do gateway, não veredito.
• Método: GET | Rota: /api/atlasberg/policies | Uso: A política DLP em vigor.
• Método: POST | Rota: /api/atlasberg/policies/test | Uso: Teste de política.

Aprovações

• Método: GET | Rota: /api/atlasberg/approvals | Uso: Fila de aprovações pendentes: códigos de motivo mais o hash do payload, nunca o texto.
• Método: POST | Rota: /api/atlasberg/approvals/{id}/approve e /deny | Uso: Decidir uma aprovação. A identidade do aprovador é obrigatória: sessão verificada, ou o header x-atlasberg-approver ou o campo aprovador do corpo.

Auditoria

• Método: GET | Rota: /api/atlasberg/audit | Uso: Status da trilha.
• Método: GET | Rota: /api/atlasberg/audit/events | Uso: Leitura de eventos.
• Método: POST | Rota: /api/atlasberg/audit/verify | Uso: Verificação da trilha pelo próprio gateway.
• Método: GET | Rota: /api/atlasberg/audit/export | Uso: Export assinado.
• Método: POST | Rota: /api/atlasberg/audit/anchor | Uso: Força uma âncora.

Custo e inteligência

• Método: GET/POST, PUT/DELETE em {id} | Rota: /api/atlasberg/orcamentos | Uso: Orçamentos suaves (corte suave).
• Método: GET | Rota: /api/atlasberg/economometro e /economometro/alerta | Uso: Medidor passivo de desperdício.
• Método: GET | Rota: /api/atlasberg/agentes | Uso: Inventário de agentes observados.
• Método: GET | Rota: /api/atlasberg/cambio | Uso: Cotação USD para exibição em BRL no console.
• Método: GET | Rota: /api/atlasberg/finops/chargeback | Uso: Rateio FinOps.
• Método: GET | Rota: /api/atlasberg/executivo e /executivo/export | Uso: Painel executivo e export (PDF).
• Método: GET/POST, PUT/DELETE em {id}, POST/DELETE em {id}/times/{team_id} | Rota: /api/atlasberg/executivo/unidades | Uso: Árvore de unidades organizacionais e mapeamento de times.

Conformidade

• Método: GET | Rota: /api/atlasberg/compliance e /compliance/export | Uso: Relatório de conformidade.

Copilot

• Método: GET | Rota: /api/atlasberg/copilot | Uso: Painel de licenças Copilot importadas. Responde sempre com dado e carrega modulo_licenciado (booleano) e, quando falso, modulo_aviso. As listas superficies e por_time podem ser vazias, nunca null.
• Método: POST/DELETE | Rota: /api/atlasberg/copilot/{superficie} | Uso: Importar ou remover inventário. POST responde 403 sem o módulo copilot; DELETE nunca depende da licença.
• Método: GET, PUT/DELETE em /conexoes/{superficie} | Rota: /api/atlasberg/copilot/conexoes | Uso: Configuração de acesso por superfície. GET devolve sempre a configuração completa mais modulo_licenciado e modulo_aviso; o segredo nunca é devolvido. PUT responde 403 sem o módulo.

Licença

• Método: GET | Rota: /api/atlasberg/license | Uso: Estado vivo da licença: plano, expiração, graça, módulos, high water mark, chave pública do deployment.
• Método: POST | Rota: /api/atlasberg/license/import | Uso: Importa a licença assinada (corpo cru ou multipart file, máximo 64 KiB).
• Método: GET | Rota: /api/atlasberg/license/activation | Uso: Pedido de ativação assinado, para copiar ao back-office.
• Método: GET | Rota: /api/atlasberg/license/usage | Uso: Relatório de uso assinado (?period=YYYY-MM; vazio agrega a trilha inteira).

SSO

• Método: GET | Rota: /api/atlasberg/sso/login e /sso/callback | Uso: Login OIDC.
• Método: POST | Rota: /api/atlasberg/sso/local-login e /sso/logout | Uso: Login local air-gapped e logout.
• Método: GET | Rota: /api/atlasberg/sso/session | Uso: Sessão.
• Método: GET | Rota: /api/atlasberg/sso/downloads e /sso/downloads/{arquivo} | Uso: Listar e baixar os binários da CLI atlasberg servidos pelo appliance (lista fechada de cinco arquivos, a partir de ATLASBERG_DOWNLOADS_DIR).

Login por dispositivo e tokens pessoais

Device flow da RFC 8628. Estas rotas são montadas fora da cadeia de gestão, junto das demais rotas /sso/: o terminal chama as duas primeiras sem credencial nenhuma, o portal chama as três seguintes com o cookie de sessão, e as duas últimas são os tokens da própria pessoa. Tokens pessoais carregam o prefixo atu- (43 caracteres base64url); o código de usuário tem 8 letras do alfabeto BCDFGHJKLMNPQRSTVWXZ, exibido como XXXX-XXXX.

• Método: POST | Rota: /api/atlasberg/sso/device/code | Uso: Terminal pede um código (client_name opcional). Devolve device_code, user_code, verification_uri, verification_uri_complete, expires_in, interval.
• Método: POST | Rota: /api/atlasberg/sso/device/token | Uso: Terminal consulta com device_code. Devolve access_token e token_type Bearer. Erros da RFC com 400: authorization_pending, slow_down, expired_token, access_denied, invalid_grant; codigo_desconhecido com 404; limite_de_origem com 429.
• Método: GET | Rota: /api/atlasberg/sso/device/pendente?codigo= | Uso: Portal (cookie): o pedido pendente por trás de um código, para a tela de aprovação em /portal/dispositivo.
• Método: POST | Rota: /api/atlasberg/sso/device/aprovar e /negar | Uso: Portal (cookie): a pessoa aprova ou nega o código.
• Método: GET | Rota: /api/atlasberg/sso/tokens | Uso: Os tokens da própria pessoa.
• Método: DELETE | Rota: /api/atlasberg/sso/tokens/{id} | Uso: Revoga um token da pessoa; atual significa o token desta própria requisição.
• Política padrão: código válido por 10 minutos (piso 1, teto 30), intervalo de consulta de 5 segundos (mínimo 1), token válido por 7 dias (de 1 hora a 90 dias), 5 tokens por pessoa (mínimo 1), 1000 concessões pendentes, 10 pedidos de código e 30 consultas por origem por minuto. Configurado no bloco device_flow do sso.json.
• A roster de tokens guarda só digests SHA-256, em <app-dir>/atlasberg-tokens-pessoais.json com modo 0600.
• Na inferência o token é aceito nos mesmos headers de uma chave virtual e trocado pela chave viva do time; veja a página API do plano de dados.

Identidade

As rotas por trás de Configurações, Identidade e SSO. Montadas na cadeia de gestão como o resto desta página. Cada gravação da configuração gera um evento config.change com recurso sso e a seção no detalhe; cada ciclo de sincronização com o diretório gera config.change com recurso diretorio e ator sincronizacao_diretorio.

• Método: GET/PUT | Rota: /api/atlasberg/identidade/config | Uso: Ler a tela inteira numa chamada, ou gravar uma seção do sso.json; validado antes de salvar, salvo atomicamente, aplicado ao vivo.
• Método: POST | Rota: /api/atlasberg/identidade/config/testar | Uso: Rodar a descoberta OIDC contra o issuer configurado.
• Método: POST | Rota: /api/atlasberg/identidade/contas-locais | Uso: Criar conta local.
• Método: PUT/DELETE | Rota: /api/atlasberg/identidade/contas-locais/{usuario} | Uso: Atualizar ou remover conta local.
• Método: PUT | Rota: /api/atlasberg/identidade/contas-locais/{usuario}/senha | Uso: Trocar a senha de uma conta local.
• Método: GET | Rota: /api/atlasberg/identidade/tokens | Uso: Todos os tokens pessoais emitidos neste gateway.
• Método: DELETE | Rota: /api/atlasberg/identidade/tokens/{id} | Uso: Revogar um token (administrador).
• Método: POST | Rota: /api/atlasberg/identidade/tokens/revogar-pessoa | Uso: Revogar todos os tokens de uma pessoa.
• Método: GET | Rota: /api/atlasberg/identidade/diretorio | Uso: Estado da sincronização com o diretório.
• Método: POST | Rota: /api/atlasberg/identidade/diretorio/previa | Uso: Prévia do plano de sincronização, sem aplicar.
• Método: POST | Rota: /api/atlasberg/identidade/diretorio/sincronizar | Uso: Rodar um ciclo de sincronização agora.

Rotas de gestão herdadas

O motor base também expõe as rotas de gestão herdadas: /api/governance/* para chaves virtuais e times, /api/config, /api/providers, /api/plugins e /api/session/login, logout e ws-ticket. POST /api/session/login aceita, além do par de admin, as contas da roster local_login que carregam o grupo de console; a sessão fica vinculada à pessoa e a trilha a nomeia. O logout desfaz o vínculo.

Congelamento por licença: Com o plano de controle congelado (expirada pós-graça, ou setup), mutações sob /api são recusadas com 403 por allowlist. Leituras GET sempre passam. Ficam abertas só as rotas de licença, login e sessão, as rotas /api/atlasberg/sso/, /api/atlasberg/files/scan e as revogações sob /api/atlasberg/identidade/tokens. Editar a configuração de identidade e as contas locais congela com o resto. Detalhes na página Licenciamento.

Sobre a Atlasberg Platform

A Atlasberg Platform é a camada de controle entre uma empresa e todos os modelos de IA: cada requisição é autenticada com uma chave virtual, filtrada por política e DLP, roteada para o provedor certo e gravada numa trilha de auditoria encadeada por hash. Expõe uma API compatível com a OpenAI, então as aplicações só trocam a URL base.

O mesmo artefato roda na Atlasberg Cloud, na sua VPC, on-premises ou totalmente air-gapped, e é cobrado por capacidade e módulos, nunca por assento.

Esta página faz parte da documentação oficial. Para falar com o time de engenharia, escreva para [email protected] ou use https://atlasberg.com/pt-br/contato. A resposta vem em até um dia útil.