Referencia
Documentación
Cómo se integra un conectorINT-1367
| Paso | Qué haces |
|---|---|
| 1 | Crea una clave En tu panel, pestaña Conectores. Sale una vez y empieza por onx_live_. |
| 2 | Cuéntale lo que ves Manda avistamientos en lotes. No hace falta esperar respuesta: es fuego y olvido. |
| 3 | Pregúntale antes de actuar Consulta un dominio o una cuenta y recibe un veredicto FIRMADO que puedes guardar y comprobar después sin fiarte de nosotros. |
| 4 | Comprueba la firma Baja la clave pública una vez y verifica en local. Si ONYX se equivoca, tienes el papel; y si tú bloqueaste a alguien, también. |
APIAPI-1368
| ruta | función | acceso |
|---|---|---|
POST /v1/query (/v1/consulta) | Pregunta por un dominio o una cuenta. Devuelve el veredicto firmado. | con credencial |
PUT /v1/ingest | Manda lo que has visto. En lotes, sin esperar respuesta. | con credencial |
GET /v1/blocks (/v1/bloqueos) | La lista de identidades que TU espacio tiene bloqueadas, para llevar una copia local y no preguntar en cada visita. Devuelve a quién y si sigue vigente; ninguna acción — qué hacer con la lista lo decides tú. Con `?desde=` solo llega lo que ha cambiado. | con credencial |
POST /v1/ethos | ¿Esta identidad se sostiene? Mandas números ya calculados —perfil de escritura, histograma de horas, cómo se movió en el portal, lo que dice el navegador— y las cuentas conocidas de TU espacio con las que comparar. Devuelve una categoría, cuánto se pudo mirar y cada motivo por escrito; ninguna acción. Texto en crudo: se rechaza. No se guarda nada. | con credencial |
GET /v1/keys (/v1/claves) | La clave pública con la que comprobar cualquier firma nuestra. | público |
GET /v1/list | La lista de PROBE, firmada: lo que entró y salió desde `since`. Se sincroniza por páginas y se compara EN TU CASA; ONYX nunca sabe qué enlace miraste. | con credencial |
GET /v1/p/{prefix} | Todas las entradas cuyo hash empieza por esos 4 bytes, firmado (también si está vacío). Para quien no quiere guardar la lista entera. | con credencial |
GET /v1/dossier/{h} | El expediente de una entrada: de qué fuente salió, cuándo, qué regla saltó y con qué versión del código. Público, para que quien sufra un borrado vea por qué. | público |
POST /v1/probe | Manda URLs sospechosas que tu conector no conocía, sin decir quién las pegó ni dónde. Solo conectores verificados. | con credencial |
curl -X POST https://onyxos.duckdns.org/v1/query \
-H "authorization: Bearer onx_live_..." \
-d '{"tipo":"dominio","valor":"ejemplo.com"}'Todas estas rutas existen y responden. Lo que firma PROBE (ONX-13) se comprueba con la misma clave pública que los veredictos.
Los cinco dictámenesDIC-1369
| dictamen | qué significa |
|---|---|
bloqueado | El propio inquilino la tiene bloqueada desde su panel. No es una deduccion: alguien con nombre lo decidio, quedo registrado y se puede apelar. |
malicious | Está en la lista de PROBE (ONX-13) como malicioso: un feed público, la lista curada o una regla dura. Lleva su categoría y el hash de su expediente. |
campana | El mismo enlace repartiéndose por varias comunidades a la vez. Actúa. |
sospecha | Empieza a parecerse a una campaña, todavía sin certeza. Mira, no borres. |
cadena | Esa cuenta ha hecho una secuencia que ya se ha visto antes en un ataque. |
reincidente | Varias comunidades distintas ya la han sancionado. No esta atacando ahora, pero no es la primera vez. |
limpio | Visto, y sin nada raro. Hay datos detrás de esto. |
desconocido | No lo hemos visto NUNCA. Esto NO es limpio: no hay nada que decir todavía. |
Confundir desconocido con limpio es el fallo que hace que un conector apruebe justo lo que nadie ha mirado.
Por qué el veredicto va firmadoFIR-1370
Un veredicto que hay que creerse porque lo decimos nosotros vale poco. Uno firmado se guarda y se comprueba años después con la clave pública, sin pedirnos permiso y sin que podamos desdecirnos. Corta en las dos direcciones, y por eso vale.
GET https://onyxos.duckdns.org/v1/keys
{ "kid": "…", "alg": "Ed25519", "pub": "…" }Lo que no resuelveLIM-1371
- Un solo emisor. Las credenciales las firma ONYX. Repartir esa función entre varios emisores independientes sigue siendo un problema abierto.
- Recorrer los grupos. Alguien con tiempo puede consultar grupos uno a uno para reconstruir parte de la lista. Falta un límite por cliente.
- Tamaño y ritmo. El canal cifra el contenido. Cuántas consultas haces y cuándo sigue siendo visible desde la red.
- Páginas que se disfrazan. Un sitio malicioso puede detectar nuestro rango de direcciones y mostrar una página limpia.
Estas cuatro están aquí y no en la letra pequeña. Lo que ONYX ofrece no es que algo sea imposible, sino que no pueda hacerse sin dejar rastro.