La cybersécurité souveraine, à la portée de tousCybersécurité souveraine pour tousIA SOC sur vos serveurs · édition gratuite Demander une démoDémo

Documentation

Installer l'édition gratuite de LUAXERR

Ce guide suppose que vous n'avez que ce qui vous a été remis. Chaque étape se termine par ce que vous devez voir. Si vous voyez autre chose, arrêtez-vous à cette étape.

Ce que vous avez reçu

FichierContenu
luaxerr-gratuite-documents.tar.gzce guide, compose.yaml, env.example, la licence, la notice des composants tiers, le SBOM, des alertes d'exemple
luaxerr-gratuite-0.1.0.tar.gzl'image de l'API et de la console
luaxerr-llm-cpu.tar.gzl'image du serveur de modèle
SHA256SUMS-LIVRAISONl'empreinte de chacun des fichiers ci-dessus

Les poids du modèle (4,1 Go) ne sont pas dans ces archives. L'étape 5 dit où les prendre et comment les vérifier.

1. Prérequis

  • Linux x86_64 avec Docker Engine et le greffon docker compose. Sous Windows ou macOS, Docker Desktop convient ; les commandes propres à Windows sont données à côté.
  • 4 cœurs, 12 Go de mémoire libre (le modèle en prend jusqu'à 10), 10 Go de disque.
  • Aucun accès réseau n'est nécessaire une fois les fichiers sur la machine.

2. Vérifier ce que vous avez reçu

Dans le dossier où sont les quatre fichiers :

sha256sum -c SHA256SUMS-LIVRAISON

Vous devez lire OK sur chaque ligne. Si les poids du modèle ne vous ont pas été remis avec le reste, ajoutez --ignore-missing : l'étape 5 les vérifie. Sous Windows, comparez à la main :

Get-FileHash -Algorithm SHA256 luaxerr-gratuite-0.1.0.tar.gz

Une seule empreinte différente : n'allez pas plus loin, le fichier a été altéré ou tronqué.

3. Déballer les documents

tar xzf luaxerr-gratuite-documents.tar.gz
cd luaxerr-gratuite
sha256sum -c SHA256SUMS

Toutes les lignes en OK. La suite se fait dans ce dossier.

4. Charger les images

docker load -i ../luaxerr-gratuite-0.1.0.tar.gz
docker load -i ../luaxerr-llm-cpu.tar.gz

Vous devez lire Loaded image: luaxerr-gratuite:0.1.0 puis Loaded image: luaxerr-llm:cpu.

5. Poser les poids du modèle

Le modèle par défaut est Mistral 7B Instruct v0.3, quantifié en Q4_K_M, sous licence Apache 2.0. Téléchargez-le depuis https://huggingface.co/MaziyarPanahi/Mistral-7B-Instruct-v0.3-GGUF/resolve/main/Mistral-7B-Instruct-v0.3.Q4_K_M.gguf, ou utilisez la copie qui vous a été remise. Posez le fichier à côté des archives, puis, toujours dans le dossier luaxerr-gratuite :

mkdir -p models
mv ../Mistral-7B-Instruct-v0.3.Q4_K_M.gguf models/
sha256sum models/Mistral-7B-Instruct-v0.3.Q4_K_M.gguf

L'empreinte doit être exactement :

14850c84ff9f06e9b51d505d64815d5cc0cea0257380353ac0b3d21b21f6e024

Un autre modèle peut être servi (variable LUAXERR_MODEL_FILE), mais les résultats annoncés ne valent que pour celui-ci : le modèle et le prompt se mesurent ensemble.

6. Configurer

cp env.example .env
chmod 600 .env
openssl rand -hex 32

Copiez la valeur affichée après LUAXERR_API_KEY= dans .env. Sous Windows, pour générer la clé :

$b = New-Object byte[] 32; [Security.Cryptography.RandomNumberGenerator]::Create().GetBytes($b); -join ($b | ForEach-Object { $_.ToString('x2') })

Cette clé ouvre tous les verdicts : gardez-la comme un mot de passe. Sans elle, l'étape suivante refuse de démarrer, et c'est voulu.

La console écoute sur le port 8000 de la machine. S'il est déjà pris, par exemple par l'interface web de Splunk, choisissez-en un autre avec LUAXERR_PORT dans .env, et remplacez 8000 par ce port dans la suite.

7. Démarrer

docker compose up -d
docker compose ps

Le serveur de modèle charge les poids en mémoire : comptez jusqu'à dix minutes sur processeur. Pendant ce temps llm est health: starting et l'API attend. C'est terminé quand docker compose ps montre llm en healthy et api en Up.

curl http://127.0.0.1:8000/health

Vous devez lire {"status":"ok"}.

8. Utiliser

Créez d'abord votre compte, sur le serveur. Le mot de passe se saisit à l'invite, douze caractères au minimum, jamais en argument :

docker compose exec api python -m core.comptes creer soc@example.com

Toute adresse convient, Gmail ou autre : elle sert d'identifiant, aucun e-mail n'est envoyé. Ouvrez ensuite <http://127.0.0.1:8000/> sur la machine elle-même et connectez-vous avec cette adresse et ce mot de passe. La session dure 30 minutes.

La clé d'API de .env ne se saisit pas dans la console : elle sert aux SIEM qui poussent leurs alertes.

ButCommande
Mot de passe perdudocker compose exec api python -m core.comptes mot-de-passe soc@example.com
Supprimer un comptedocker compose exec api python -m core.comptes supprimer soc@example.com
Lister les comptesdocker compose exec api python -m core.comptes lister

Un mot de passe changé ou un compte supprimé coupe aussitôt les sessions ouvertes avant.

Envoyez une alerte d'exemple. La commande lit la clé dans .env, elle ne reste donc pas dans l'historique du shell :

curl -H "X-API-Key: $(grep '^LUAXERR_API_KEY=' .env | cut -d= -f2)" \
  -H "Content-Type: application/json" \
  --data @examples/sample_wazuh_alert.json http://127.0.0.1:8000/alerts/wazuh

La commande attend la fin du jugement : plusieurs minutes sur processeur. Elle rend alors le verdict, qui apparaît aussi dans Alertes. Les connecteurs fournis sont wazuh, elastic, splunk, qradar, sentinel, google_secops, cef et ocsf, avec un exemple pour chacun dans examples/.

Microsoft Sentinel

Microsoft Sentinel, le SIEM, pousse, LUAXERR n'interroge jamais : aucune application à inscrire, aucun identifiant Azure chez vous. À ne pas confondre avec SentinelOne, qui est un EDR. Le plus simple est une règle d'automatisation sur création d'incident qui lance un playbook :

1. Playbook avec le déclencheur Microsoft Sentinel incident. 2. Action HTTP : POST https://<votre-luaxerr>/alerts/sentinel, corps = le corps du déclencheur, en-têtes Content-Type: application/json et X-API-Key. 3. Clé lue dans Azure Key Vault, et Secure inputs activé sur l'action : sinon elle apparaît dans l'historique des exécutions. 4. LUAXERR derrière un proxy inverse en TLS, ouvert aux seules adresses sortantes de Logic Apps de votre région.

Le déclencheur « alerte » d'un playbook et l'export de la table SecurityAlert sont lus aussi. Exemples : sample_sentinel_incident.json, sample_sentinel_playbook_alert.json. Évitez la règle sur « mise à jour » : chaque modification relance un jugement de plusieurs minutes. Un rejeu met à jour l'incident, il ne le double pas. Corps limité à 1 Mo.

Google SecOps

Même principe : SecOps pousse, LUAXERR n'interroge jamais, aucun compte de service Google chez vous.

1. Playbook SOAR avec l'action Execute HTTP Request de l'intégration HTTP v2 : POST https://<votre-luaxerr>/alerts/google_secops, corps = la détection au format de l'API Detection Engine (type, detection, collectionElements). 2. Clé posée dans l'intégration (API Key Field Name = X-API-Key, API Key Secret = la clé), jamais dans le corps du playbook. 3. LUAXERR derrière un proxy inverse en TLS, ouvert aux seules adresses sortantes de votre instance SecOps.

Les champs UDM sont lus en camelCase comme en snake_case. Pour un lancement de processus, la ligne de commande du processus lancé passe avant celle du parent. Exemple : sample_google_secops_detection.json.

CEF (pare-feux, sondes, EDR)

Pour tout équipement qui émet du CEF (ArcSight Common Event Format) en syslog. LUAXERR reçoit en HTTPS : un relais syslog chez vous envoie une ligne par requête, enveloppée en {"message": "<ligne CEF>"}, vers POST https://<votre-luaxerr>/alerts/cef, avec l'en-tête X-API-Key.

Le préfixe syslog est toléré. Ligne limitée à 64 Kio, lue en un seul passage : un message hostile ne coûte que sa longueur. Un message illisible est refusé en 422, sans que la réponse recopie son contenu. Sans externalId, le même message garde le même identifiant : un rejeu ne double pas l'alerte. La ligne de commande n'est lue que dans un champ csN dont le libellé la nomme (CommandLine). Exemple : sample_cef_alert.json.

9. Vérifier

  • La santé : le panneau Santé système de la console doit dire que le modèle est joignable.
  • Le journal : Journal des décisions, puis Vérifier la chaîne. Le résultat doit être « Chaîne intacte ». Chaque décision y est chaînée à la précédente : une ligne modifiée ou retirée casse la chaîne.
  • L'exposition : l'API n'écoute que la machine locale.
docker compose port api 8000

Vous devez lire 127.0.0.1:8000, ou le port choisi à l'étape 6.

Accès depuis un autre poste

Ce guide s'arrête à la machine locale. Pour ouvrir la console à d'autres postes, placez devant un proxy inverse en TLS, gardez la clé d'API, créez un compte par personne, et lisez SECURITY.md. Ne levez jamais la clé pour aller plus vite.

Arrêter, sauvegarder, désinstaller

ButCommande
Arrêterdocker compose down (les données restent)
Sauvegarder les donnéesdocker compose stop api, puis docker compose cp api:/app/data ./sauvegarde, puis docker compose start api
Tout supprimer, données comprisesdocker compose down -v

L'API est arrêtée pendant la copie : une copie prise au milieu d'une écriture serait inutilisable. Le journal est dans le même fichier que les verdicts.

Les données sont dans le volume luaxerr-gratuite_luaxerr-gratuite-data. Elles contiennent des noms de comptes, des adresses et des noms de machines : ce sont des données personnelles. Chiffrez le disque et les sauvegardes.

Ce que l'édition gratuite ne fait pas

  • Des comptes pour ouvrir la console, mais ni rôles ni journal nominatif : le journal ne dit pas qui a classé quoi.
  • Un jugement par alerte, à la demande. Les agents, les campagnes, la couverture ATT&CK, les déclarations réglementaires et le dossier signé sont dans l'édition Enterprise.

Ce site dépose des cookies. Les cookies techniques sont nécessaires au fonctionnement et restent toujours actifs. Les cookies fonctionnels et de mesure d’audience attendent votre accord.

Personnaliser