跳到主要内容
版本：1.8.7

Python Agent

配置文件​

参数表​

参数名说明类型可选参数预设值
project.name设置项目名称String名称保证唯一Demo Project
project.version设置项目版本String应用版本号V1.0.0
iast.server.token切换 Agent 所属用户String洞态 IAST 用户 Token
iast.server.url洞态 IAST 服务部署地址StringURL 格式
iast.server.intervalAgent 存活心跳，数据上报间隔时间Integer5 - 120 (秒)10
engine.name引擎名称String引擎名称
engine.version引擎版本String引擎版本号v1.3.0
debug开启后会在日志记录 Agent 详细运转日志Booleantrue or falsefalse
log.log_path指定日志文件所在目录String任意有读写权限的目录./dongtai_py_agent.log

用例​

默认配置文件：../../dongtai_agent_python/config.json

默认配置文件内容

../../dongtai_agent_python/config.json
{
    "debug":false,
    "iast":{ 
        "server":{ 
            "token":"1f6b1......................b55berere",
            "url":"https://iast-test.huoxian.cn/openapi"
        },
        "service":{
            "report":{
                "interval":5
            } 
        },  
    },
    "project":{
        "name":"Demo Project",
        "version":""
    },
    "engine":{
        "version":"v1.3.0",
        "name":"c7034af3..................46e947dc"
    }, 
    "log":{
        "log_path":"./dongtai_py_agent.log"
    }
}

环境变量配置​

info

配置环境变量，优先级高于 Agent 配置文件

参数​

参数名说明类型可选参数预设值
PROJECT_NAME设置项目名称String名称保证唯一Demo Project
PROJECT_VERSION 设置项目版本String应用版本号V1.0.0
AUTO_CREATE_PROJECT自动创建项目String1：开启，0：关闭0
ENGINE_NAME引擎名称String引擎名称
DEBUG开启后会在日志记录 Agent 详细运转日志Booleantrue or falsefalse
LOG_PATH指定日志文件所在目录String任意有读写权限的目录./dongtai_py_agent.log

用例​

  • 从洞态 Server 页面下载 python-agent。

  • 安装 python-agent。

    pip3  install ./dongtai-agent-python.tar.gz

  • 通过环境变量配置项目名称、项目版本号。

    export  PROJECT_NAME=<application name>

    #按需添加PROJECT_VERSION、AUTO_CREATE_PROJECT、DEBUG、LOG_PATH，例：
    export  PROJECT_VERSION=<application version>