Paramètres de l'application

Les paramètres en base de données, modifiables par un administrateur, définis dans SettingService.static.DEFAULTS.

Sur cette page

Paramètres de l'application

Ceux-ci vivent dans SettingService.static.DEFAULTS, sont seedés au démarrage par preFlightCheck(), mis en cache avec une durée de vie de 2 heures, et modifiables sur /settings par quiconque possède la permission settings:write (ou settings:admin) — voir Configuration.

The Global Settings admin page
La page d'administration des Paramètres globaux.

Authentification & inscription

ParamètreObjet
cbLoginLayoutMise en page utilisée pour les pages d'authentification (AuthSplit par défaut ; choisissez AuthCenter ou AuthSplit)
cbAllowRegistrationActive/désactive l'inscription en libre-service
cbAllowForgotPasswordActive/désactive le flux de mot de passe oublié
cbAllowRememberMeActive/désactive le cookie « se souvenir de moi »
cbRememberMeDaysDurée pendant laquelle un jeton « se souvenir de moi » reste valide (par défaut : 14)
cbRequirePasskeyImpose l'enregistrement d'une passkey avant d'accéder à la zone d'administration

Sélection de la mise en page de connexion

La page Paramètres expose cbLoginLayout comme un sélecteur :

ValeurMise en pageApparence
AuthSplitapp/layouts/AuthSplit.bxmConnexion à deux panneaux : branding/fonctionnalités à gauche et formulaire à droite. Sur petits écrans, elle se réduit au formulaire avec un branding compact. C'est la valeur par défaut.
AuthCenterapp/layouts/AuthCenter.bxmCarte d'authentification centrée avec le logo, le formulaire, et le pied de page d'authentification.

Sélectionnez Auth Center ou Auth Split sur /settings, enregistrez les paramètres, et rechargez la page d'authentification. Le handler appelle event.setLayout( prc.settings.cbLoginLayout ), donc la mise en page sélectionnée s'applique aux pages de connexion, d'inscription, d'activation d'invitation, et de récupération de mot de passe. Vous pouvez aussi définir la valeur directement en base de données ou ajouter un nom de mise en page personnalisé sous app/layouts/ si votre application fournit cette mise en page.

Politique de mot de passe & de jetons

ParamètreObjet
cbMinPasswordLengthLongueur minimale du mot de passe (par défaut : 8). SettingService.isValidPassword() exige aussi une lettre majuscule, une lettre minuscule, un chiffre, et un caractère spécial, et chaque chemin côté serveur qui définit un mot de passe (inscription, activation d'invitation, réinitialisation, et changement de profil) l'exécute
cbPasswordResetExpirationValidité du jeton de réinitialisation, en minutes (par défaut : 60)
cbInvitationExpirationValidité du jeton d'invitation, en jours (par défaut : 7)
cbRegistrationVerificationExpirationValidité du jeton de vérification d'inscription, en heures (par défaut : 24)
cbApiTokenMaxValidityMonthsDurée de vie maximale pour laquelle un jeton API peut être émis (par défaut : 12)
cbAuditLogRetentionDaysÂge, en jours, auquel la tâche planifiée quotidienne supprime définitivement les entrées du journal d'audit (par défaut : 90). 0 désactive la purge - voir Tâches planifiées
cbRateLimitMaxAttemptsTentatives autorisées par IP, par point de terminaison, avant que RateLimiter ne bloque la connexion/l'inscription/la réinitialisation de mot de passe (par défaut : 5) - voir Limitation de débit
cbRateLimitWindowSecondsFenêtre de limitation de débit, en secondes (par défaut : 300). 0 désactive entièrement la limitation de débit
cbTrustProxyHeadersSi RateLimiter, le journal d'audit, et les emails de sécurité font confiance aux en-têtes X-Forwarded-For/X-Cluster-Client-IP pour l'IP de l'appelant (par défaut : true, puisque cette application est typiquement déployée derrière un proxy inverse ou un répartiteur de charge). Désactivez ceci uniquement si l'application est directement exposée sur Internet sans rien devant elle - voir Déploiement derrière un proxy
cbEncryptionKey / cbSaltingKeyClés de chiffrement/salage utilisées par la couche de sécurité

Image de marque & apparence

ParamètreObjet
cbAppNameNom d'affichage de l'application
cbAppLogoLogo affiché dans la barre latérale d'administration. Soit une URL saisie manuellement, soit /branding/logo/lg après un téléversement via Paramètres — voir Avatars & logo de marque
cbAppTaglineSlogan affiché à côté du logo
cbAppBrandTaglineCourt libellé de marque affiché dans la zone de marque de la barre latérale
cbCopyrightNoticeTexte de copyright rendu par le pied de page de l'application
cbDefaultThemeThème clair/sombre par défaut pour les nouveaux visiteurs

Email

ParamètreObjet
cbDefaultEmailAdresse « de » par défaut pour les emails sortants
cbMailHost / cbMailPortHôte/port SMTP
cbMailUsername / cbMailPasswordIdentifiants SMTP
cbMailTLS / cbMailSSLDrapeaux de sécurité du transport

Journal d'audit

ParamètreObjet
cbAuditLogRetentionDaysNombre de jours pendant lesquels les enregistrements d'audit sont conservés par la purge planifiée. Définir à 0 pour désactiver la purge automatique (par défaut : 90).

Secrets et chiffrement

ParamètreObjet
cbEncryptionKeySecret de chiffrement AES utilisé par la couche de sécurité/stockage. Remplacez la valeur de développement générée par un secret stable en production.
cbSaltingKeySel utilisé par les opérations de sécurité. Gardez-le stable et secret en production.
ConfigurationVariables d'environnement, paramètres du framework, et configuration par module. Étendre l'applicationAjouter un nouveau module CRUD, une permission, un paramètre, ou une tâche planifiée, en suivant les conventions propres de l'application.
Modifier cette page Télécharger le Markdown Dernière mise à jour Oct 1, 2026, 2:02:30 PM