obscurIA — connettore n8n (Linux x86_64)
==========================================

COSA SERVE PRIMA DI INIZIARE
-----------------------------
Una licenza obscurIA attiva SULLO STESSO COMPUTER dove eseguirai questi due
programmi (obscuria-bridge, obscuria-ingress). Non è una licenza separata:
è la stessa che l'app desktop ha già attivato su quel dispositivo — il
connettore la legge da sola, non c'è nulla da configurare per la licenza.

Se n8n gira su un server diverso dal computer con obscurIA installato e
attivato, il connettore su quel server non troverà nessuna licenza e si
rifiuterà di funzionare. È il comportamento corretto, non un guasto: vanno
sullo stesso dispositivo.

1. IL NODO N8N
---------------
Nella cartella dati di n8n (di solito ~/.n8n/custom, da creare se non
esiste), installa il pacchetto dal tarball incluso in questo archivio
(NON dalla cartella estratta — un'installazione da cartella crea un
collegamento simbolico che rompe la ricerca di "n8n-workflow"):

  mkdir -p ~/.n8n/custom
  cd ~/.n8n/custom
  npm install /percorso/dove/hai/estratto/questo/pacchetto/n8n-nodes-obscuria-0.1.0.tgz

Riavvia n8n. Il nodo "obscurIA" comparirà nell'elenco dei nodi disponibili.

2. I DUE ESEGUIBILI
---------------------
obscuria-bridge  — lo richiama il nodo stesso, dentro il flusso.
obscuria-ingress — va avviato a parte, DAVANTI al flusso n8n (vedi sotto
                   il perché: un nodo da solo non basta).

Verifica prima di tutto l'impronta (contro SHA256SUMS.txt incluso, che
corrisponde a quella pubblicata sul sito):

  sha256sum -c SHA256SUMS.txt

Poi rendili eseguibili e raggiungibili. Il modo più semplice:

  chmod +x obscuria-bridge obscuria-ingress
  sudo cp obscuria-bridge obscuria-ingress /usr/local/bin/

Se preferisci non copiarli nel PATH, nel nodo n8n imposta "Percorso del
motore" con il percorso completo di obscuria-bridge.

3. PERCHÉ SERVE ANCHE obscuria-ingress, NON SOLO IL NODO
------------------------------------------------------------
n8n conserva ciò che riceve nella propria cronologia di esecuzione, anche
in caso di errore — è così che funziona un motore di automazione pensato
per poter ripetere un passo fallito. Un nodo obscurIA messo DENTRO il
flusso arriva sempre un istante troppo tardi: n8n ha già visto il
documento originale prima che il nodo lo protegga.

obscuria-ingress va messo DAVANTI al flusso: riceve il documento per primo,
lo protegge, e solo il testo già protetto arriva a n8n (via webhook, o
restituito a chi ha chiamato). Per collaudarlo senza inoltrare a nulla:

  OBSCURIA_INGRESS_ASCOLTO=127.0.0.1:8477 ./obscuria-ingress

Con una destinazione (il webhook del tuo flusso n8n):

  OBSCURIA_INGRESS_DESTINAZIONE=http://localhost:5678/webhook/il-tuo-flusso \
  ./obscuria-ingress

Resta in ascolto solo su 127.0.0.1 finché non lo configuri diversamente,
di proposito: da lì entrano documenti in chiaro.

4. FLUSSI DI ESEMPIO
----------------------
Nella cartella esempi/, tre flussi pronti da importare in n8n
(Workflows → Import from File):

  01-testo-verso-ai.json           — protezione reversibile verso un'AI esterna
  02-anonimizzazione-definitiva.json — nessuna mappatura, irreversibile
  03-revisione-umana.json          — il testo protetto si ferma per un controllo

5. AL MOMENTO SOLO LINUX x86_64
----------------------------------
Windows e macOS sono in preparazione, non ancora collaudati: non li
distribuiamo finché non lo sono davvero.

Domande: scrivi a info@obscuria.it
