Aller au contenu principal
Version : 0.4 · actuelle

Configurer l'instance

Guide pratiqueRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Super-administrateur
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

Chaque installation d'Excubius est livrée avec toutes les fonctionnalités. Settings › Instance détermine celles que l'installation affiche, et sous quels nom, logo et thème. Les modifications s'appliquent immédiatement à tout le monde et sont consignées dans le journal d'audit. Ce guide explique comment activer ou désactiver des fonctionnalités, appliquer un préréglage et définir l'image de marque.

Avant de commencer​

  • Vous devez disposer du rôle Super admin. L'écran n'est affiché à personne d'autre.
  • Certaines fonctionnalités nécessitent aussi une configuration sur le serveur, comme un jeton Slack ou des informations d'identification Jira. Activer une fonctionnalité l'affiche ; cela ne la configure pas.

Ouvrir l'écran​

  1. Sélectionnez Settings, puis Instance.
  2. Repérez les sections Presets, Features et Branding décrites ci-dessous. En bas, l'écran indique si les fonctionnalités désactivées sont seulement masquées ou également refusées par l'API, ainsi que la date de la dernière modification.

Les noms du serveur et TLS ont leur propre écran, accessible par le lien Server names and HTTPS en haut de la page. Consultez Configurer les noms et TLS.

Partir d'un préréglage​

Un préréglage est un point de départ nommé : un ensemble de commutateurs de fonctionnalité accompagné d'une image de marque. Chacun s'affiche sous forme de carte avec sa description. Les préréglages à usage général sont les suivants :

PréréglageContenu
enterpriseTout est activé ; c'est la valeur par défaut d'une nouvelle installation
databasesL'infrastructure, les alertes, la page d'état et les modules de bases de données
coreL'infrastructure, les alertes et la page d'état
attention

La sélection d'une carte de préréglage l'applique immédiatement. Elle remplace tous les commutateurs de fonctionnalité et l'image de marque par ceux du préréglage. Notez votre image de marque avant d'en appliquer un, puis ajustez les commutateurs un par un.

Même avec enterprise, les sources Defender for Cloud et Wazuh restent désactivées tant que vous ne les activez pas.

Activer ou désactiver une fonctionnalité​

  1. Sous Features, recherchez la fonctionnalité dans son groupe : Sources, Monitoring, Security, Collaboration, Access ou Interface. Chaque ligne affiche la clé de la fonctionnalité, ce qu'elle fait et, le cas échéant, la fonctionnalité dont elle dépend.
  2. Utilisez son commutateur.

La modification s'applique immédiatement.

  • Une fonctionnalité qui en nécessite une autre est grisée tant que celle-ci est désactivée. Désactiver une fonctionnalité requise désactive aussi celles qui en dépendent ; par exemple, désactiver security désactive aussi security.defender et security.wazuh.
  • Désactiver une fonctionnalité propriétaire de modules du catalogue retire ces modules de la liste du catalogue.
  • Par défaut, le masquage est uniquement visuel : la navigation, les écrans et les widgets suivent les commutateurs, tandis que la collecte, le stockage et l'API continuent de fonctionner. Lorsque vous réactivez une fonctionnalité, son historique est toujours là. Pour que l'API refuse aussi les fonctionnalités désactivées, définissez EXCUBIUS_FEATURES_ENFORCE_API=true dans la configuration du serveur ; leurs points de terminaison répondent alors 404.
  • Certains commutateurs sont appliqués dans tous les cas. Avec access.google_login désactivé, la connexion avec Google est refusée.

Fonctionnalités auxquelles font référence d'autres guides :

FonctionnalitéCe qu'elle contrôle
monitoring.databasesLes modules SQL Server (y compris les groupes de disponibilité), Azure SQL, Managed Instance et PostgreSQL
monitoring.updatesLa page Updates & advisories et ses vérifications
securityLa page Security posture, les constats et le score de sécurité
security.defender, security.wazuhLa collecte depuis Microsoft Defender for Cloud et depuis Wazuh. Désactivées par défaut
security.recommendationsAffiche les recommandations de Defender for Cloud à côté des constats
collab.jiraCreate Jira ticket sur les alertes et les constats ; nécessite collab.assign
access.google_loginLa connexion avec Google
access.directory_groupsLes rôles pour les groupes Microsoft Entra ID
ui.public_status_pageLes pages d'état publiques
ui.i18nLes langues autres que l'anglais, dans la console et dans les messages Slack
ui.themesLes thèmes de couleurs au-delà du clair et du sombre

Définir l'image de marque​

  1. Sous Branding, renseignez les champs :

    ChampEffet
    Product nameLe titre du navigateur, l'en-tête, la page de connexion, le nom de l'application installée, ainsi que le préfixe et l'étiquette des tickets Jira. 60 caractères au maximum
    TaglineAffiché à côté du nom sur les écrans larges et dans la description de l'application installée. 120 caractères au maximum
    LogoNone, le Built-in mark ou une Image URL : une adresse https ou un chemin sur ce serveur commençant par /
    Default themeLe thème de la page de connexion et des nouveaux utilisateurs. Chacun peut toujours choisir le sien
    Show "powered by" lineUne mention en pied de page, affichée uniquement avec le logo intégré
  2. Sélectionnez Save.

Lorsque Logo est défini sur None, une icône neutre est utilisée partout, y compris dans l'onglet du navigateur et dans l'application installée ; ainsi, rien dans le navigateur ne nomme le produit. Les messages Slack et les pages d'état publiques ne nomment jamais le produit, quelle que soit l'image de marque.

Les thèmes sont Midnight, Daylight, Slate and amber, Ops room (high contrast), Okabe–Ito (colour-blind safe) et Paper. Avec ui.themes désactivé, l'installation ne propose que le clair et le sombre.

La branche d'un client peut avoir ses propres thème et logo par défaut ; consultez Définir l'apparence d'une branche.

Utiliser l'API​

Chaque requête nécessite le rôle Super admin et elle est auditée.

TâcheRequête
Lire la configuration complète, les préréglages et le registre des fonctionnalitésGET /api/v1/instance/admin
Appliquer un préréglagePOST /api/v1/instance/preset avec {"name": "databases"}
Activer ou désactiver des fonctionnalitésPATCH /api/v1/instance/features avec {"changes": {"collab.jira": false}}
Modifier l'image de marquePATCH /api/v1/instance/branding avec n'importe lequel des champs product_name, tagline, logo, show_powered_by, theme_default

GET /api/v1/instance ne nécessite aucune connexion : il renvoie l'image de marque et les commutateurs tels que l'appelant les voit, c'est-à-dire ce que la console lit au chargement.