基于python的api到stonesoft安全管理中心
smc-python的Python项目详细描述
smc python
基于python的库提供与 StoneSoft管理中心API。提供自动化功能 任何与SMC远程交互的环境。
使用smc python api获得的一些功能:
- 创建任何引擎类型;单防火墙、群集防火墙、IPS 引擎、第2层防火墙、主引擎和虚拟引擎。
- 引擎操作,如启用/禁用AV、GTI、默认NAT, 联系地址等
- 接口配置
- 路由配置(ospf、bgp、静态、防拖)
- 引擎级命令,如重新启动、脱机、策略推送, 启用/禁用ssh等。
- 创建和修改所有网络元素对象,如主机、网络、 地址范围、域名等
- 第3层防火墙的策略控制(创建规则、删除规则) 政策
- VPN策略控制和创建
- 管理/日志服务器设置配置
- 管理用户创建和修改
- 系统级控件;更新系统包,更新引擎,全局 列入黑名单等
- 任务
- 按名称、Href和按筛选器搜索任何对象类型的操作
- 按类型查看所有对象的集合界面
要求
python 2.7版
python 3.5、3.6版
请求>;=2.12.0
安全管理中心版本6.0、6.1、6.1.1、6.1.2、6.2、6.2.1、6.3.x
入门
安装软件包
使用pip获取最新版本:
pip安装 smc python
具体版本:
pip安装 smc python>;=0.5.8
来自Git:
pip install git+https://github.com/gabstopper/smc python.git
或者下载最新的tarball: smc python , 解压缩并运行:
python setup.py安装
分支
从0.6.2版开始,主分支将是发布的版本代码库。此版本还将在 皮皮 开发分支用于进行中的更新,并将在发布时合并到主分支中。
如果安装Develop分支,请使用以下命令:
pip安装 git+https://github.com/gabstopper/smc python.git@develop
测试
包括各种测试示例脚本,它们利用api 在/示例中执行各种任务
基本知识
在运行任何命令之前,必须获取登录会话。一次 命令完成后,调用 session.logout() 删除活动会话。 要获取API_密钥,请登录StoneSoft管理中心并 创建API客户端以适当的特权。
fromsmcimportsessionsession.login(url='http://1.1.1.1:8082',api_key='xxxxxxxxxxxxx')....dostuff....session.logout()
或者登录到特定的管理域并使用 API:
session.login(url='http://1.1.1.1:8082',api_key='xxxxxxxxxxxxx',domain=mydomain,api_version=6.2)....dostuff....session.logout()
一旦获得有效会话,它将被重新用于每个操作 在会话有效期内,或直到程序 退出。
扩展名
smc python可以使用扩展,除了提供 在基本库中提供。分机分开,因为它们可能需要额外的 包装要求和简化包装。
扩展将需要smc python来运行,但是可以安装扩展 直接获取所需的smc python版本。
可用扩展名:
- smc python监视 :监视smc连接、黑名单、用户、vpn、警报等。此外,此包还提供了"订阅"管理事件修改的功能。
smc python扩展的安装示例:
pip安装 smc python监控
扩展作为命名空间包在基本的smc python存储库中,每个扩展都位于这个基本包的子目录中。
请参阅上面的"阅读文档"文档以获得完整的解释 以及有关可用API类的技术参考。