Déploiement d'un agent IAST Python

Cette section explique comment créer un type d'agent IAST Python sur votre serveur Web.

Procédure

  1. Téléchargez l'agent IAST Python ASoC :
    1. Suivez les instructions fournies ici pour télécharger l'agent.
  2. Extrayez le fichier ZIP :
    1. Décompressez le fichier téléchargé pour accéder à son contenu.
  3. Déployez l'agent IAST :
    Exécutez le script d'installation :
    install_secagent.py

    Une fois l'installation terminée, le script :

    1. Crée un dossier secagent dans votre répertoire site-packages Python.
    2. Crée un dossier asoc-config dans le dossier secagent.
    3. Crée un fichier .pth dans le répertoire site-packages.
  4. Exécutez l'agent Python à l'aide de l'une des options suivantes :
    Environnement pris en charge : Python 3.10+ avec Flask.

Exécution de l'agent Python avec un encapsuleur

Pourquoi et quand exécuter cette tâche

Pour activer l'agent par processus (inscription), démarrez votre application en utilisant l'encapsuleur et en mettant à jour votre commande existante. Ceci charge l'agent uniquement pour ce processus Python spécifique et n'affecte pas les autres applications Python.

Exemples :

Procédure

  1. Au lieu de python app.py, exécutez secagent python app.py .
  2. Au lieu de python -m flask run, exécutez secagent python -m flask run .

Résultats

L'encapsuleur :
  • Définit la variable d'environnement SECAGENT_ENABLE.
  • démarre l'agent.
  • Exécute votre application.

Exécution de l'agent Python avec une variable d'environnement

Pourquoi et quand exécuter cette tâche

Définissez la variable d'environnement requise avant de démarrer votre processus Python. Ceci charge automatiquement l'agent pour toutes les applications Python démarrées dans cet environnement.

Procédure

  1. Définissez la variable d'environnement : SECAGENT_ENABLE=true
  2. Ensuite, démarrez votre application normalement (sans encapsuleur) : python app.py

Résultats

  • L'agent est activé automatiquement.
  • Il s'applique à tous les processus Python démarrés avec cette variable d'environnement définie.

Exécution de l'agent Python avec sitecustomize

Pourquoi et quand exécuter cette tâche

Utilisez sitecustomize pour appliquer automatiquement la configuration de démarrage à tous les processus Python. Lorsque sitecustomize est disponible sur sys.path, Python l'importe lors de l'initialisation. Cela vous permet de définir les paramètres par défaut de l'environnement, de configurer des proxys ou des certificats et d'appliquer d'autres paramètres globaux sans modifier les scripts individuels.

Procédure

  1. Exécutez la commande suivante : Sitecustomize-install.
  2. Ensuite, démarrez votre application normalement (sans encapsuleur) : python app.py.

Résultats

Une fois le programme d'installation exécuté, celui-ci :
  • Copie sitecustomize.py dans le répertoire site-packages principal.
  • L'agent est automatiquement chargé pour tous les processus Python.