Sommaire de la documentation
AarView · Configurer
Référence de configuration
Toutes les variables du fichier .env de l'édition autonome : obligatoires, facultatives, flux publics, messagerie, moteurs, et secrets générés par l'installateur.
Sur cette page
Toute la configuration de l’édition autonome tient dans .env. L’installateur le crée à partir de .env.example. Ce fichier contient des secrets : gardez-le en mode 0600 et hors de tout dépôt de code.
Après une modification :
docker compose up -d
Obligatoires
| Variable | Rôle |
|---|---|
AARVIEW_DOMAIN | le nom que vos utilisateurs saisissent ; il doit pointer vers ce serveur |
AARVIEW_OPERATOR_NAME | votre organisation, affichée à vos utilisateurs (page de connexion, rapports, e-mails) |
AARVIEW_ADMIN_EMAIL | l’administrateur du fournisseur d’identité, et le contact affiché quand un compte est verrouillé |
Facultatives
| Variable | Défaut | Rôle |
|---|---|---|
AARVIEW_OPERATOR_TENANT | operator | identifiant court de votre propre organisation (minuscules, chiffres, tirets) |
AARVIEW_SUPPORT_EMAIL | AARVIEW_ADMIN_EMAIL | adresse de support affichée à vos utilisateurs |
AARVIEW_BIND | 0.0.0.0 | adresse d’écoute du port 443 (0.0.0.0 = toutes les interfaces) |
AARVIEW_LOCKOUT_SECONDS | 900 | durée de verrouillage d’un compte après 5 échecs de connexion |
AARVIEW_LICENCE_KEY | vide | la clé de licence ; elle peut aussi s’installer depuis la page Licence |
Flux publics
HTTPS sortant, sans aucune donnée vous concernant. Réglez-les à false sur un réseau fermé.
| Variable | Défaut | Rôle |
|---|---|---|
CVE_FEED_ENABLED | true | flux CVE (NVD et catalogue CISA KEV) |
EUVD_ENABLED | true | liste EUVD de l’ENISA |
NEWS_ALERTS_ENABLED | true | notification, chaque heure, des CVE critiques récentes |
NEWS_SOURCES | les CERT officiels | les flux lus par la page Actualités ; vide (NEWS_SOURCES=) = aucun |
NVD_API_KEY | vide | clé d’API NVD, facultative : elle relève la limite de requêtes imposée par NVD |
Sans NEWS_SOURCES dans .env, la page Actualités lit cert-fr, cert-eu-adv, cert-eu-ti, cccs-fr, ancs-tn et africacert.
Messagerie
| Variable | Défaut | Rôle |
|---|---|---|
SMTP_HOST | vide | serveur d’envoi (notifications, liens de compte) |
SMTP_PORT | 587 | port |
SMTP_USER, SMTP_PASSWORD | vide | identifiants |
Moteurs existants
Tous facultatifs ; vide = non configuré. Le stockage d’évènements, le gestionnaire d’agents et la plateforme de renseignement fonctionnent chacun avec un moteur compatible (liste sur demande). Détail dans Moteurs existants.
| Variables | Moteur |
|---|---|
EVENTS_URL, EVENTS_USER, EVENTS_PASSWORD, EVENTS_CA_CERT | stockage d’évènements |
ENDPOINTS_API_URL, ENDPOINTS_API_USER, ENDPOINTS_API_PASSWORD, ENDPOINTS_API_CA_CERT | gestionnaire d’agents |
INTEL_URL, INTEL_API_KEY, INTEL_CA_CERT | plateforme de renseignement |
CORTEX_URL, CORTEX_API_KEY, CORTEX_CA_CERT | Cortex |
AI_SERVICE_URL, AI_SERVICE_TOKEN | service d’assistant IA |
Un fichier d’autorité privée se dépose dans certs/ et se désigne par /certs/<fichier>.
Générées par l’installateur
Laissez-les vides : install.sh les remplit. Ne les réutilisez jamais d’une installation à l’autre.
| Variable | Contenu |
|---|---|
AARVIEW_INSTANCE_ID | identifiant d’instance (aarv-…), lié à la licence ; ne le changez jamais sur une installation en service |
POSTGRES_PASSWORD, AARVIEW_DB_APP_PASSWORD, AUTHENTIK_DB_PASSWORD | mots de passe de la base |
AUTHENTIK_SECRET_KEY, AUTHENTIK_BOOTSTRAP_PASSWORD | fournisseur d’identité ; le second est le mot de passe initial d’akadmin |
AUTHENTIK_CLIENT_ID, AUTHENTIK_CLIENT_SECRET | le client OpenID Connect du portail |
AARVIEW_AUTHENTIK_TOKEN | le jeton du compte d’annuaire du portail |
NEXTAUTH_SECRET | les sessions de l’interface |
SOURCES_MASTER_KEY, WEBHOOK_MASTER_KEY | le chiffrement des secrets de sources et de webhooks |
Images publiées
Par défaut, les images sont construites depuis les sources. Pour utiliser des images publiées, renseignez AARVIEW_BACKEND_IMAGE et AARVIEW_FRONTEND_IMAGE.