Configuration de l'instance

Une instance serveur se configure en partie au déploiement, par un fichier de configuration et des variables d'environnement. C'est complémentaire de l'interface : la plupart des réglages se font dans l'application, et la configuration sert au déploiement automatisé, aux paramètres structurants et au verrouillage de certains choix.

Cette page décrit les catégories de réglages et les variables propres à Wiven. La référence complète des variables est remise avec l'installation.


Secrets obligatoires

Trois secrets doivent être longs, aléatoires et propres à votre installation : ils signent les sessions et chiffrent les secrets enregistrés par l'application. Ne réutilisez jamais des valeurs d'exemple.

  • Changer le secret de session déconnecte tous les utilisateurs.
  • Changer les secrets de signature rend illisibles les secrets déjà chiffrés : connecteurs SSO, jetons de messagerie et d'agenda, double authentification.

Stockage

Un répertoire unique contient la base de données, les documents, les index, les modèles, le journal d'audit et les politiques de sécurité. C'est le paramètre le plus important en exploitation : il doit pointer vers un volume persistant, sauvegardé avec le fichier de configuration. Si le stockage n'est pas persistant, tout est perdu au redémarrage.


Réseau et service

  • Les ports d'écoute de l'application et du service d'extraction de documents sont configurables.
  • Le TLS peut être activé directement dans l'application, avec votre certificat et votre clé. Si un reverse proxy assure le TLS, laissez le TLS applicatif désactivé.
  • Derrière un reverse proxy, indiquez-le à l'application : sans cela, les limites de débit ne voient pas l'adresse réelle des visiteurs.

Authentification

  • Mot de passe unique en mode mono-utilisateur. En mode multi-utilisateurs, les comptes sont gérés dans l'application et ce mot de passe n'a plus d'effet.
  • Durée des sessions : 30 jours par défaut.
  • Règles de complexité des mots de passe : longueur, minuscules, majuscules, chiffres, symboles.
  • Sessions invité : nouvelles sessions par heure, 5 par adresse et 100 pour l'instance par défaut.
Variable Rôle
WIVEN_LICENSE La licence WivenLLM Business elle-même, en alternative au fichier installé depuis la Console Wiven
WIVEN_MFA_REQUIRED_ROLES Rôles pour lesquels la double authentification est obligatoire. L'écran ne peut plus les changer

Fournisseurs d'IA

Chaque fournisseur se configure sur un schéma constant : une clé d'API ou une adresse de service, une préférence de modèle et, parfois, une limite de contexte lorsqu'elle ne peut pas être découverte automatiquement. Trois choix désignent la sélection active : le fournisseur de modèle de langage, le moteur d'embeddings et la base vectorielle.

La configuration du modèle de langage est reprise une seule fois en base, au premier démarrage : ensuite, c'est la valeur enregistrée dans l'application qui fait foi. Le moteur d'embeddings et la base vectorielle restent définis par la configuration. Réglez chaque point à un seul endroit.


Sécurité et souveraineté

Quand elles sont renseignées, les variables WIVEN_ ci-dessous verrouillent le réglage : l'écran correspondant de la Console Wiven ne peut plus le changer.

Variable Rôle
WIVEN_EGRESS_MODE Mode souverain : off, monitor (par défaut, journalise sans bloquer) ou strict
WIVEN_PII_SHIELD Bouclier de données personnelles : off (par défaut), external ou always
WIVEN_GROUNDING Affirmations non sourcées : off (par défaut), note ou verify
WIVEN_MODEL_APPROVAL enforce exige des modèles approuvés. Désactivé par défaut
AUDIT_RETENTION_MONTHS Mois de journal d'audit à conserver. Sans limite si elle n'est pas renseignée
AUDIT_SYSLOG_URL Envoi du journal d'audit vers un SIEM, en UDP ou en TCP

Options d'exploitation

D'autres réglages d'installation permettent notamment de :

  • retirer la consultation centrale de l'historique des conversations et son export ;
  • interdire la suppression des espaces de travail, depuis l'interface et par l'API ;
  • masquer la documentation d'API interactive ;
  • exiger une liste de domaines autorisés pour tout widget web ;
  • autoriser, ou non, l'import de pages et la lecture web des agents vers des adresses internes, et restreindre ces lectures à une liste d'hôtes ;
  • fixer le nombre maximal d'appels d'outils par réponse d'agent (10 par défaut) et les compétences approuvées d'avance — jamais l'envoi, la réponse ou la suppression de messages ;
  • régler les tâches planifiées : exécutions simultanées (1 par défaut) et durée maximale (5 minutes par défaut) ;
  • choisir les langues de la reconnaissance de caractères (anglais par défaut) ;
  • fixer le délai de resynchronisation des documents surveillés (7 jours par défaut) ;
  • activer la télémétrie anonyme, désactivée par défaut.

Sur une installation à exigence de souveraineté, laissez la télémétrie désactivée et documentez-le.


Bonnes pratiques

Traitez le fichier de configuration comme un secret. Il contient toutes vos clés. Restreignez ses droits d'accès, ne le versionnez pas, sauvegardez-le séparément et de manière chiffrée.

Générez de vrais secrets. Une chaîne aléatoire longue, produite par un générateur, pour chacune des trois valeurs obligatoires.

Vérifiez la persistance du stockage avant la mise en service : redémarrez l'instance et confirmez que les réglages et les documents sont toujours là.

Documentez vos choix. Quel fournisseur, quel moteur d'embeddings, quelle base : ces informations seront nécessaires pour votre registre des traitements et pour toute intervention ultérieure.