Einstellungen der Plattform
Die Verwaltungsbereiche der Plattform, einer nach dem anderen: Prozesse, Grenzen, Virenschutz, E-Mail, Alarme, OpenTelemetry, künstliche Intelligenz, Authentifizierung der Apps, Mobile App, Vorlagen, unbenutzte Dateien, Installation und Open Source.
Die Einstellungen sind das Kontrollpanel der gesamten Installation. Sie sind nicht die Einstellungen einer App — die leben in jeder App und reisen mit ihr. Hier wird entschieden, was die Plattform von allein tut, wohin sie die Warnungen schickt, ab welchen Werten sie sich Sorgen macht und wie lange eine Sitzung dauert.
Geöffnet werden sie über den Punkt Einstellungen, unten in der Seitenleiste. Nur Konten mit Administratorprofil kommen dort hinein.
Die Bereiche stehen in einer Navigation links, nach Gruppen: Plattform, Warnungen, Observability, Künstliche Intelligenz, Apps, Installation und Über. Es öffnet sich jeweils ein Bereich, und die Adresse ändert sich mit ihm, sodass die Zurück-Schaltfläche des Browsers zum vorherigen Bereich führt. Die Gruppe Installation erscheint nur in einer Installation mit einer einzigen Organisation. Auf einem schmalen Bildschirm wird die Navigation zu einer Auswahlliste über dem Bereich.

Hinweis
Jeder Bereich hat seinen eigenen Button Speichern in der Kopfzeile, und er speichert nur diesen Bereich. Wer den Bereich ohne Speichern wechselt, verliert, was dort eingegeben wurde.
Prozesse
Der Bereich Prozesse schaltet ein und aus, was von allein läuft, während niemand hinsieht. Es sind drei unabhängige Schalter:
| Schalter | Was passiert, wenn er eingeschaltet ist | Was Sie verlieren, wenn Sie ihn ausschalten |
|---|---|---|
| Scheduler | Führt die Zeitpläne, die geplanten Berichte und die Timer der Workflows aus. | Nichts wird gelöscht: Die vereinbarten Zeiten laufen einfach nicht, bis er wieder eingeschaltet wird. |
| Index der Observability | Bringt das, was die Apps aufzeichnen, in den zentralen Index und wendet die Aufbewahrungsfristen jeder App an. | Die Bildschirme des Radars zeigen alte Daten und die Einträge werden für immer aufbewahrt. |
| Benachrichtigungen in Echtzeit | Die Benachrichtigungen erreichen den Bildschirm derer, die gerade arbeiten, im Moment. | Die Benachrichtigungen werden weiterhin erstellt und zugestellt — aber sie erscheinen erst beim nächsten Besuch. |
Der Schalter für die Warnungen per E-Mail liegt im Bereich Alarme.
Jeder Schalter wirkt, sobald Sie auf Speichern klicken, ohne den Server neu zu starten: Was Sie einschalten, startet in diesem Moment, und ausgeschaltete Echtzeit-Benachrichtigungen schließen sofort.

Achtung
Den Scheduler auszuschalten ist die Ursache Nummer eins von „meine Skripte laufen nicht mehr“. Wenn ein Zeitplan tot scheint, prüfen Sie diesen Schalter, bevor Sie das Skript untersuchen. Dasselbe gilt für geplante Berichte und für Warteschritte in Workflows — sie hängen alle vom selben Motor ab.
Virenschutz
Der Bereich Virenschutz verbindet die Plattform über ICAP mit einem Virenschutz, damit die Dateien, die in die Apps gelangen, vor dem Speichern geprüft werden, und zeigt die Dateien in Quarantäne. Er ist in Virenschutz erklärt.
Hierüber verschickt die Plattform ihre Alarme — nicht zu verwechseln mit der E-Mail, die jede App an ihre Benutzer schickt und die in den Benachrichtigungskanälen der App konfiguriert wird.
Füllen Sie aus:
- Server und Port des E-Mail-Dienstes.
- Sicherheit — SSL/TLS verschlüsselt ab Beginn der Verbindung (Port 465); STARTTLS, wenn der Server es anbietet öffnet die Verbindung unverschlüsselt und wechselt zu TLS, wenn der Server es anbietet (Port 587); Keine verschlüsselt nie, für interne Server ohne TLS (Port 25). Ohne Benutzer und Passwort meldet sich der Versand nicht an.
- Benutzer und Passwort des Versandkontos. Das Passwort schreibt man einmal und es kehrt nie auf den Bildschirm zurück: Das Feld sagt fortan, dass es festgelegt ist, und es leer zu lassen bedeutet „nicht anfassen“, niemals „löschen“.
- Absender — die Adresse, die bei den Empfängern erscheint.
- Empfänger: Adressen, durch Kommas getrennt, die alle Alarme erhalten. Leer warnt jede App die ihr zugewiesenen Personen, und Apps ohne zugewiesene Personen sowie die Plattform warnen die aktiven Administratoren.

Alarme
Der Bereich Alarme legt fest, ob die Plattform per E-Mail warnt und ab welchen Werten.
Der Schalter Warnungen per E-Mail oben schaltet die Warnungen ein. Ist er aus, wird niemand benachrichtigt, und die Probleme entdeckt man erst beim Öffnen des Radars. Die Warnungen gehen über den Server des Bereichs E-Mail hinaus.
Ein neues Problem in einer veröffentlichten App oder ein behobenes Problem, das erneut auftritt, löst immer eine Warnung aus, ohne Grenzwert. Was jede Warnung auslöst und was die E-Mail sagt, steht unter Warnungen per E-Mail.
Die Schwellenwerte sagen der Plattform, was normal ist und was eine E-Mail verdient. Alle werden innerhalb des Fensters ausgewertet, das am Ende des Abschnitts definiert wird.
| Wert | Was er bedeutet |
|---|---|
| Serverfehler der APIs (%) | Anteil der Anfragen, die auf dem Server fehlschlagen (5xx), ab dem ein Alarm wegen eines flächendeckenden Ausfalls geöffnet wird, mit mindestens 5 Fehlern im Zeitfenster. Ablehnungen, abgebrochene Anfragen und Validierungsfehler zählen nicht. |
| Mindestanzahl Anfragen | Unterhalb dieser Zahl von Anfragen zählt der Prozentsatz nicht. Ein Fehler bei drei Anfragen sind 33 % und bedeutet gar nichts. |
| Fehlgeschlagene Skripte | Wie viele fehlgeschlagene Ausführungen einen Alarm öffnen. |
| Verzögerung der Warteschlange (s) | Wie lange die Arbeit im Hintergrund zurückbleiben darf, bevor sie als verzögert gilt. |
| Freier Speicherplatz (%) | Unterhalb dieses Prozentsatzes wird gewarnt. |
| Fenster (Min.) | Der Zeitraum, in dem alles darüber gezählt wird. |
Tipp
In einer Installation mit wenig Verkehr erhöhen Sie die Mindestanzahl Anfragen. Es ist das Feld, das Fehlalarme in Apps verhindert, die nur morgens benutzt werden.
Grenzwerte
Zwei Einstellungen, die für die gesamte Plattform gelten:
- Dauer der Sitzung (h) — wie lange eine Sitzung ohne Aktivität dauert. Solange gearbeitet wird, verlängert sich die Sitzung von selbst; nur längere Inaktivität zwingt dazu, sich neu anzumelden.
- Maximale Datei (MB) — die maximale Größe einer hochgeladenen Datei in jeder App der Installation. Sie gilt auch für Dateien, die in die Assets einer App hochgeladen werden. Sie reicht bis 100 MB. Der Import von Apps hängt nicht von diesem Wert ab: Er nimmt Pakete bis 1 GB an (siehe Apps importieren und exportieren).
OpenTelemetry
Der Bereich OpenTelemetry in der Gruppe Observability sendet, was in den Apps passiert, an den OpenTelemetry-Server des Unternehmens, über OTLP per HTTP in JSON. Das Radar arbeitet weiter wie bisher: Das Senden ist eine Kopie.
- Geben Sie unter Endpunkt die Basisadresse von OTLP per HTTP ein, zum
Beispiel
https://otel.empresa.pt:4318. Keplin hängt/v1/tracesund/v1/logsan. - Optional: Klicken Sie unter Header auf Header hinzufügen und geben
Sie Name und Wert der Authentifizierungs-Header des Dienstes ein,
zum Beispiel
Authorizationoderx-api-key. Die Werte werden verschlüsselt gespeichert und erscheinen nicht wieder; leer bleibt der gespeicherte Wert. - Wählen Sie unter Was gesendet wird:
- API-Aufrufe und Skriptausführungen, als Traces, mit den Trace- und Span-IDs, die Keplin bereits verwendet;
- Radar-Fehler, als Logs, mit dem Typ, der Meldung und dem Stacktrace des Fehlers, mit dem Trace verknüpft;
- Audit, als Logs: wer was auf der Plattform geändert hat, ohne Vorher und Nachher;
- Browser-Aktivität, als Traces: die geöffneten Bildschirme, die Klicks und die Lesevorgänge. Das ist viel: Schalten Sie es nur ein, wenn der Dienst es verkraftet.
- Klicken Sie auf Verbindung testen. Der Test ist bestanden, wenn der Server eine Testsendung annimmt.
- Schalten Sie An OpenTelemetry senden ein und klicken Sie auf Speichern.

Das Senden beginnt im Moment des Einschaltens, ohne die Historie. Die Daten der Anfragen und Antworten werden nie gesendet. Der Status zeigt die Zeit des letzten Sendens und wie viele Spans und Logs seit dem Serverstart hinausgegangen sind, sowie den letzten Fehler, wenn er neuer ist als das letzte Senden.
Öffentliche Adresse
Die Öffentliche Adresse ist die Adresse, über die Personen die Plattform
öffnen, zum Beispiel https://plattform.beispiel.de. Sie steht in den Links
der E-Mails, zum Beispiel im Link zur Passwortwiederherstellung der
App-Konten. Der Bereich liegt in der Gruppe Installation, die nur in
einer Installation mit einem einzigen Tenant erscheint; in Multitenant gilt
die Adresse jedes Tenants.
Sie wird bei der ersten Anmeldung eines Administrators ausgefüllt, mit der Adresse, über die er sich angemeldet hat. Wenn das nicht die Adresse ist, die Personen verwenden (zum Beispiel, wenn sich der Administrator über die IP des internen Netzes angemeldet hat), korrigieren Sie sie und klicken Sie auf Speichern.
Ohne Öffentliche Adresse funktioniert die Passwortwiederherstellung nur für Apps, die auf einer eigenen Domain veröffentlicht sind. Die Adresse, die mit einer Anfrage kommt, wird nie für den Link verwendet, weil sie von dem gewählt wird, der die Anfrage stellt.
Der PostgreSQL-Server der Plattform
Für interne PostgreSQL-Datenquellen (siehe Datenbanken verbinden) braucht die Installation einen PostgreSQL-Server, auf dem die Plattform die Datenbanken anlegt. Die Konfiguration gehört zur Installation, nicht zu einer App: In einer Installation für eine einzelne Organisation liegt sie in den Einstellungen im Bereich Verwaltetes PostgreSQL der Gruppe Installation; in einer Installation mit mehreren Kunden im Backoffice der Installation. Tragen Sie Adresse, Port, Administrationskonto und das Limit an Datenbanken pro Kunde ein, speichern Sie und prüfen Sie mit Server testen, dass die Plattform auf diesem Server Datenbanken anlegen kann. Bis zur Konfiguration ist die Option PostgreSQL im Tab Intern beim Anlegen einer Datenquelle deaktiviert.
Browser-Engine
Die Bildschirmfotos, die Agenten über MCP anfordern, und die Bildschirmtests (siehe Das Testprojekt) verwenden einen Browser ohne Bildschirm, der auf dem Server läuft. Es gibt nur einen für die ganze Installation, in einem eigenen Prozess und mit niedriger Priorität: Wenn die Maschine knapp wird, gibt der Browser nach, nicht die Anfragen der Apps.
Der Bereich Browser-Engine in der Gruppe Installation (in einer Installation mit mehreren Kunden im Backoffice der Installation) zeigt den Zustand (läuft, oder geschlossen bis zum nächsten Auftrag), ob Chromium installiert ist, die laufenden und wartenden Aufträge, den freien Speicher und den Letzten Fehler. Außerdem enthält er die Grenzen, die den Server schützen:
| Grenze | Was sie bewirkt |
|---|---|
| Gleichzeitige Aufträge | Wie viele Seiten gleichzeitig offen sind. Mehr Seiten, mehr Speicher und CPU. |
| Anfragen in der Warteschlange | Ist die Warteschlange voll, wird eine neue Anfrage sofort abgelehnt, mit dem Grund. |
| Untätige Minuten bis zum Schließen | Geschlossen belegt der Browser keinen Speicher; der nächste Auftrag öffnet ihn wieder. |
| Mindestens freier Speicher (MB) | Darunter öffnet sich keine neue Seite. 0 schaltet den Schutz aus. |
Browser jetzt schließen gibt den Speicher sofort frei. Fehlt Chromium, lädt Chromium installieren es herunter; die Installation und die Aktualisierungen der Plattform installieren es bereits und prüfen, dass es startet.
Die Plattform aktualisieren
Wo und wie aktualisiert wird, hängt vom Modus der Installation ab:
- Installation für eine einzelne Organisation: keine Aktualisierung über die Oberfläche. Der Bereich Aktualisierungen der Einstellungen zeigt die Installierte Version: und den Befehl, der in der Serverkonsole mit dem Zip der neuen Version auszuführen ist, mit einer Schaltfläche zum Kopieren. Der Installer behält Einstellungen und Daten und führt die Migrationen aus; um zu einer früheren Version zurückzukehren, installiert man das Zip dieser Version.
- Installation mit mehreren Kunden: Die Aktualisierung erfolgt im Backoffice der Installation unter Aktualisierungen, und diesen Bildschirm beschreibt der Rest dieses Abschnitts. Die Einstellungen der einzelnen Kunden haben keine Aktualisierungen.
Der Update-Abschnitt zeigt die installierte Version und die Liste der verfügbaren Versionen. Der Prozess hat absichtlich zwei Buttons:
- Vorbereiten — holt die gewählte Version und bereitet sie vor, ohne irgendetwas von dem anzufassen, was gerade ausgeliefert wird. Die Plattform funktioniert weiter.
- Wenn die Vorbereitung endet, erscheint der Plan: wie viele Datenbanken migriert werden, welche App-Dateien neu geschrieben werden und in wie vielen Versionen, dazu der Hinweis, dass die Datenbanken kopiert werden, bevor irgendetwas angefasst wird.
- Dieses Update anwenden — erst, nachdem Sie den Plan gelesen haben. Die Plattform ist während des Neustarts nicht verfügbar und kommt in der neuen Version zurück.

Hinweis
Hat eine App Änderungen auf der Festplatte, die noch nicht im Verlauf stehen, sagt es der Plan, und das Update speichert sie zuerst in einem eigenen Eintrag, bevor es die Dateien neu schreibt. Dateien, die die Plattform selbst schreibt, etwa die Kopien der Skriptabhängigkeiten, die ein Zeitplan anlegt, zählen nicht.
Geht mittendrin etwas schief, wird die vorherige Version automatisch wiederhergestellt und der Bildschirm sagt es — einschließlich des Protokolls dessen, was fehlgeschlagen ist.
Die Wiederherstellung bringt die Datenbanken und auch die Dateien der Apps, die die Migrationen umgeschrieben hatten, auf den Stand vor dem Update zurück.
Serverprüfung
Auf dem Bildschirm der Updates zeigt der Block Serverprüfung, ob die Maschine hat, was die Skripte der Apps, die Bildschirmaufnahmen und die Bildschirmtests brauchen: Chromium, die Isolierung der Skripte, die Netzwerkregeln der Skripte und die Prozesse der Plattform, die mit dem Benutzer der Installation laufen. Die Prüfung läuft am Ende der Installation, am Ende jedes Updates und beim Serverstart; Jetzt prüfen führt sie auf Anforderung aus.
Die Zusammenfassung sagt „Alles in Ordnung.“, wie viele Warnungen es gibt, oder wie viele Probleme noch zu lösen sind. Jedes Problem nennt, was nicht funktioniert, und zeigt den Befehl, der es löst, zur Ausführung als root in der Konsole des Servers.
Künstliche Intelligenz
Die Gruppe Künstliche Intelligenz enthält den Bereich Anbieter: die KI-Dienste des Mandanten, die die Skripte der Apps nutzen können, mit den Zugangsdaten und den zugelassenen Modellen. Siehe KI-Anbieter.
Authentifizierung der Apps
Der Bereich Authentifizierung der Apps in der Gruppe Apps registriert die Anbieter, über die sich die Benutzer der Apps anmelden können: Microsoft Entra ID, Google, einen OpenID-Connect- oder OAuth-2.0-Dienst und, in einer Installation mit einem einzigen Tenant, Active Directory. Er ist in Mit Authentifizierungsanbietern anmelden erklärt.
Mobile App
Der Bereich Mobile App dient der Android-App, mit der man in die Apps dieser Plattform gelangt. Er hat zwei Dateien zum Herunterladen und einen QR-Code pro App — im Detail erklärt im Kapitel Mobile App.

Vorlagen
Der Bereich Vorlagen in der Gruppe Apps listet die Vorlagen dieser Plattform: die in den Apps mit Als Vorlage speichern gespeicherten (siehe App-Vorlagen). Systemvorlagen gehören zur Installation und erscheinen hier nicht.
Jede Zeile zeigt Name, Version, Beschreibung, die App, aus der die Vorlage stammt, das Speicherdatum und die Größe. Bei jeder Vorlage:
- Herunterladen lädt die Datei
.keplintemplateherunter, um sie auf eine andere Installation zu bringen. - Das Papierkorbsymbol löscht die Vorlage. Die Bestätigung erscheint in der Zeile selbst: Klicken Sie zum Bestätigen auf Löschen oder auf Abbrechen. Die Vorlage verschwindet aus der Galerie von Neue App, und die bereits aus ihr erstellten Apps ändern sich nicht.

Unbenutzte Dateien
Die in die Apps hochgeladenen Dateien löschen sich nicht von selbst: weder wenn der Datensatz gelöscht wird, der sie hatte, noch wenn ein Anhang ersetzt wird, noch wenn ein Formular halb ausgefüllt bleibt. Der Bereich Unbenutzte Dateien findet sie und lässt Sie wählen, was entfernt wird. Nichts wird von selbst gelöscht.
- Klicken Sie in der Kopfzeile auf Unbenutzte Dateien suchen. Die Suche läuft im Hintergrund auf dem Server: Sie können die Seite verlassen und zurückkehren, und sie läuft weiter.
- Während der Suche zeigt die Seite den Fortschritt (zum Beispiel „3 von 12 Apps“) und was gerade gelesen wird. Jede App erscheint, sobald sie fertig ist, mit den Dateien, die keine bekannte Referenz verwendet: Name, Größe, Hochladedatum und Versionen. Das Symbol neben dem Namen lädt die Datei herunter, damit Sie prüfen können, was es ist.
- Wählen Sie die Dateien und klicken Sie auf Ausgewählte löschen. Die Seite fragt nach einer Bestätigung; vor dem Löschen prüft die Plattform die gewählten Dateien erneut, und eine Datei, die inzwischen verwendet wird, bleibt.

Das Ergebnis bleibt gespeichert: Wenn Sie zum Bereich zurückkehren, erscheint die letzte Suche mit Datum und Dauer. Erneut suchen wiederholt die Suche in allen Apps, und In dieser App suchen, in der Kopfzeile einer App, nur in dieser. Suche abbrechen stoppt eine laufende Suche. Startet der Server mittendrin neu, sagt die Seite, dass die letzte Suche unvollständig blieb. Zeit pro Quelle zeigt, wie lange das Lesen jeder Datenbank gedauert hat, um zu verstehen, wo die Zeit einer langsamen Suche bleibt.
Eine Datei gilt als verwendet, wenn ihr Token in der Gestaltung der App, in den SQLite-Datenbanken der App (einschließlich Prozesse und Benachrichtigungen) oder in einer Textspalte einer Tabelle des Modells vorkommt, in einer beliebigen Version. Datasources mit Nur-Lese-Zugriff werden nicht gelesen, weil Keplin nie in sie schreibt. Eine Tabelle außerhalb des Modells oder ein externes System werden nicht gesehen: Prüfen Sie vor dem Löschen. Dateien der letzten 24 Stunden zählen nicht mit, und eine App mit einer nicht lesbaren Datenbank bleibt außerhalb der Liste.
Achtung
Eine gelöschte Datei kommt nicht zurück. Die Bytes verlassen den Speicher der App, und die Datei verlässt das Register aller Versionen.
Open Source
Der Bereich Open Source listet die in der Plattform installierten Open-Source-Bibliotheken auf, mit der Version und der Lizenz jeder Bibliothek. Der Name jeder Bibliothek öffnet die Seite des Projekts. Geben Sie etwas in das Suchfeld ein, um die Liste nach Name oder Lizenz zu filtern.
Häufige Fragen
Ich habe einen Grenzwert geändert und nichts erhalten. Die Alarme werden nur im Minutentakt ausgewertet und nur innerhalb des definierten Fensters. Prüfen Sie auch, ob der Schalter Warnungen per E-Mail im Bereich Alarme eingeschaltet ist und ob der Server im Bereich E-Mail ausgefüllt ist.
Kann ich pro App unterschiedliche E-Mail-Server haben? Ja — und das ist der Normalfall. Die E-Mail dieser Seite ist nur die der Warnungen der Plattform; jede App konfiguriert ihre Kanäle in ihren eigenen Einstellungen.
Wer kann diese Seite sehen? Nur Konten mit Administratorprofil. Ein Developer sieht sie weder in der Seitenleiste noch kommt er über die direkte Adresse hinein.