Skip to main content

用于连接 Tenable 产品和应用程序的 Python 库

项目描述

https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Ftenable%2FpyTenable%2Fbadge&label=build https://img.shields.io/pypi/v/pytenable.svg https://img.shields.io/badge/python-3.6%203.7%203.8%203.9-blue https://img.shields.io/pypi/dm/pytenable https://img.shields.io/github/license/tenable/pyTenable.svg https://sonarcloud.io/api/project_badges/measure?project=tenable_pyTenable&metric=alert_status

pyTenable 旨在成为 Tenable 应用程序 API 的 Python 接口。此外,通过在所有各种应用程序之间提供通用接口和通用结构,我们可以轻松地从某些产品之间完全不同的 API 进行转换。

安装

要将最新发布的版本安装到 pypi,只需通过 pip 安装即可:

pip install pytenable

如果您正在寻找最前沿的技术,请随意直接从 github 存储库安装,如下所示:

pip install git+git://github.com/tenable/pytenable.git#egg=pytenable

入门

假设我们想要获取已在 Tenable.io 应用程序上运行的扫描列表。执行此操作很简单,如下所示:

from tenable.io import TenableIO
tio = TenableIO('TIO_ACCESS_KEY', 'TIO_SECRET_KEY')
for scan in tio.scans.list():
   print('{status}: {id}/{uuid} - {name}'.format(**scan))

Tenable.sc 入门同样简单:

from tenable.sc import TenableSC
sc = TenableSC('SECURITYCENTER_NETWORK_ADDRESS')
sc.login('SC_USERNAME', 'SC_PASSWORD')
for vuln in sc.analysis.vulns():
   print('{ip}:{pluginID}:{pluginName}'.format(**vuln))

有关可用内容的更多详细信息,请参阅 pyTenable 文档

日志记录

为 pyTenable 启用日志记录是通过 python logging 包启用调试日志的简单问题。这里详细介绍了一个简单的示例:

import logging
logging.basicConfig(level=logging.DEBUG)

执照

该项目在 MIT 许可下获得许可。

项目详情