Integration

Get started

How to connect ONYX to a website. For Discord, the connector is Argos.

Three stepsINI-1236

Create a key

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

In your panel, Connectors tab. Shown once, starts with onx_live_.

Ask before you act

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();

One request, that is all. There is no package to install: it is HTTP, and whatever your language already ships is enough.

Check the signature

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'));

The public key is fetched once and kept. Verifying is local: you never have to ask us again, and nothing in the middle can rewrite a verdict on the way.

There is no official library on purpose. ONYX has no runtime dependencies and is not going to ask you to take one.

Where the check happensLOC-1237

The check runs on your server. You do not send us anyone's identity: you receive a signed credential, download the public key once and decide yourself.

If the keys cannot be downloaded, the answer is "I do not know", not "it is fake". A network outage should not cost anyone access.