Справочник

Документация

Как подключается коннекторINT-1379

Шаг	Что делать
1	Создайте ключ В панели, вкладка «Коннекторы». Показывается один раз, начинается с onx_live_.
2	Расскажите, что видите Отправляйте наблюдения пачками. Ответа ждать не нужно: отправил и забыл.
3	Спросите, прежде чем действовать Запросите домен или аккаунт и получите ПОДПИСАННЫЙ вердикт, который можно сохранить и проверить позже, не доверяя нам.
4	Проверьте подпись Скачайте открытый ключ один раз и проверяйте локально. Если ONYX ошибся — у вас есть документ; и если вы кого-то заблокировали, тоже.

APIAPI-1380

маршрут	назначение	доступ
`POST /v1/query` (/v1/consulta)	Спросите о домене или аккаунте. Возвращает подписанный вердикт.	по документу
`PUT /v1/ingest`	Отправьте то, что видели. Пачками, без ожидания ответа.	по документу
`GET /v1/blocks` (/v1/bloqueos)	Список личностей, заблокированных ВАШИМ пространством, чтобы держать локальную копию и не спрашивать при каждом визите. Возвращает, кого и действует ли блокировка; никаких действий — что делать со списком, решаете вы. С `?desde=` приходит только изменённое.	по документу
`POST /v1/ethos`	Держится ли эта личность? Вы отправляете уже посчитанные числа — профиль письма, гистограмму часов, как человек двигался на портале, что сообщает браузер — и известные аккаунты ВАШЕГО пространства для сравнения. Возвращается категория, сколько удалось проверить, и каждая причина словами; никаких действий. Сырой текст отклоняется. Ничего не сохраняется.	по документу
`GET /v1/keys` (/v1/claves)	Открытый ключ для проверки любой нашей подписи.	публичный
`GET /v1/list`	Список PROBE с подписью: что добавилось и убралось с `since`. Синхронизируется по страницам и сверяется У ВАС; ONYX не узнаёт, какую ссылку вы проверили.	по документу
`GET /v1/p/{prefix}`	Все записи, чей хеш начинается с этих 4 байт, с подписью (даже пустой ответ). Для тех, кто не хранит весь список.	по документу
`GET /v1/dossier/{h}`	Досье записи: источник, время, сработавшее правило и версия кода. Публичное, чтобы тот, у кого удалили сообщение, видел почему.	публичный
`POST /v1/probe`	Отправляет подозрительные URL, которых ваш коннектор не знал, без указания кто и где их опубликовал. Только проверенные коннекторы.	по документу

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

Все эти маршруты существуют и отвечают. Подпись PROBE (ONX-13) проверяется тем же открытым ключом, что и вердикты.

Пять вердиктовDIC-1381

вердикт	что означает
`bloqueado`	Сам арендатор заблокировал её из своей панели. Это не вывод: решение принял человек с именем, оно записано и его можно обжаловать.
`malicious`	Есть в списке PROBE (ONX-13) как вредоносный: публичный фид, курируемый список или жёсткое правило. С категорией и хешем досье.
`campana`	Одна и та же ссылка расходится сразу по нескольким сообществам. Действуйте.
`sospecha`	Начинает походить на кампанию, уверенности пока нет. Смотрите, не удаляйте.
`cadena`	Этот аккаунт выполнил последовательность, уже виденную в атаке.
`reincidente`	Несколько разных сообществ уже применяли санкции. Сейчас не атакует, но это не первый раз.
`limpio`	Видели, ничего странного. За этим стоят данные.
`desconocido`	Мы НИКОГДА этого не видели. Это НЕ «чисто»: пока сказать нечего.

Путать «неизвестно» с «чисто» — та самая ошибка, из-за которой коннектор одобряет именно то, на что никто не смотрел.

Почему вердикт подписанFIR-1382

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

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

Чего это не решаетLIM-1383

Единственный эмитент. Документы подписывает ONYX. Разделить эту роль между независимыми эмитентами — всё ещё открытая задача.
Перебор групп. При наличии времени можно опрашивать группы по одной и восстановить часть списка. Не хватает лимита на клиента.
Размер и ритм. Канал шифрует содержимое. Сколько запросов вы делаете и когда — по-прежнему видно из сети.
Страницы, которые маскируются. Вредоносный сайт может распознать наш диапазон адресов и показать чистую страницу.

Эти четыре пункта здесь, а не в мелком шрифте. ONYX обещает не невозможность, а невозможность сделать это незаметно.