Интеграция

Начало работы

Как подключить ONYX к сайту. Для Discord коннектор — Argos.

Три шагаINI-1345

Создайте ключ

https://onyxos.duckdns.org/cuenta  →  Коннекторы

В панели, вкладка «Коннекторы». Показывается один раз, начинается с onx_live_.

Спросите, прежде чем действовать

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

Один запрос — и всё. Ставить нечего: это HTTP, хватит того, что уже есть в вашем языке.

Проверьте подпись

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

Открытый ключ скачивается один раз и хранится. Проверка локальная: спрашивать нас снова не нужно, и никто по пути не перепишет вердикт.

Официальной библиотеки нет намеренно. У ONYX нет зависимостей при выполнении, и он не станет требовать их от вас.

Где происходит проверкаLOC-1346

Проверка выполняется на вашем сервере. Вы не присылаете нам ничью личность: вы получаете подписанный документ, один раз скачиваете открытый ключ и решаете сами.

Если ключи не скачиваются, ответ — «не знаю», а не «подделка». Сбой сети не должен стоить кому-то доступа.