Paramètres de la plateforme
Les sections d'administration de la plateforme, une à la fois : processus, limites, antivirus, e-mail, alertes, OpenTelemetry, intelligence artificielle, authentification des apps, app mobile, modèles, fichiers inutilisés, installation et open source.
Les Paramètres sont le tableau de bord de l'installation entière. Ce ne sont pas les paramètres d'une app — ceux-là vivent dans chaque app et voyagent avec elle. Ici se décide ce que la plateforme fait toute seule, où elle envoie les avertissements, à partir de quelles valeurs elle s'inquiète, et combien de temps dure une session.
Cela s'ouvre par l'élément Paramètres, en bas de la barre latérale. Seuls les comptes ayant un profil administrateur y entrent.
Les sections se trouvent dans une navigation à gauche, par groupes : Plateforme, Avertissements, Observabilité, Intelligence artificielle, Applications, Installation et À propos. Une section s'ouvre à la fois, et l'adresse change avec elle, donc le bouton retour du navigateur ramène à la section précédente. Le groupe Installation n'apparaît que dans une installation d'une seule organisation. Sur un écran étroit, la navigation devient une liste déroulante au-dessus de la section.

Note
Chaque section a son bouton Enregistrer, dans l'en-tête, et n'enregistre que cette section. Changer de section sans enregistrer perd ce qui y était saisi.
Processus
La section Processus active et désactive ce qui s'exécute tout seul pendant que personne ne regarde. Ce sont trois interrupteurs indépendants :
| Interrupteur | Ce qui se passe quand il est activé | Ce que vous perdez en le désactivant |
|---|---|---|
| Planificateur | Exécute les planifications, les rapports planifiés et les minuteurs des workflows. | Rien ne s'efface : les heures prévues ne s'exécutent simplement pas jusqu'à la réactivation. |
| Index d'observabilité | Transfère ce que les apps enregistrent vers l'index central et applique les délais de rétention de chaque app. | Les écrans du Radar affichent des données périmées et les journaux restent conservés pour toujours. |
| Notifications en temps réel | Les notifications arrivent sur l'écran de celui qui travaille, sur le moment. | Les notifications continuent d'être créées et remises — mais elles n'apparaissent qu'à la visite suivante. |
L'interrupteur des avertissements par e-mail se trouve dans la section Alertes.
Chaque interrupteur prend effet quand vous cliquez sur Enregistrer, sans redémarrer le serveur : ce que vous activez démarre à ce moment-là, et les notifications en temps réel désactivées se ferment aussitôt.

Attention
Désactiver le Planificateur est la cause numéro un des « mes scripts ne s'exécutent plus ». Si une planification semble morte, vérifiez cet interrupteur avant d'aller enquêter sur le script. Cela vaut aussi pour les rapports planifiés et pour les étapes d'attente des workflows — ils dépendent tous du même moteur.
Antivirus
La section Antivirus connecte la plateforme à un antivirus via ICAP, pour que les fichiers qui entrent dans les apps soient analysés avant d'être enregistrés, et affiche les fichiers en quarantaine. Elle est expliquée dans Antivirus.
C'est par ici que la plateforme envoie ses alarmes à elle — à ne pas confondre avec l'e-mail que chaque app envoie à ses utilisateurs, qui se configure dans les canaux de notification de l'app.
Remplissez :
- Serveur et Port du service d'e-mail.
- Sécurité — SSL/TLS chiffre dès le début de la connexion (port 465) ; STARTTLS si le serveur le propose ouvre la connexion sans chiffrement et passe en TLS si le serveur le propose (port 587) ; Aucune ne chiffre jamais, pour les serveurs internes sans TLS (port 25). Sans utilisateur ni mot de passe, l'envoi ne s'authentifie pas.
- Utilisateur et Mot de passe du compte d'envoi. Le mot de passe s'écrit une fois et ne revient jamais à l'écran : le champ indique alors qu'il est défini, et le laisser vide signifie « ne pas toucher », jamais « effacer ».
- Expéditeur — l'adresse qui apparaît à celui qui reçoit.
- Destinataires : des adresses, séparées par des virgules, qui reçoivent toutes les alarmes. Vide, chaque app prévient les personnes qui lui sont affectées, et les apps sans personne affectée ainsi que la plateforme préviennent les administrateurs actifs.

Alertes
La section Alertes indique si la plateforme avertit par e-mail et à partir de quelles valeurs.
L'interrupteur Avertissements par e-mail, en haut, active les avertissements. Désactivé, personne n'est prévenu, et les problèmes ne se découvrent qu'en ouvrant le Radar. Les avertissements partent par le serveur de la section E-mail.
Un nouveau problème dans une app publiée, ou un problème résolu qui se reproduit, prévient toujours, sans seuil. Ce qui déclenche chaque alerte et ce que dit l'e-mail se trouve dans Alertes par e-mail.
Les Seuils disent à la plateforme ce qui est normal et ce qui mérite un e-mail. Ils sont tous évalués à l'intérieur de la fenêtre définie en fin de section.
| Valeur | Ce que cela signifie |
|---|---|
| Échecs du serveur dans les API (%) | Pourcentage de requêtes qui échouent sur le serveur (5xx) au-dessus duquel une alarme d'échec généralisé s'ouvre, avec au moins 5 échecs dans la fenêtre. Les refus, les requêtes annulées et les erreurs de validation ne comptent pas. |
| Requêtes minimales | En dessous de ce nombre de requêtes, le pourcentage ne compte pas. Une erreur sur trois requêtes fait 33% et ne veut rien dire. |
| Scripts en échec | Combien d'exécutions échouées déclenchent une alarme. |
| Retard de la file (s) | Combien de temps le travail en arrière-plan peut rester derrière avant d'être considéré en retard. |
| Disque libre (%) | En dessous de ce pourcentage, la plateforme avertit. |
| Fenêtre (min) | La période sur laquelle tout ce qui est au-dessus est compté. |
Astuce
Sur une installation à faible trafic, augmentez les Requêtes minimales. C'est le champ qui évite les fausses alarmes dans les apps qui ne servent que le matin.
Limites
Deux paramètres qui valent pour toute la plateforme :
- Durée de la session (h) — combien de temps une session dure sans activité. Tant que l'on travaille, la session se renouvelle toute seule ; seule une inactivité prolongée oblige à se reconnecter.
- Fichier maximum (Mo) — la taille maximale d'un fichier téléversé dans n'importe quelle app de l'installation. Il vaut aussi pour les fichiers chargés dans les assets d'une app. Elle va jusqu'à 100 Mo. L'importation d'apps ne dépend pas de cette valeur : elle accepte des packages jusqu'à 1 Go (voir Importer et exporter des apps).
OpenTelemetry
La section OpenTelemetry, dans le groupe Observabilité, envoie ce qui se passe dans les apps vers le serveur OpenTelemetry de l'entreprise, en OTLP sur HTTP en JSON. Le Radar continue de fonctionner comme avant : l'envoi est une copie.
- Dans Adresse, saisissez l'adresse de base OTLP sur HTTP, par exemple
https://otel.empresa.pt:4318. Keplin ajoute/v1/traceset/v1/logs. - Facultatif : dans En-têtes, cliquez sur Ajouter un en-tête et
saisissez le Nom et la Valeur des en-têtes d'authentification du
service, par exemple
Authorizationoux-api-key. Les valeurs sont chiffrées et ne réapparaissent pas ; vide, la valeur enregistrée est conservée. - Dans Quoi envoyer, choisissez :
- Appels aux API et exécutions de scripts, comme traces, avec les ids de trace et de span que Keplin utilise déjà ;
- Erreurs du Radar, comme logs, avec le type, le message et la pile d'appels de l'erreur, liés à la trace ;
- Audit, comme logs : qui a changé quoi sur la plateforme, sans l'avant et l'après ;
- Activité dans le navigateur, comme traces : les écrans ouverts, les clics et les lectures. C'est beaucoup : ne l'activez que si le service le supporte.
- Cliquez sur Tester la connexion. Le test réussit quand le serveur accepte un envoi de test.
- Activez Envoyer vers OpenTelemetry et cliquez sur Enregistrer.

L'envoi commence au moment où il est activé, sans l'historique. Les données des requêtes et des réponses ne sont jamais envoyées. L'État affiche l'heure du dernier envoi et combien de spans et de logs sont partis depuis le démarrage du serveur, ainsi que la dernière erreur, si elle est plus récente que le dernier envoi.
Adresse publique
L'Adresse publique est l'adresse par laquelle les personnes ouvrent la
plateforme, par exemple https://plateforme.exemple.fr. C'est celle des liens
des e-mails, comme celui de la récupération du mot de passe des comptes des
apps. La section se trouve dans le groupe Installation, qui n'apparaît
que dans une installation à un seul tenant ; en multitenant, c'est l'adresse
de chaque tenant qui vaut.
Elle est renseignée à la première connexion d'un administrateur, avec l'adresse par laquelle il est entré. Si ce n'est pas l'adresse que les personnes utilisent (par exemple, si l'administrateur est entré par l'IP du réseau interne), corrigez-la et cliquez sur Enregistrer.
Sans Adresse publique, la récupération du mot de passe ne fonctionne que pour les apps publiées sur un domaine propre. L'adresse qui arrive avec une demande ne sert jamais pour le lien, car c'est celui qui fait la demande qui la choisit.
Le serveur PostgreSQL de la plateforme
Pour les datasources internes en PostgreSQL (voir Connecter des bases de données), l'installation a besoin d'un serveur PostgreSQL où la plateforme crée les bases. La configuration appartient à l'installation, pas à une app : dans une installation pour une seule organisation, elle se trouve dans les Paramètres, section PostgreSQL géré du groupe Installation ; dans une installation multi-clients, dans le backoffice de l'installation. Renseignez l'adresse, le port, le compte d'administration et la limite de bases par client, enregistrez et utilisez Tester le serveur pour confirmer que la plateforme peut créer des bases sur ce serveur. Tant qu'il n'est pas configuré, l'option PostgreSQL de l'onglet Interne est désactivée à la création d'un datasource.
Moteur du navigateur
Les captures d'écran que les agents demandent par MCP et les tests d'écran (voir Le projet de tests) utilisent un navigateur sans écran qui s'exécute sur le serveur. Il n'y en a qu'un pour toute l'installation, dans un processus à part et avec une priorité basse : quand la machine est à court de ressources, c'est le navigateur qui cède, pas les requêtes des apps.
La section Moteur du navigateur, dans le groupe Installation (dans une installation avec plusieurs clients, dans le backoffice de l'installation), affiche l'État (en cours d'exécution, ou fermé jusqu'à la prochaine tâche), si Chromium est installé, les Tâches en cours et en file, la Mémoire libre et la Dernière erreur. Elle contient aussi les limites qui protègent le serveur :
| Limite | Ce qu'elle fait |
|---|---|
| Tâches simultanées | Combien de pages ouvertes en même temps. Plus de pages, plus de mémoire et de CPU. |
| Demandes en file | Quand la file est pleine, une nouvelle demande est refusée aussitôt, avec la raison. |
| Minutes d'inactivité avant fermeture | Fermé, le navigateur n'occupe pas de mémoire ; la tâche suivante le rouvre. |
| Mémoire libre minimale (Mo) | En dessous, aucune nouvelle page ne s'ouvre. 0 désactive la protection. |
Fermer le navigateur maintenant rend la mémoire tout de suite. Si Chromium manque, Installer Chromium le télécharge ; l'installation et les mises à jour de la plateforme l'installent déjà et vérifient qu'il démarre.
Mettre à jour la plateforme
Où et comment mettre à jour dépend du mode de l'installation :
- Installation pour une seule organisation : pas de mise à jour par l'interface. La section Mises à jour des Paramètres affiche la Version installée : et la commande à exécuter dans la console du serveur avec le zip de la nouvelle version, avec un bouton pour la copier. L'installateur conserve la configuration et les données et exécute les migrations ; pour revenir à une version antérieure, on installe le zip de cette version.
- Installation multi-clients : la mise à jour se fait dans le backoffice de l'installation, sous Mises à jour, et c'est cet écran que décrit la suite de cette section. Les Paramètres de chaque client n'ont pas de mises à jour.
La section de mise à jour affiche la version installée et la liste des versions disponibles. Le processus a deux boutons, et c'est voulu :
- Préparer — va chercher la version choisie et la prépare sans toucher à rien de ce qui est en service. La plateforme continue de fonctionner.
- Quand la préparation se termine, le plan apparaît : combien de bases de données vont être migrées, quels fichiers d'apps sont réécrits et dans combien de versions, plus l'avertissement que les bases de données sont copiées avant que quoi que ce soit ne soit modifié.
- Appliquer cette mise à jour — seulement après avoir lu le plan. La plateforme est indisponible pendant le redémarrage et revient dans la nouvelle version.

Note
Si une app a sur le disque des modifications qui ne sont pas encore dans l'historique, le plan le dit et la mise à jour les enregistre d'abord, dans une entrée à part, avant de réécrire les fichiers. Les fichiers que la plateforme écrit d'elle-même, comme les copies des dépendances des scripts que fait une planification, ne comptent pas.
Si quelque chose tourne mal en cours de route, la version précédente est rétablie automatiquement et l'écran le dit — y compris le journal de ce qui a échoué.
Le retour en arrière ramène à l'état d'avant la mise à jour les bases de données et aussi les fichiers des apps que les migrations avaient réécrits.
Vérification du serveur
Sur l'écran des mises à jour, le bloc Vérification du serveur indique si la machine a ce dont ont besoin les scripts des apps, les captures d'écran et les tests d'écran : Chromium, l'isolation des scripts, les règles réseau des scripts et les processus de la plateforme exécutés avec l'utilisateur de l'installation. La vérification s'exécute à la fin de l'installation, à la fin de chaque mise à jour et au démarrage du serveur ; Vérifier maintenant l'exécute à la demande.
Le résumé indique « Tout est en ordre. », combien d'avertissements il y a, ou combien de problèmes restent à résoudre. Chaque problème indique ce qui échoue et affiche la commande qui le résout, à exécuter en root dans la console du serveur.
Intelligence artificielle
Le groupe Intelligence artificielle contient la section Fournisseurs : les services d'IA du tenant que les scripts des applications peuvent utiliser, avec les identifiants et les modèles autorisés. Voir Fournisseurs d'IA.
Authentification des apps
La section Authentification des apps, dans le groupe Applications, enregistre les fournisseurs par lesquels les utilisateurs des apps peuvent se connecter : Microsoft Entra ID, Google, un service OpenID Connect ou OAuth 2.0 et, dans une installation avec un seul tenant, Active Directory. Elle est expliquée dans Se connecter avec des fournisseurs d'authentification.
Application mobile
La section Application mobile sert l'app Android avec laquelle on entre dans les apps de cette plateforme. Elle a deux fichiers à télécharger et un code QR par app — c'est expliqué en détail dans le chapitre Application mobile.

Modèles
La section Modèles, dans le groupe Applications, liste les modèles de cette plateforme : ceux qui ont été enregistrés dans les apps avec Enregistrer comme modèle (voir Modèles d'apps). Les modèles système appartiennent à l'installation et n'apparaissent pas ici.
Chaque ligne affiche le nom, la version, la description, l'app d'où il vient, la date d'enregistrement et la taille. Sur chacun :
- Télécharger transfère le fichier
.keplintemplate, pour l'emporter vers une autre installation. - L'icône de la corbeille supprime le modèle. La confirmation apparaît sur la ligne elle-même : cliquez sur Supprimer pour confirmer, ou sur Annuler. Le modèle quitte la galerie de Nouvelle app, et les apps déjà créées à partir de lui ne changent pas.

Fichiers inutilisés
Les fichiers chargés dans les apps ne se suppriment pas tout seuls : ni quand l'enregistrement qui les contenait est supprimé, ni quand une pièce jointe est remplacée, ni quand un formulaire reste à moitié rempli. La section Fichiers inutilisés les trouve et permet de choisir ce qui part. Rien n'est supprimé tout seul.
- Cliquez sur Rechercher les fichiers inutilisés, dans l'en-tête. La recherche s'exécute en arrière-plan sur le serveur : vous pouvez quitter la page et revenir, elle continue.
- Pendant la recherche, la page affiche la progression (par exemple, « 3 sur 12 applications ») et ce qu'elle lit. Chaque app apparaît dès qu'elle est terminée, avec les fichiers qu'aucune référence connue n'utilise : nom, taille, date de chargement et versions. L'icône à côté du nom télécharge le fichier, pour que vous vérifiiez ce que c'est.
- Choisissez les fichiers et cliquez sur Supprimer la sélection. La page demande une confirmation ; avant de supprimer, la plateforme vérifie à nouveau les fichiers choisis, et un fichier qui entre-temps est utilisé reste.

Le résultat est conservé : en revenant à la section, la dernière recherche apparaît, avec la date et sa durée. Rechercher à nouveau répète la recherche dans toutes les apps, et Rechercher dans cette application, dans l'en-tête d'une app, seulement dans celle-ci. Annuler la recherche arrête une recherche en cours. Si le serveur redémarre en cours de route, la page indique que la dernière recherche s'est arrêtée à mi-chemin. Temps de chaque source montre la durée de lecture de chaque base, pour comprendre où passe le temps d'une recherche lente.
Un fichier compte comme utilisé quand son token apparaît dans la conception de l'app, dans les bases SQLite de l'app (y compris les processus et les notifications) ou dans une colonne texte d'une table du modèle, dans n'importe quelle version. Les datasources en lecture seule ne sont pas lus, car Keplin n'y écrit jamais. Une table hors du modèle ou un système externe ne sont pas vus : vérifiez avant de supprimer. Les fichiers des dernières 24 heures n'entrent pas, et une app avec une base illisible reste hors de la liste.
Attention
Un fichier supprimé ne revient pas. Les octets quittent le stockage de l'app et le fichier quitte le registre de toutes les versions.
Open source
La section Open source liste les bibliothèques open source installées dans la plateforme, avec la version et la licence de chacune. Le nom de chaque bibliothèque ouvre la page du projet. Saisissez du texte dans le champ de recherche pour filtrer la liste par nom ou par licence.
Questions fréquentes
J'ai changé un seuil et je n'ai rien reçu. Les alarmes ne sont évaluées que de minute en minute et uniquement à l'intérieur de la fenêtre définie. Vérifiez aussi que l'interrupteur Avertissements par e-mail, dans la section Alertes, est activé, et que le serveur de la section E-mail est renseigné.
Puis-je avoir des serveurs d'e-mail différents par app ? Oui — et c'est la norme. L'e-mail de cette page n'est que celui des avertissements de la plateforme ; chaque app configure ses propres canaux dans ses paramètres.
Qui peut voir cette page ? Uniquement les comptes ayant un profil administrateur. Un developer ne la voit pas dans la barre latérale et n'y entre pas non plus par adresse directe.