# ShinrAI für n8n

Importieren Sie eine Datei aus `workflows/`: Textbeispiel (`text-example`), Formulare (`form-processing`), Dokumente (`document-sharing`), KI mit lokaler Wiederherstellung (`ai-with-local-restoration`) oder Standard-HTTP-Knoten (`http-only-text`). Wählen Sie Zugangsdaten aus und ersetzen Sie die Beispieladressen vor der Aktivierung. Für HTTP-Knoten verwenden Sie **Header Auth**: Name `Authorization`, Wert `Bearer IHR_SHINRAI_SCHLÜSSEL`. Das HTTP-Beispiel benötigt kein Community-Paket. Im KI-Beispiel erhält der Modellanbieter eigene Zugangsdaten. Zuordnungen werden nicht an das Modell gesendet. Die Vorlagen speichern keine Ausführungsinhalte; aktivieren Sie dies nur zur Fehlersuche mit synthetischen Daten.

Schützen Sie Texte und Dokumente, bevor ein weiterer Workflow-Schritt sie an andere Systeme weitergibt. Die Ausgabe enthält die geschützten Daten; Originaleingaben werden nicht automatisch übernommen. Zugangsdaten bleiben in n8n.

## Installation und Verbindung

Das Paket kann direkt installiert werden. Die Veröffentlichung auf npm und die Freigabe für n8n Cloud sind separate Schritte.

```sh
cd ~/.n8n/nodes
npm install --ignore-scripts --legacy-peer-deps /pfad/zu/n8n-nodes-shinrai-0.1.0.tgz
```

Starten Sie n8n anschließend neu. Bei Docker liegt das persistente Benutzerverzeichnis unter `/home/node/.n8n`. Für n8n Cloud steht bis zur Freigabe eine Vorlage mit Standard-HTTP-Nodes bereit.

1. Legen Sie Zugangsdaten vom Typ **ShinrAI** an und tragen Sie Ihren API-Schlüssel ein.
2. Fügen Sie nach dem Eingang von Kundendaten den Node **ShinrAI** ein.
3. Wählen Sie **Text schützen**, geben Sie den Text an und wählen Sie Pseudonyme, Maskierung oder Kategorien.
4. Verbinden Sie das Ziel ausschließlich mit dem geschützten Ausgabefeld `text`.
5. Prüfen Sie mit einem erfundenen Namen und einer Test-E-Mail-Adresse, was am Ziel ankommt.

Für **Dokument schützen** wählen Sie das Binärfeld. Die voreingestellte Upload-Kennung darf für eine Wiederholung desselben Dokuments verwendet werden. Unterstützt werden PDF, DOCX und UTF-8-TXT bis 10 MB, einschließlich unterstützter Scans und eingebetteter Bilder mit deutscher/englischer Texterkennung. Die Ausgabe enthält eine geschützte PDF-Datei unter `data` und geschützten Text unter `text`. Nicht vollständig verarbeitbare Dateien stoppen den Workflow.

**Private Zuordnungen enthalten Originaldaten.** Aktivieren Sie diese Ausgabe nur zur lokalen Wiederherstellung. Halten Sie die Zuordnung auf einem separaten Workflow-Zweig und senden Sie nur geschützten Text an das KI-Modell. Danach kann **Antwort wiederherstellen** erkannte Pseudonyme lokal zurückwandeln. **Analysieren** gibt Originalwerte in den Fundstellen zurück und ist kein Schutzschritt.

Zusätzliche Vorlagen ohne Community-Paket: `http-only-ai` für geschützte Modellaufrufe und `http-only-document` für Dokumente. Die Dokumentvorlage startet einen Auftrag, wartet begrenzt auf dessen Abschluss, sendet geschützten Text und löscht danach den temporären Auftrag. Bei allen ShinrAI-HTTP-Schritten dieselben Zugangsdaten wählen. Dokument-Webhooks erwarten den rohen Dateiinhalt mit korrektem Content-Type. Der Formular-Webhook erwartet JSON-Felder `name`, `email` und `message` und überträgt beschrifteten geschützten Text.

Bei Schutzschritten **Settings → On Error → Stop Workflow** wählen und **Always Output Data** deaktiviert lassen. Der native Node erkennt „Bei Fehler fortfahren“ und stoppt den Zweig mit einem roten Ausführungshinweis. n8n kann die Gesamtausführung trotzdem als erfolgreich anzeigen, wenn ein Zweig keine Einträge ausgibt; deshalb Hinweis und tatsächliche Zustellung prüfen. Keine Fehlerzweige oder Zielausdrücke verwenden, die Originale aus früheren Nodes auslesen. Ungültige Schlüssel, fehlendes Guthaben und Verarbeitungsfehler stoppen den Vorgang. n8n verwaltet weiterhin den Zugriff auf Quelldaten, Zuordnungen und gespeicherte Ausführungen. Geschützt wird der konfigurierte Workflow-Pfad; unabhängige Nodes und Modellverbindungen sind nicht automatisch abgedeckt.

## Geprüftes Beispiel

Die [Screenshots](screenshots/) stammen aus der tatsächlich installierten Testumgebung mit synthetischen Daten. Ersatzwerte können bei jedem Lauf anders aussehen. Die gemeinsamen Beispieldateien und ein ausführbarer Verbindungstest liegen im Ordner `../fixtures/` des Downloadpakets.