Integração

Começar

Como ligar o ONYX a um site. Para o Discord, o conector é o Argos.

Três passosINI-1337

Cria uma chave

https://onyxos.duckdns.org/cuenta  →  Conectores

No teu painel, separador Conectores. Aparece uma vez e começa por onx_live_.

Pergunta antes de agir

const r = await fetch('https://onyxos.duckdns.org/v1/query', {
  method: 'POST',
  headers: { authorization: 'Bearer ' + process.env.ONYX_KEY,
             'content-type': 'application/json' },
  body: JSON.stringify({ tipo: 'dominio', valor: host }),
});
const { veredicto, firmado } = await r.json();
if (veredicto.dictamen === 'campana') bloquear();

Um pedido e pronto. Não há pacote para instalar: é HTTP, e o que a tua linguagem já traz chega.

Verifica a assinatura

const [carga, firma] = firmado.split('.');
const llave = crypto.createPublicKey({ format: 'jwk',
  key: { kty: 'OKP', crv: 'Ed25519', x: pub } });
const valido = crypto.verify(null, Buffer.from(carga, 'base64url'),
  llave, Buffer.from(firma, 'base64url'));

A chave pública descarrega-se uma vez e guarda-se. Verificar é local: não voltas a perguntar-nos, e nada pelo caminho pode reescrever um veredicto.

Não há biblioteca oficial de propósito. O ONYX não tem dependências em execução e não te vai pedir que tenhas uma.

Onde acontece a verificaçãoLOC-1338

A verificação corre no teu servidor. Não nos envias a identidade de ninguém: recebes uma credencial assinada, descarregas a chave pública uma vez e decides tu.

Se as chaves não puderem ser descarregadas, a resposta é «não sei», não «é falso». Uma falha de rede não devia custar o acesso a ninguém.