---
created: 2026-10-08
title: Externe Docker-Container (bzw. ihre Funktionen) nahtlos als Tessera-Module einbinden
area: modules/integrations
severity: enhancement
trigger: Idee festgehalten auf Wunsch des Users (08.10.2026). Noch nicht beauftragt — erst
  aufgreifen, wenn der User es nennt oder nach den laufenden Punkten (Modul-Changelog,
  Doku-Nacharbeit, Sicherheitsprotokoll/CI-Scanner, Dateien Etappe 2) nach Ideen fragt.
---

## Wunsch (Worte des Users)

> „Ein ‚eigenes Modul‘, welches externe Docker, bzw. deren Funktion in Tessera einbindet.
> Nahtlos im Idealfall. Bei der Auswahl beschränken wir uns auf Container, bei denen das
> 100 % umsetzbar ist. Sei es API oder sonst etwas.“

## Gedanken zur Umsetzung (noch nicht entschieden)

- **Nicht als iFrame**, sondern wie bei „Dateien“ (Nextcloud) als eigene Oberfläche in
  Tessera, die über die Schnittstelle (API) des Containers arbeitet.
- **Nur Container mit vollständiger, stabiler API** und sauberer Anmeldung (API-Schlüssel,
  App-Passwort o. ä.), sodass sich die Funktion ohne Bruch in Tessera abbilden lässt.
- Mögliches gemeinsames Gerüst: Adresse + Zugang je Integration (Administrator),
  verschlüsselt gespeichert, Verbindungstest, gemeinsamer HTTP-Client mit
  SSRF-Eingrenzung und Sperr-/Fehlerbehandlung (Muster aus `nextcloud-files`), dann je
  Container eine schlanke, spezifische Oberfläche.
- Auswahl der Kandidaten gemeinsam mit dem User: Kriterien = echter Nutzen für die Firma,
  API deckt die gewünschten Funktionen zu 100 % ab, aktiv gepflegt, selbst gehostet.
- **Nicht vorschlagen:** Stirling-PDF (am 25.09.2026 nach Probelauf verworfen).