obscurIA — connettore n8n (Windows x64)
==========================================

COSA SERVE PRIMA DI INIZIARE
-----------------------------
Una licenza obscurIA attiva SULLO STESSO COMPUTER dove eseguirai questi due
programmi (obscuria-bridge.exe, obscuria-ingress.exe). 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. SBLOCCA I FILE SCARICATI
------------------------------
Windows marca ogni file scaricato da internet e può bloccarne l'esecuzione
al primo avvio. Prima di tutto, in PowerShell, dentro la cartella estratta:

  Unblock-File .\obscuria-bridge.exe
  Unblock-File .\obscuria-ingress.exe

2. VERIFICA L'IMPRONTA
-------------------------
Confrontala con quella pubblicata sul sito (contro SHA256SUMS.txt incluso):

  Get-FileHash .\obscuria-bridge.exe -Algorithm SHA256
  Get-FileHash .\obscuria-ingress.exe -Algorithm SHA256

3. IL NODO N8N
---------------
Nella cartella dati di n8n (di solito %USERPROFILE%\.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 $env:USERPROFILE\.n8n\custom -Force
  cd $env:USERPROFILE\.n8n\custom
  npm install C:\percorso\dove\hai\estratto\questo\pacchetto\n8n-nodes-obscuria-0.1.0.tgz

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

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

Nel nodo n8n imposta "Percorso del motore" con il percorso completo di
obscuria-bridge.exe, a meno di averlo messo in una cartella già nel PATH.

5. 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, in
PowerShell:

  $env:OBSCURIA_INGRESS_ASCOLTO = "127.0.0.1:8477"
  .\obscuria-ingress.exe

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

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

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

6. 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

Domande: scrivi a info@obscuria.it
