ObjectOSParamètres système
Configurez les paramètres de tenant et d'utilisateur à l'aide de manifestes et d'un magasin clé/valeur partagé.
Paramètres système
ObjectStack inclut un service de paramètres pour les paramètres d'exécution et de plugins. ObjectOS expose ces paramètres via la Console lorsque l'artefact applicatif requiert la capacité de paramètres.
Modèle de paramètres
Les paramètres sont déclarés par le code et stockés sous forme de valeurs :
| Couche | Objectif |
|---|---|
| Manifeste de paramètres | Définit les champs, libellés, valeurs par défaut, validations, visibilité et actions |
sys_setting | Stocke les valeurs K/V de tenant/utilisateur |
| Résolveur | Lit la valeur effective |
| Interface de la Console | Affiche les pages de paramètres standard |
Les plugins ne devraient pas créer de tables de paramètres ponctuelles pour la configuration ordinaire. Ils devraient déclarer des manifestes de paramètres et laisser ObjectOS afficher et stocker les valeurs de manière cohérente.
Ordre de résolution
Chaque paramètre déclare une portée (global, tenant ou user). Le
résolveur parcourt la cascade de la priorité la plus élevée à la plus basse, et la
première valeur définie l'emporte :
Environment override (locked)
Global setting
Tenant setting
User setting
Manifest defaultLes surcharges d'environnement sont verrouillées. Si une valeur est définie via une variable d'environnement, l'interface de la Console l'affiche comme gérée par l'hôte et rejette les modifications à l'exécution. Une valeur verrouillée à n'importe quel niveau supérieur de la chaîne verrouille également la valeur effective, de sorte que les portées inférieures ne peuvent pas la masquer.
Domaines de paramètres courants
Les paramètres destinés aux clients incluent généralement :
| Domaine | Exemples |
|---|---|
| Hôte SMTP, clé API du fournisseur, adresse d'expéditeur, email de test | |
| Image de marque | Nom du produit, URL du logo, couleur d'accentuation, thème par défaut |
| Indicateurs de fonctionnalités | Commutateurs de fonctionnalités au niveau du tenant |
| Stockage | Système de fichiers local ou identifiants de stockage d'objets |
| Fournisseurs d'IA | Fournisseur de modèle, clé API, limites de budget |
| SSO | Paramètres du fournisseur OIDC et test de connexion |
Secrets
Les champs de mot de passe et d'identifiants devraient être chiffrés par le service
de paramètres ou fournis sous forme de valeurs gérées par l'environnement. Lorsqu'un fournisseur
de secrets est configuré, le service de paramètres stocke le texte chiffré dans
sys_secret et ne conserve qu'une référence dans sys_setting. Ne stockez pas
de secrets dans des artefacts, des fichiers compose ou Git.
Actions de test
Les manifestes de paramètres peuvent déclarer des boutons d'action standard, tels que :
- envoyer un email de test ;
- tester la découverte SSO ;
- vérifier les identifiants de stockage d'objets ;
- valider la cible d'un webhook.
Utilisez ces actions pour les flux de configuration des clients plutôt que de demander aux opérateurs d'inspecter d'abord les journaux.
Connexes
Plusieurs domaines de paramètres disposent de guides de configuration dédiés :