Integración
Empezar
Cómo conectar ONYX a un sitio web. Para Discord, el conector es Argos.
Tres pasosINI-1335
1
Crea una clave
https://onyxos.duckdns.org/cuenta → Conectores
En tu panel, pestaña Conectores. Se enseña una vez y empieza por onx_live_.
2
Pregunta antes de actuar
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();Una petición y ya está. No hay paquete que instalar: es HTTP y basta con lo que tu lenguaje ya trae.
3
Comprueba la firma
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'));La clave pública se baja una vez y se guarda. Verificar es local: no hace falta volver a preguntarnos, y así un intermediario no puede cambiar un veredicto por el camino.
No hay biblioteca oficial a propósito. ONYX no tiene dependencias en ejecución y no va a pedirte que tú sí las tengas.
Dónde se compruebaLOC-1336
La comprobación ocurre en tu servidor. No nos envías la identidad de nadie: recibes una credencial firmada, descargas la clave pública una vez y decides tú.
Si no se pueden descargar las claves, la respuesta es «no lo sé», no «es falso». Un corte de red no debería costarle el acceso a nadie.