通过API与Palo Alto Networks设备交互的框架
pan-os-python的Python项目详细描述
Palo Alto Networks用于Python的PAN-OS SDK
PAN-ossdkforpython(panospython)是一个帮助与交互的包 Palo Alto Networks设备(包括物理和虚拟化下一代 防火墙和全景)。pan os python SDK是面向对象的和模仿的 通过GUI或CLI/API与设备的传统交互。
特点
- 防火墙对象模型与全景配置
- 多种连接方法,包括全景作为代理
- 所有操作本机支持vsys
- 支持高可用性对和节点故障期间的重试/恢复
- 批处理用户标识操作
- 设备API异常分类
状态
Palo Alto Networks PAN-OS SDK for Python被认为是稳定的。经过充分测试 并在许多生产环境中使用。语义版本控制用于指示 错误修复、新功能和每个版本中的重大更改。
安装
使用pip安装:
pip install pan-os-python
升级至最新版本:
^{pr2}$如果安装了poetry,还可以将pan os python添加到项目中:
poetry add pan-os-python
如何导入
要在项目中使用pan os python,请执行以下操作:
importpanos
您还可以更具体地说明要导入哪些模块:
frompanosimportfirewallfrompanosimportnetwork
几个例子
对于配置任务,请使用中的类创建树结构 每个模块。节点层次结构必须遵循中的模型 Configuration Tree。
以下示例假定模块是这样导入的:
frompanosimportfirewallfrompanosimportnetwork
创建接口并提交:
fw=firewall.Firewall("10.0.0.1",api_username="admin",api_password="admin")eth1=network.EthernetInterface("ethernet1/1",mode="layer3")fw.add(eth1)eth1.create()fw.commit()
操作命令利用设备的“op”方法:
fw=firewall.Firewall("10.0.0.1",api_username="admin",api_password="admin")printfw.op("show system info")
某些操作命令具有刷新对象中变量的方法:
# populates the version, serial, and model variables from the live devicefw.refresh_system_info()
请参阅Usage Guide中的更多示例。
从pandevice升级
这个pan-os-python
包是旧的pandevice
包的演变。到
从pandevice
升级到{
第1步。确保您使用的是python3
Python2 is end-of-life而不是
受pan-os-python
支持。
第二步。卸载pandevice:
pip uninstall pandevice
# or
poetry remove pandevice
第三步。安装pan os python:
pip3 install pan-os-python
# or
poetry add pan-os-python
第4步。将代码中的import语句从pandevice
更改为panos
。例如:
importpandevicefrompandevice.firewallimportFirewall# would change toimportpanosfrompanos.firewallimportFirewall
第5步。测试脚本或应用程序
没有已知的突破性变化
在pandevice v0.14.0
和{
贡献者
- 布莱恩·托雷斯·吉尔-btorresgil
- 加菲猫弗里曼-shinmog
- 约翰·安德森-lampwins
- {a17-^阿迪帕
感谢Kevin Steves,是pan-python library的创建者
- 项目
标签: