Instellingen van het platform
De beheeronderdelen van het platform, één voor één: processen, limieten, antivirus, e-mail, alarmen, OpenTelemetry, kunstmatige intelligentie, authenticatie van de apps, mobiele app, sjablonen, ongebruikte bestanden, installatie en open source.
De Instellingen vormen het bedieningspaneel van de hele installatie. Het zijn niet de instellingen van een app — die leven binnen elke app en reizen met haar mee. Hier beslist u wat het platform vanzelf doet, waar het de waarschuwingen naartoe stuurt, vanaf welke waarden het zich zorgen maakt, en hoe lang een sessie duurt.
U opent ze via het item Instellingen, onderaan de zijbalk. Alleen accounts met een beheerdersprofiel komen daar binnen.
De onderdelen staan in een navigatie links, per groep: Platform, Waarschuwingen, Observability, Kunstmatige intelligentie, Apps, Installatie en Over. Er opent één onderdeel tegelijk, en het adres verandert mee, zodat de terugknop van de browser naar het vorige onderdeel gaat. De groep Installatie verschijnt alleen in een installatie met één organisatie. Op een smal scherm wordt de navigatie een keuzelijst boven het onderdeel.

Opmerking
Elk onderdeel heeft een eigen knop Opslaan, in de kop, die alleen dat onderdeel opslaat. Wie van onderdeel wisselt zonder op te slaan, verliest wat daar was ingevuld.
Processen
Het onderdeel Processen zet aan en uit wat vanzelf draait terwijl niemand kijkt. Het zijn drie onafhankelijke schakelaars:
| Schakelaar | Wat er gebeurt wanneer die aanstaat | Wat u verliest wanneer u die uitzet |
|---|---|---|
| Planner | Voert de planningen, de geplande rapporten en de tijdklokken van de workflows uit. | Er wordt niets verwijderd: de geplande tijden draaien alleen niet totdat u hem weer aanzet. |
| Index van Observability | Brengt wat de apps vastleggen naar de centrale index en past de bewaartermijnen van elke app toe. | De schermen van de Radar tonen oude gegevens en de registraties blijven voor altijd bewaard. |
| Meldingen in real time | De meldingen komen op het moment zelf op het scherm van wie aan het werk is. | De meldingen worden nog steeds aangemaakt en afgeleverd — maar ze verschijnen pas bij het volgende bezoek. |
De schakelaar voor de waarschuwingen per e-mail staat in het onderdeel Alarmen.
Elke schakelaar werkt zodra u op Opslaan klikt, zonder de server opnieuw te starten: wat u inschakelt, start op dat moment, en uitgeschakelde realtime meldingen sluiten meteen.

Let op
De Planner uitzetten is oorzaak nummer één van "mijn scripts draaien niet meer". Lijkt een planning dood, controleer dan deze schakelaar voordat u het script onderzoekt. Hetzelfde geldt voor geplande rapporten en voor wachtstappen in workflows — die hangen allemaal van dezelfde motor af.
Antivirus
Het onderdeel Antivirus koppelt het platform via ICAP aan een antivirus, zodat de bestanden die in de apps terechtkomen worden gecontroleerd voordat ze worden opgeslagen, en toont de bestanden in quarantaine. Het wordt uitgelegd in Antivirus.
Hierlangs stuurt het platform zijn eigen alarmen — niet te verwarren met de e-mail die elke app naar haar gebruikers stuurt, die in de meldingskanalen van de app wordt ingesteld.
Vul in:
- Server en Poort van de e-maildienst.
- Beveiliging — SSL/TLS versleutelt vanaf het begin van de verbinding (poort 465); STARTTLS als de server het aanbiedt opent de verbinding zonder versleuteling en schakelt over op TLS als de server het aanbiedt (poort 587); Geen versleutelt nooit, voor interne servers zonder TLS (poort 25). Zonder gebruiker en wachtwoord verzendt het zonder aanmelding.
- Gebruiker en Wachtwoord van het verzendaccount. Het wachtwoord typt u één keer en het komt nooit terug op het scherm: het veld zegt voortaan dat het is ingesteld, en het leeg laten betekent "niet aankomen", nooit "verwijderen".
- Afzender — het adres dat verschijnt bij wie de e-mail ontvangt.
- Ontvangers: adressen, gescheiden door komma's, die alle alarmen ontvangen. Leeg waarschuwt elke app de personen die eraan zijn toegewezen, en apps zonder toegewezen personen en het platform waarschuwen de actieve beheerders.

Alarmen
Het onderdeel Alarmen bepaalt of het platform per e-mail waarschuwt en vanaf welke waarden.
De schakelaar Waarschuwingen per e-mail, bovenaan, zet de waarschuwingen aan. Staat hij uit, dan wordt niemand gewaarschuwd en ontdekt u de problemen pas wanneer u de Radar opent. De waarschuwingen gaan uit via de server van het onderdeel E-mail.
Een nieuw probleem in een gepubliceerde app, of een opgelost probleem dat opnieuw optreedt, waarschuwt altijd, zonder drempel. Wat elke waarschuwing veroorzaakt en wat de e-mail zegt, staat in Waarschuwingen per e-mail.
De Drempels vertellen het platform wat normaal is en wat een e-mail verdient. Ze worden allemaal beoordeeld binnen het venster dat aan het einde van de sectie is vastgelegd.
| Waarde | Wat die betekent |
|---|---|
| Serverfouten in de API's (%) | Percentage verzoeken dat op de server mislukt (5xx) waarboven een alarm voor een algemene storing opent, met minstens 5 fouten in het venster. Weigeringen, geannuleerde verzoeken en validatiefouten tellen niet mee. |
| Minimum aantal verzoeken | Onder dit aantal verzoeken telt het percentage niet mee. Eén fout op drie verzoeken is 33% en zegt niets. |
| Mislukte scripts | Hoeveel mislukte uitvoeringen een alarm openen. |
| Achterstand van de wachtrij (s) | Hoe lang het achtergrondwerk mag achterlopen voordat het als achterstallig geldt. |
| Vrije schijfruimte (%) | Onder dit percentage wordt er gewaarschuwd. |
| Venster (min) | De periode waarover alles hierboven wordt geteld. |
Tip
Verhoog op een installatie met weinig verkeer het Minimum aantal verzoeken. Dat is het veld dat valse alarmen voorkomt in apps die alleen 's ochtends worden gebruikt.
Limieten
Twee instellingen die voor het hele platform gelden:
- Duur van de sessie (u) — hoe lang een sessie duurt zonder activiteit. Terwijl er wordt gewerkt, vernieuwt de sessie zichzelf; alleen langdurige inactiviteit dwingt tot opnieuw aanmelden.
- Maximaal bestand (MB) — de maximale omvang van een bestand dat in welke app van de installatie dan ook wordt geüpload. Het geldt ook voor bestanden die naar de assets van een app worden geüpload. Het gaat tot 100 MB. Het importeren van apps hangt niet af van deze waarde: het accepteert pakketten tot 1 GB (zie Apps importeren en exporteren).
OpenTelemetry
Het onderdeel OpenTelemetry, in de groep Observability, stuurt wat er in de apps gebeurt naar de OpenTelemetry-server van het bedrijf, via OTLP over HTTP in JSON. De Radar blijft werken zoals voorheen: het versturen is een kopie.
- Typ bij Adres het basisadres van OTLP over HTTP, bijvoorbeeld
https://otel.empresa.pt:4318. Keplin voegt/v1/tracesen/v1/logstoe. - Optioneel: klik bij Headers op Header toevoegen en typ de
Naam en de Waarde van de authenticatieheaders van de dienst,
bijvoorbeeld
Authorizationofx-api-key. De waarden worden versleuteld bewaard en verschijnen niet meer; leeg blijft de opgeslagen waarde. - Kies bij Wat versturen:
- API-aanroepen en scriptuitvoeringen, als traces, met de trace- en span-ID's die Keplin al gebruikt;
- Radar-fouten, als logs, met het type, het bericht en de stacktrace van de fout, gekoppeld aan de trace;
- Audit, als logs: wie wat op het platform heeft gewijzigd, zonder het ervoor en erna;
- Browseractiviteit, als traces: de geopende schermen, de klikken en de leesacties. Dat is veel: schakel het alleen in als de dienst het aankan.
- Klik op Verbinding testen. De test slaagt als de server een testverzending accepteert.
- Schakel Naar OpenTelemetry sturen in en klik op Opslaan.

Het versturen begint op het moment van inschakelen, zonder de geschiedenis. De gegevens van de verzoeken en de antwoorden worden nooit verstuurd. De Status toont het tijdstip van de laatste verzending en hoeveel spans en logs sinds het starten van de server zijn verstuurd, en de laatste fout, als die recenter is dan de laatste verzending.
Openbaar adres
Het Openbaar adres is het adres waarmee mensen het platform openen,
bijvoorbeeld https://platform.voorbeeld.nl. Het staat in de links van
e-mails, zoals de link om het wachtwoord van app-accounts te herstellen. Het
onderdeel staat in de groep Installatie, die alleen verschijnt in een
installatie met één tenant; in multitenant geldt het adres van elke tenant.
Het wordt ingevuld bij de eerste aanmelding van een beheerder, met het adres waarmee die zich aanmeldde. Als dat niet het adres is dat mensen gebruiken (bijvoorbeeld als de beheerder zich via het IP van het interne netwerk aanmeldde), corrigeer het en klik op Opslaan.
Zonder Openbaar adres werkt wachtwoordherstel alleen voor apps die op een eigen domein zijn gepubliceerd. Het adres dat met een verzoek meekomt, wordt nooit voor de link gebruikt, omdat degene die het verzoek doet het kiest.
De PostgreSQL-server van het platform
Voor interne PostgreSQL-datasources (zie Databases verbinden) heeft de installatie een PostgreSQL-server nodig waar het platform de databases maakt. De configuratie is van de installatie, niet van een app: in een installatie voor één organisatie staat ze in de Instellingen, in het onderdeel Beheerde PostgreSQL van de groep Installatie; in een installatie met meerdere klanten staat ze in de backoffice van de installatie. Vul het adres, de poort, het beheeraccount en de limiet van databases per klant in, sla op en gebruik Server testen om te bevestigen dat het platform databases op die server kan maken. Zolang die niet geconfigureerd is, is de optie PostgreSQL in het tabblad Intern uitgeschakeld bij het maken van een datasource.
Browserengine
De schermafbeeldingen die agents via MCP vragen en de schermtests (zie Het testproject) gebruiken een browser zonder scherm die op de server draait. Er is er maar één voor de hele installatie, in een apart proces en met lage prioriteit: als de machine krap zit, geeft de browser toe, niet de verzoeken van de apps.
Het onderdeel Browserengine, in de groep Installatie (in een installatie met meerdere klanten, in de backoffice van de installatie), toont de Status (actief, of gesloten tot de volgende taak), of Chromium is geïnstalleerd, de actieve en wachtende Taken, het vrije Geheugen en de Laatste fout. Het bevat ook de limieten die de server beschermen:
| Limiet | Wat hij doet |
|---|---|
| Gelijktijdige taken | Hoeveel pagina's tegelijk open zijn. Meer pagina's, meer geheugen en CPU. |
| Verzoeken in de wachtrij | Met een volle wachtrij wordt een nieuw verzoek meteen geweigerd, met de reden. |
| Minuten inactief tot sluiten | Gesloten gebruikt de browser geen geheugen; de volgende taak opent hem weer. |
| Minimaal vrij geheugen (MB) | Daaronder opent geen nieuwe pagina. 0 schakelt de bewaking uit. |
Browser nu sluiten geeft het geheugen meteen terug. Ontbreekt Chromium, dan downloadt Chromium installeren het; de installatie en de updates van het platform installeren het al en controleren dat het start.
Het platform bijwerken
Waar en hoe je bijwerkt hangt af van de modus van de installatie:
- Installatie voor één organisatie: er is geen bijwerken via de interface. Het onderdeel Updates van de Instellingen toont de Geïnstalleerde versie: en de opdracht om in de serverconsole uit te voeren met de zip van de nieuwe versie, met een knop om die te kopiëren. Het installatieprogramma behoudt de instellingen en de gegevens en voert de migraties uit; om terug te gaan naar een eerdere versie installeer je de zip van die versie.
- Installatie met meerdere klanten: het bijwerken gebeurt in de backoffice van de installatie, onder Updates, en dat is het scherm dat de rest van deze sectie beschrijft. De Instellingen van elke klant hebben geen updates.
De updatesectie toont de geïnstalleerde versie en de lijst met beschikbare versies. Het proces heeft met opzet twee knoppen:
- Voorbereiden — haalt de gekozen versie op en bereidt haar voor zonder iets aan te raken van wat er draait. Het platform blijft werken.
- Wanneer de voorbereiding klaar is, verschijnt het plan: hoeveel databases er gemigreerd worden, welke bestanden van apps herschreven worden en in hoeveel versies, plus de melding dat de databases gekopieerd worden voordat er ergens aan wordt gekomen.
- Deze update toepassen — pas nadat u het plan gelezen hebt. Het platform is tijdens het opnieuw opstarten niet beschikbaar en komt terug in de nieuwe versie.

Opmerking
Heeft een app wijzigingen op schijf die nog niet in de geschiedenis staan, dan zegt het plan dat en slaat de update ze eerst op, in een aparte vermelding, voordat de bestanden opnieuw worden geschreven. Bestanden die het platform zelf schrijft, zoals de kopieën van scriptafhankelijkheden die een planning maakt, tellen niet mee.
Gaat er halverwege iets mis, dan wordt de vorige versie automatisch teruggezet en zegt het scherm dat — inclusief de registratie van wat er mislukt is.
Het terugzetten brengt de databases en ook de bestanden van de apps die de migraties hadden herschreven terug naar de toestand van vóór de update.
Servercontrole
Op het scherm van de updates toont het blok Servercontrole of de machine heeft wat de scripts van de apps, de schermafbeeldingen en de schermtests nodig hebben: Chromium, de isolatie van de scripts, de netwerkregels van de scripts en de processen van het platform die met de gebruiker van de installatie draaien. De controle draait aan het einde van de installatie, aan het einde van elke update en bij het starten van de server; Nu controleren voert haar op verzoek uit.
De samenvatting zegt „Alles is in orde.”, hoeveel waarschuwingen er zijn, of hoeveel problemen nog moeten worden opgelost. Elk probleem noemt wat er misgaat en toont de opdracht die het oplost, uit te voeren als root in de console van de server.
Kunstmatige intelligentie
De groep Kunstmatige intelligentie bevat het onderdeel Providers: de AI-diensten van de tenant die de scripts van de apps kunnen gebruiken, met de inloggegevens en de toegestane modellen. Zie AI-providers.
Authenticatie van de apps
Het onderdeel Authenticatie van de apps, in de groep Apps, registreert de providers waarmee de gebruikers van de apps zich kunnen aanmelden: Microsoft Entra ID, Google, een OpenID Connect- of OAuth 2.0-dienst en, in een installatie met één tenant, Active Directory. Het wordt uitgelegd in Aanmelden met authenticatieproviders.
Mobiele app
Het onderdeel Mobiele app bedient de Android-app waarmee men de apps van dit platform binnenkomt. Zij heeft twee bestanden om te downloaden en één QR-code per app — dat wordt uitgebreid uitgelegd in het hoofdstuk Mobiele app.

Sjablonen
Het onderdeel Sjablonen, in de groep Apps, toont de sjablonen van dit platform: de sjablonen die in de apps met Opslaan als sjabloon zijn opgeslagen (zie App-sjablonen). Systeemsjablonen horen bij de installatie en verschijnen hier niet.
Elke rij toont de naam, de versie, de beschrijving, de app waar het sjabloon vandaan komt, de datum waarop het is opgeslagen en de grootte. Bij elk sjabloon:
- Downloaden downloadt het bestand
.keplintemplate, om het naar een andere installatie te brengen. - Het prullenbakpictogram verwijdert het sjabloon. De bevestiging verschijnt in de rij zelf: klik op Verwijderen om te bevestigen, of op Annuleren. Het sjabloon verdwijnt uit de galerie van Nieuwe app, en de apps die er al uit zijn gemaakt, veranderen niet.

Ongebruikte bestanden
De bestanden die in de apps zijn geüpload, verdwijnen niet vanzelf: niet als het record dat ze had wordt verwijderd, niet als een bijlage wordt vervangen, niet als een formulier halverwege blijft. Het onderdeel Ongebruikte bestanden vindt ze en laat u kiezen wat weg mag. Er wordt niets vanzelf verwijderd.
- Klik in de koptekst op Ongebruikte bestanden zoeken. Het zoeken draait op de achtergrond op de server: u kunt de pagina verlaten en terugkomen, en het gaat door.
- Tijdens het zoeken toont de pagina de voortgang (bijvoorbeeld „3 van 12 apps”) en wat er wordt gelezen. Elke app verschijnt zodra ze klaar is, met de bestanden die geen bekende verwijzing gebruikt: naam, grootte, uploaddatum en versies. Het pictogram naast de naam downloadt het bestand, zodat u kunt controleren wat het is.
- Kies de bestanden en klik op Geselecteerde verwijderen. De pagina vraagt om bevestiging; vóór het verwijderen controleert het platform de gekozen bestanden opnieuw, en een bestand dat intussen wordt gebruikt, blijft staan.

Het resultaat blijft bewaard: als u terugkomt bij het onderdeel, verschijnt de laatste zoekactie, met de datum en hoe lang ze duurde. Opnieuw zoeken herhaalt de zoekactie in alle apps, en In deze app zoeken, in de koptekst van een app, alleen in die app. Zoeken annuleren stopt een lopende zoekactie. Als de server halverwege opnieuw start, zegt de pagina dat de laatste zoekactie halverwege is gebleven. Tijd per bron toont hoe lang het lezen van elke database duurde, om te begrijpen waar de tijd van een trage zoekactie blijft.
Een bestand telt als gebruikt als zijn token voorkomt in het ontwerp van de app, in de SQLite-databases van de app (inclusief processen en meldingen) of in een tekstkolom van een tabel van het model, in welke versie dan ook. Alleen-lezen-datasources worden niet gelezen, omdat Keplin er nooit in schrijft. Een tabel buiten het model of een extern systeem wordt niet gezien: controleer vóór het verwijderen. Bestanden van de laatste 24 uur tellen niet mee, en een app met een database die niet kan worden gelezen, blijft buiten de lijst.
Let op
Een verwijderd bestand komt niet terug. De bytes verlaten de opslag van de app en het bestand verlaat het register van alle versies.
Open source
Het onderdeel Open source toont de opensourcebibliotheken die in het platform zijn geïnstalleerd, met de versie en de licentie van elke bibliotheek. De naam van elke bibliotheek opent de pagina van het project. Typ in het zoekveld om de lijst op naam of licentie te filteren.
Veelgestelde vragen
Ik heb een drempel gewijzigd en niets ontvangen. De alarmen worden alleen van minuut tot minuut beoordeeld en uitsluitend binnen het vastgelegde venster. Controleer ook of de schakelaar Waarschuwingen per e-mail in het onderdeel Alarmen aanstaat, en of de server in het onderdeel E-mail is ingevuld.
Kan ik verschillende e-mailservers per app hebben? Ja — en dat is het normale geval. De e-mail op deze pagina is alleen die van de waarschuwingen van het platform; elke app stelt haar eigen kanalen in haar eigen instellingen in.
Wie kan deze pagina zien? Alleen accounts met een beheerdersprofiel. Een developer ziet haar niet in de zijbalk en komt er ook niet in via een direct adres.