Referência

Documentação

Como se integra um conectorINT-1374

Passo	O que fazes
1	Cria uma chave No teu painel, separador Conectores. Aparece uma vez e começa por onx_live_.
2	Conta-lhe o que vês Envia avistamentos em lotes. Não é preciso esperar resposta: dispara e esquece.
3	Pergunta antes de agir Consulta um domínio ou uma conta e recebe um veredicto ASSINADO que podes guardar e verificar depois sem confiar em nós.
4	Verifica a assinatura Descarrega a chave pública uma vez e verifica localmente. Se o ONYX se enganou tens o papel; e se bloqueaste alguém, também.

APIAPI-1375

rota	função	acesso
`POST /v1/query` (/v1/consulta)	Pergunta por um domínio ou uma conta. Devolve o veredicto assinado.	com credencial
`PUT /v1/ingest`	Envia o que viste. Em lotes, sem esperar resposta.	com credencial
`GET /v1/blocks` (/v1/bloqueos)	A lista de identidades que O TEU espaço tem bloqueadas, para manteres uma cópia local e não perguntares em cada visita. Devolve quem e se continua em vigor; nenhuma ação — o que fazer com a lista decides tu. Com `?desde=` só chega o que mudou.	com credencial
`POST /v1/ethos`	Esta identidade aguenta-se? Envias números já calculados —perfil de escrita, histograma de horas, como se moveu no portal, o que diz o navegador— e as contas conhecidas do TEU espaço com que comparar. Devolve uma categoria, quanto se pôde ver e cada motivo por escrito; nenhuma ação. Texto em bruto é rejeitado. Nada é guardado.	com credencial
`GET /v1/keys` (/v1/claves)	A chave pública para verificar qualquer assinatura nossa.	público
`GET /v1/list`	A lista do PROBE, assinada: o que entrou e saiu desde `since`. Sincroniza-se por páginas e compara-se EM TUA CASA; o ONYX nunca sabe que link viste.	com credencial
`GET /v1/p/{prefix}`	Todas as entradas cujo hash começa por esses 4 bytes, assinado (também se vazio). Para quem não guarda a lista inteira.	com credencial
`GET /v1/dossier/{h}`	O dossiê de uma entrada: de que fonte veio, quando, que regra disparou e com que versão do código. Público, para quem sofreu uma remoção ver porquê.	público
`POST /v1/probe`	Envia URLs suspeitas que o teu conector não conhecia, sem dizer quem as colou nem onde. Só conectores verificados.	com credencial

curl -X POST https://onyxos.duckdns.org/v1/query \
  -H "authorization: Bearer onx_live_..." \
  -d '{"tipo":"dominio","valor":"ejemplo.com"}'

Todas estas rotas existem e respondem. O que o PROBE (ONX-13) assina verifica-se com a mesma chave pública dos veredictos.

Os cinco veredictosDIC-1376

veredicto	o que significa
`bloqueado`	O proprio inquilino bloqueou-a a partir do seu painel. Nao e uma deducao: alguem com nome decidiu, ficou registado e pode ser apelado.
`malicious`	Está na lista do PROBE (ONX-13) como malicioso: um feed público, a lista curada ou uma regra dura. Leva a sua categoria e o hash do seu dossiê.
`campana`	O mesmo link a espalhar-se por várias comunidades ao mesmo tempo. Age.
`sospecha`	Começa a parecer uma campanha, ainda sem certeza. Observa, não apagues.
`cadena`	Essa conta fez uma sequência já vista antes num ataque.
`reincidente`	Varias comunidades diferentes ja a sancionaram. Nao esta a atacar agora, mas nao e a primeira vez.
`limpio`	Visto, e sem nada de estranho. Há dados por trás disto.
`desconocido`	NUNCA o vimos. Isto NÃO é limpo: ainda não há nada a dizer.

Confundir desconhecido com limpo é o erro que faz um conector aprovar exatamente o que ninguém olhou.

Porque é que o veredicto vai assinadoFIR-1377

Um veredicto em que se tem de acreditar porque o dizemos nós vale pouco. Um assinado guarda-se e verifica-se anos depois com a chave pública, sem nos pedir licença e sem que possamos voltar atrás. Corta nos dois sentidos, e é por isso que vale.

GET https://onyxos.duckdns.org/v1/keys
{ "kid": "…", "alg": "Ed25519", "pub": "…" }

O que não resolveLIM-1378

Um só emissor. As credenciais são assinadas pelo ONYX. Repartir essa função por vários emissores independentes continua a ser um problema em aberto.
Percorrer os grupos. Com tempo, alguém pode consultar grupos um a um e reconstruir parte da lista. Falta um limite por cliente.
Tamanho e ritmo. O canal cifra o conteúdo. Quantas consultas fazes e quando continua visível a partir da rede.
Páginas que se disfarçam. Um site malicioso pode detectar a nossa gama de endereços e mostrar uma página limpa.

Estas quatro estão aqui e não nas letras pequenas. O que o ONYX oferece não é que algo seja impossível, mas que não possa ser feito sem deixar rasto.