Aller au contenu principal
Version : 0.4 · actuelle

Variables d'environnement

RéférenceRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Installateur (administrateur Linux)
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

Excubius lit ses paramètres d'installation dans le fichier .env du répertoire d'installation, /opt/excubius/.env par défaut, en mode 0600 et appartenant au compte de service. Le programme d'installation l'écrit à partir de vos réponses et génère les secrets une seule fois. Cette référence répertorie les clés que vous pouvez définir, regroupées comme dans le fichier.

La plupart des paramètres se trouvent dans la console, pas ici : la personnalisation de la marque et les commutateurs de fonctionnalité dans Settings › Instance, les noms et les certificats dans Settings › Server, les sources dans Settings › Sources, les informations d'identification de supervision dans Settings › Credentials. Après avoir modifié le fichier, redémarrez la plateforme avec le compte de service à l'aide de systemctl --user restart excubius.

attention

Sauvegardez le fichier .env, et avec lui EXCUBIUS_DATA_KEY. Sans cette clé, les secrets stockés dans la base de données ne peuvent pas être déchiffrés.

Installation​

CléValeur par défautSignification
EXCUBIUS_HOME/opt/excubiusRépertoire d'installation. Écrit par le programme d'installation
SERVER_NAME—Le nom principal : l'hôte de l'URL publique
REGISTRYghcr.io/custorius-labs/excubiusPréfixe du registre et du dépôt des images
PROXY_MODEhttphttp ou https. S'applique uniquement jusqu'à ce que le service de certificats prenne le relais ; ensuite, c'est Settings › Server qui décide
COOKIE_SECUREvideVide : les cookies de session sont Secure chaque fois que la requête est arrivée en HTTPS. true ou false forcent la valeur. Laissez-la vide

Noms et TLS​

Ces clés initialisent les paramètres TLS au premier démarrage uniquement, lorsque la plateforme n'en a pas encore. Ensuite, les noms et les certificats se gèrent dans Settings › Server, sans redémarrage. Le programme d'installation retire du fichier les informations d'identification DNS et la clé privée une fois que la plateforme les a stockées.

CléValeur par défautSignification
TLS_MODEvideletsencrypt_http, letsencrypt_dns, selfsigned, custom, gateway ou http. Les noms du programme d'installation letsencrypt, letsencrypt-dns et later sont également acceptés
TLS_ALIASESvideAutres noms que les utilisateurs peuvent ouvrir, séparés par des espaces
TLS_CERT_NAMESvideNoms à inclure dans le certificat, séparés par des espaces. Vide : tous les noms
TLS_EMAILvideAdresse e-mail du compte Let's Encrypt
TLS_ACME_SERVERproductionstaging pour faire une répétition avec des certificats de test auxquels les navigateurs ne font pas confiance
TLS_DNS_PROVIDERvideL'ID dnsapi d'acme.sh du fournisseur DNS, comme dns_cf ou dns_azure
TLS_DNS_CREDENTIALSvidePaires KEY=VALUE séparées par des retours à la ligne ou par ;, ou base64:<…>
TLS_CERT_FILE, TLS_KEY_FILEvidebase64:<PEM contents> de votre propre chaîne de certificats et de votre clé privée
TLS_ACME_DNSSLEEP0Secondes d'attente de la propagation DNS au lieu de la vérifier via des résolveurs publics DNS-over-HTTPS. Utilisez-la sur les réseaux qui ne peuvent pas les joindre

Produit​

CléValeur par défautSignification
PRODUCT_NAMEExcubiusValeur de repli uniquement. Le nom du produit provient de la personnalisation de la marque dans Settings › Instance
DEFAULT_LOCALEenLangue par défaut
BASE_URL—L'URL publique, comme https://monitoring.example.com. Les liens des messages l'utilisent
EXCUBIUS_DEFAULT_PRESETenterpriseLe préréglage à partir duquel l'instance démarre : enterprise, databases ou core
EXCUBIUS_FEATURES_ENFORCE_APIfalsetrue : l'API refuse aussi les fonctionnalités désactivées. Par défaut, elles sont seulement masquées dans l'interface

Base de données et secrets​

CléValeur par défautSignification
POSTGRES_USERexcubiusUtilisateur de la base de données
POSTGRES_PASSWORDgénéréeLettres et chiffres uniquement, car elle est intégrée dans une URL de connexion
POSTGRES_DBexcubiusNom de la base de données
DATABASE_URLconstruite à partir des trois clés ci-dessusURL de connexion. Les conteneurs la reçoivent construite à partir des trois clés ci-dessus
EXCUBIUS_DATA_KEYgénéréeClé qui chiffre les secrets stockés dans la base de données : informations d'identification, secrets des sources, clés d'API DNS. 32 octets aléatoires, en base64 compatible URL. Ne la modifiez jamais sur une installation en service
EXCUBIUS_COLLECTOR_TOKENgénéréSecret partagé entre le collecteur et l'API. Vide : le collecteur reste inactif et les points de terminaison du collecteur sont désactivés

Connexion​

CléValeur par défautSignification
JWT_SECRETgénéréSigne les jetons de session. 64 caractères aléatoires
ACCESS_TOKEN_MINUTES15Durée de vie d'un jeton d'accès
REFRESH_TOKEN_DAYS14Durée de vie d'une session
ENTRA_TENANT_ID, ENTRA_CLIENT_ID, ENTRA_CLIENT_SECRETvideConnexion Microsoft Entra ID, locataire unique : l'ID de l'annuaire, pas common ni organizations. Proposée dès que les trois clés sont définies. URI de redirection : <BASE_URL>/api/v1/auth/entra/callback
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRETvideConnexion Google. URI de redirection : <BASE_URL>/api/v1/auth/google/callback
ALLOWED_SIGNUP_DOMAINSvideDomaines de messagerie, séparés par des virgules, dont les utilisateurs reçoivent un compte avec le rôle de lecteur sur la racine à leur première connexion. S'applique uniquement jusqu'à ce qu'un mode d'inscription soit enregistré sur l'entité racine. Vide : sur invitation uniquement

Les secrets clients ne sont jamais stockés dans la base de données ni journalisés.

Cœur de la supervision​

CléValeur par défautSignification
EXCUBIUS_UNREACHABLE_AFTER3Échecs consécutifs de connexion réseau, d'authentification ou de délai d'expiration avant qu'une ressource reçoive son alerte Cannot reach
EXCUBIUS_NOTIFY_QUIET_MINUTES10Nombre minimal de minutes entre deux messages pour la même condition. Une gravité en hausse est toujours envoyée
EXCUBIUS_COLLECTOR_VIA_PROXYfalsetrue uniquement pour un collecteur situé hors du serveur qui joint l'API par l'adresse publique

Collecteur​

Le conteneur du collecteur reçoit uniquement ces clés, jamais le fichier entier.

CléValeur par défautSignification
EXCUBIUS_COLLECTOR_TOKENgénéréConsultez Base de données et secrets
EXCUBIUS_COLLECTOR_TRANSPORTStous les transports présentsSous-ensemble à proposer, séparé par des virgules, comme tsql,http,dns. Valeurs : tsql, http, dns, winrm, ssh, azure_graph, defender, entra, wazuh
EXCUBIUS_COLLECTOR_CONCURRENCY32Vérifications exécutées simultanément
EXCUBIUS_TSQL_THREADS16Threads pour les connexions SQL Server
EXCUBIUS_SQL_APP_NAMEmonitoring-collectorNom d'application des sessions SQL Server du collecteur
EXCUBIUS_ODBC_DRIVERODBC Driver 18 for SQL ServerNom du pilote ODBC
AZURE_SUBSCRIPTION_IDSvideAbonnements, séparés par des virgules, pour les vérifications Resource Graph natives (sécurité du cloud, Azure Update Manager) lorsque les informations d'identification n'en définissent aucun. Vide : tous les abonnements que l'identité peut lire. La source Azure Monitor a sa propre liste
AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRETvideVide : l'identité managée du serveur. AZURE_CLIENT_ID seul désigne une identité managée affectée par l'utilisateur. Les trois : ce principal de service est utilisé à la place

Le collecteur dispose aussi de paramètres pour ses intervalles d'interrogation, la taille de ses lots et de sa mémoire tampon et son nom d'hôte, mais la plateforme installée ne les transmet pas à son conteneur ; leurs valeurs par défaut s'appliquent donc : affectations toutes les 30 secondes, travaux toutes les 10 secondes, une pulsation toutes les 60 secondes, 200 résultats par lot, 10 000 résultats conservés tant que l'API est inaccessible.

Notifications et tickets​

CléValeur par défautSignification
SLACK_BOT_TOKENvideJeton de bot de l'application Slack, avec l'étendue chat:write. Vide : rien n'est envoyé à Slack
SLACK_DEFAULT_CHANNEL#alertsReçoit les avertissements et les alertes critiques lorsqu'aucune entité du chemin n'a de canal
JIRA_BASE_URLvidehttps://<site>.atlassian.net
JIRA_AUTHtokentoken (adresse e-mail et jeton d'API), oauth (informations d'identification client d'un compte de service Atlassian) ou bearer
JIRA_EMAIL, JIRA_API_TOKENvideInformations d'identification pour token
JIRA_OAUTH_CLIENT_ID, JIRA_OAUTH_CLIENT_SECRETvideInformations d'identification pour oauth
JIRA_CLOUD_IDvideoauth uniquement : l'ID cloud du site
JIRA_OAUTH_TOKEN_URLhttps://auth.atlassian.com/oauth/tokenURL de jeton pour oauth
JIRA_DEFAULT_PROJECTvideClé du projet pour les nouveaux tickets
JIRA_ISSUE_TYPETaskNom du type de ticket dans ce projet
JIRA_SYNC_MINUTES10Fréquence de lecture de l'état des tickets ouverts
WEB_PUSH_VAPID_PUBLIC, WEB_PUSH_VAPID_PRIVATEvideRéservées aux notifications web push, non disponibles dans cette version. Laissez-les vides

Les clés Jira sont des valeurs par défaut : chaque entité peut les remplacer dans ses propres paramètres Jira. Consultez Créer des tickets Jira à partir des alertes.

Processus des mises à jour et de la sécurité​

CléValeur par défautSignification
EXCUBIUS_SECURITY_WORKERtrueLe processus d'arrière-plan de l'API : flux des éditeurs, expiration des acceptations de risque, vérifications exécutées par l'API, instantanés du score de sécurité, état Jira. Définissez false uniquement sur les réplicas supplémentaires de l'API
EXCUBIUS_FEEDS_ENABLEDtruefalse : ne jamais récupérer les flux des éditeurs, pour les installations isolées (air-gapped). Les copies fournies avec la version sont utilisées
EXCUBIUS_FEED_TIMEOUT_SECONDS60Délai d'expiration par requête de flux
EXCUBIUS_FEED_SQLSERVER_BUILDS_URLSle site dbatools, puis GitHubURL de la liste des builds SQL Server, séparées par des espaces et essayées dans l'ordre. Placez un miroir interne en premier
EXCUBIUS_FEED_ENDOFLIFE_URLhttps://endoflife.date/apiURL de base du flux de fin de support
EXCUBIUS_FEED_MSRC_URLhttps://api.msrc.microsoft.com/cvrf/v3.0URL de base des avis de sécurité Microsoft
EXCUBIUS_FEED_MSRC_MONTHS3Publications mensuelles tenues à jour, de 1 à 24
HTTPS_PROXYvideProxy pour les requêtes de flux

Clés que cette version ne lit pas​

Le fichier .env.example fourni répertorie encore NEWRELIC_API_KEY, NEWRELIC_ACCOUNT_ID, NEWRELIC_WEBHOOK_SECRET, NINJAONE_CLIENT_ID, NINJAONE_CLIENT_SECRET, NINJAONE_REGION, WAZUH_API_URL, WAZUH_API_USER et WAZUH_API_PASSWORD. Cette version les ignore. Configurez New Relic et NinjaOne dans Settings › Sources, et Wazuh avec des informations d'identification et les paramètres de la vérification ; consultez Sources et Sécurité du cloud.