Python IAST エージェントの配置

このトピックでは、Web サーバーに Python IAST エージェントを配置する方法について説明します。

手順

  1. ASoC Python IAST エージェントをダウンロードします。
    1. ここに記載されている手順に従って、エージェントをダウンロードします。
  2. ZIP ファイルの抽出:
    1. ダウンロードしたファイルを展開してファイルの内容にアクセスします。
  3. IAST エージェントの配置:
    インストール・スクリプトを実行します。
    install_secagent.py

    インストールが完了したら、次が実行されます。

    1. Python site-packages ディレクトリーに secagent フォルダーを作成します。
    2. secagent フォルダーに asoc-config フォルダーを作成します。
    3. site-packages ディレクトリーに .pth ファイルを作成します。
  4. 以下のいずれかのオプションを使用して Python エージェントを実行します。
    • ラッパー (プロセスごとのオプトインに推奨)
    • 環境変数 (すべての Python プロセスに対して自動)
    • sitecustomize (すべての Python プロセスに対して自動)
    サポートされる環境: Python 3.10+ と Flask。

ラッパーを使用した Python エージェントの実行

このタスクについて

プロセス単位 (オプトイン) でエージェントを有効にするには、ラッパーを使用して、既存のコマンドを更新してアプリケーションを起動します。これは特定の Python プロセスのエージェントのみをロードし、他の Python アプリケーションには影響しません。

例:

手順

  1. python app.py の代わりに secagent python app.py を実行します。
  2. python -m flask run の代わりに secagent python -m flask run を実行します。

タスクの結果

ラッパー:
  • SECAGENT_ENABLE 環境変数を設定します。
  • エージェントを開始します。
  • アプリケーションを実行します。

環境変数を使用した Python エージェントの実行

このタスクについて

Python プロセスを開始する前に、必要な環境変数を設定します。これにより、その環境で起動されたすべての Python アプリケーションのエージェントが自動的にロードされます。

手順

  1. 環境変数を設定します。 SECAGENT_ENABLE=true
  2. 次に、アプリケーションを通常どおり起動します (ラッパーなし): python app.py

タスクの結果

  • エージェントは自動的に有効になります。
  • この環境変数を設定して起動したすべての Python プロセスに適用されます。

sitecustomize を使用した Python エージェントの実行

このタスクについて

sitecustomize を使用して、スタートアップ構成をすべての Python プロセスに自動的に適用します。sitecustomize がsys.path 上で利用可能な場合、Python は初期化中にそれをインポートします。これにより、個々のスクリプトを変更することなく、環境のデフォルトを設定したり、プロキシーや証明書を構成したり、その他のグローバル設定を適用したりできます。

手順

  1. 実行: Sitecustomize-install。
  2. 次に、アプリケーションを通常どおり起動します (ラッパーなし)。python app.py。

タスクの結果

インストーラーを実行したら、次が実行されます。
  • sitecustomize.py をメインの site-packages ディレクトリーにコピーします。
  • エージェントはすべての Python プロセスに対して自動的にロードされます。