Plugins

Les plugins s'exécutent après une analyse et reçoivent le rapport JSON sur l'entrée standard. Utilisez-les pour notifier, ouvrir des tickets ou envoyer les résultats vers un SIEM.

Installer et activer

tmaegis plugin install github.com/tmaegis/plugin-slack-notify   # file, URL or GitHub release
tmaegis plugin install ./my-plugin.wasm --sha256 <digest>       # pin the digest
tmaegis plugin list
tmaegis scan --auto-detect --plugin slack,jira

Les plugins sont recherchés dans le répertoire des plugins (./plugins par défaut, --plugin-dir pour le changer). Activez-les de façon permanente dans config.yaml sous plugins.enabled.

Écrire le vôtre

Un plugin exécutable est un fichier nommé tmaegis-plugin-<name> (dans n'importe quel langage). Il lit le rapport d'analyse JSON sur stdin et ses paramètres dans les variables d'environnement.

#!/usr/bin/env sh
# TMAegis notifier plugin: posts a scan summary somewhere.
set -eu
PAYLOAD=$(cat)
FAILED=$(printf '%s' "$PAYLOAD" | grep -o '"failed_count":[0-9]*' | head -n1 | cut -d: -f2)
echo "failed controls: ${FAILED:-0}"

Les plugins WebAssembly s'exécutent dans un bac à sable (wazero) sans accès à l'hôte, sauf autorisation.

Plugins disponibles

• jiraOfficielType: executable

  TMAegis ITSM plugin: opens one Jira issue per failed critical/high control.

  plugins/tmaegis-plugin-jira.py

• notify-webhookOfficielType: executable

  Sample TMAegis Executable Plugin

  plugins/tmaegis-plugin-notify-webhook.sh

• slackOfficielType: executable

  TMAegis notifier plugin: posts a scan summary to a Slack incoming webhook.

  plugins/tmaegis-plugin-slack.sh

• telegramOfficielType: executable

  TMAegis notifier plugin: sends a scan summary to a Telegram chat.

  plugins/tmaegis-plugin-telegram.sh

• pci-dss-v4CommunautéType: wasm

  Maps findings to PCI DSS v4.0 requirements. Community plugin: contributions welcome.

  github.com/tmaegis/plugin-pci-dss