Configurer l'instance
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
- Sélectionnez Settings, puis Instance.
- 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églage | Contenu |
|---|---|
enterprise | Tout est activé ; c'est la valeur par défaut d'une nouvelle installation |
databases | L'infrastructure, les alertes, la page d'état et les modules de bases de données |
core | L'infrastructure, les alertes et la page d'état |
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é
- 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.
- 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
securitydésactive aussisecurity.defenderetsecurity.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=truedans la configuration du serveur ; leurs points de terminaison répondent alors404. - Certains commutateurs sont appliqués dans tous les cas. Avec
access.google_logindé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.databases | Les modules SQL Server (y compris les groupes de disponibilité), Azure SQL, Managed Instance et PostgreSQL |
monitoring.updates | La page Updates & advisories et ses vérifications |
security | La page Security posture, les constats et le score de sécurité |
security.defender, security.wazuh | La collecte depuis Microsoft Defender for Cloud et depuis Wazuh. Désactivées par défaut |
security.recommendations | Affiche les recommandations de Defender for Cloud à côté des constats |
collab.jira | Create Jira ticket sur les alertes et les constats ; nécessite collab.assign |
access.google_login | La connexion avec Google |
access.directory_groups | Les rôles pour les groupes Microsoft Entra ID |
ui.public_status_page | Les pages d'état publiques |
ui.i18n | Les langues autres que l'anglais, dans la console et dans les messages Slack |
ui.themes | Les thèmes de couleurs au-delà du clair et du sombre |
Définir l'image de marque
-
Sous Branding, renseignez les champs :
Champ Effet Product name Le 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 Tagline Affiché à côté du nom sur les écrans larges et dans la description de l'application installée. 120 caractères au maximum Logo None, le Built-in mark ou une Image URL : une adresse httpsou un chemin sur ce serveur commençant par/Default theme Le thème de la page de connexion et des nouveaux utilisateurs. Chacun peut toujours choisir le sien Show "powered by" line Une mention en pied de page, affichée uniquement avec le logo intégré -
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âche | Requête |
|---|---|
| Lire la configuration complète, les préréglages et le registre des fonctionnalités | GET /api/v1/instance/admin |
| Appliquer un préréglage | POST /api/v1/instance/preset avec {"name": "databases"} |
| Activer ou désactiver des fonctionnalités | PATCH /api/v1/instance/features avec {"changes": {"collab.jira": false}} |
| Modifier l'image de marque | PATCH /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.