前言
最近在开发一个基于Nessus的自动化漏扫工具，来和大家分析一下关于Nessus API的使用心得。
Nessus提供了非常完善的API，可以帮助我们实现很多事情，无论是对接其他运维系统，还是用来编写自动化的漏扫工具都十分方便。
Nessus为这些api提供了详细的文档，你可以在Settings->My Account->API Keys->API documentation里看到。
当然，你也可以直接在url后面加上‘api’来访问，像这样https://localhost:8834/api
一、登录
无论是发起一次扫描，还是获取扫描的结果，首先都需要进行登录，nessus在这里提供了两种登录方式。相关内容可以在API文档的https://localhost:8834/api#/resources/session条目中找到。
1、session create
第一种方式是使用Nessus的用户名密码,使用**/session接口：
POST /session
向/session**接口发送post请求，请求的payload参数为用户名和密码。代码如下：
1# coding=utf-8 2import requests 3import json 4def login_create(): 5 # 登录成功则返回token，否则返回空 6 token = '' 7 # 调用/session接口 8 url = "https://localhost:8834/session" 9 # nessus的用户名密码作为post的payload 10 data = { 11 'username': 'admin', 12 'password': 'admin' 13 } 14 # 发送请求 15 respon = requests.post(url, data=data, verify=False) 16 # 如果请求成功则返回token值 17 if respon.status_code == 200: 18 # 返回值是一个json字符串，用json.loads解析成字典取值 19 token = json.loads(respon.text)['token'] 20 return token
若用户名和密码正确，/session接口会返回一个token，将这个token放入请求的头信息中，之后的请求中带上这个头信息就可以使用了。举一个例子：
1def get_scans_list(): 2 # 返回结果 3 result = '' 4 # 首先获取一下token 5 token = login_create() 6 if token != '': 7 # 调用/folders接口 8 url = "https://localhost:8834/scans" 9 # 组装一个请求的头,把刚刚拿到的token放入请求头 10 header = {'X-Cookie': 'token={token};'.format(token=token), 11 'Content-type': 'application/json', 12 'Accept': 'text/plain'} 13 respon = requests.get(url, headers=header, verify=False) 14 # 请求成功，则返回结果，否则返回空值 15 if respon.status_code == 200: 16 result = json.loads(respon.text) 17 return result
2、API Key
除了使用用户名密码的方式，Nessus还提供了API key的方式，只需将Nessus生成的accessKey和secretKey放入请求头信息中即可。之后的例子都会使用API key的方式来调用。
API key可以通过Settings->My Account->API Keys->Generate获取
还是用get_scans_list做例子：
1def get_scans_list(): 2 # 返回结果 3 result = '' 4 # 调用/folders接口 5 url = "https://localhost:8834/scans" 6 # Nessus生成的API key 7 accesskey = 'b901cfe7e184801952db08795fa23f48f1f6c50732f0765e229975354aa58f92' 8 secretkey = '860ad22d0536dd8fd88d3f93901d78cfe4cbc4dbd37bc17ba72a7e989f160739' 9 # 组装请求头 10 header = {'X-ApiKeys': 'accessKey={accesskey};secretKey={secretkey}'.format(accesskey=accesskey, secretkey=secretkey), 11 'Content-type': 'application/json', 12 'Accept': 'text/plain'} 13 respon = requests.get(url, headers=header, verify=False) 14 # 请求成功，则返回结果，否则返回空值 15 if respon.status_code == 200: 16 result = json.loads(respon.text) 17 return result
二、开始一次扫描
1、定位扫描任务
发起扫描的API接口为：
POST /scans/{scan_id}/launch
可以看到，进行扫描需要提供一个scan_id。如何获取scan_id呢？
这里给大家分享一种利用任务名获取scan_id的方法。
首先，利用接口/scans接口获取一个所有任务的列表，可以参看刚才的**get_scans_list()**函数，这里就不重复了，让我们看一下它的返回值，可以看到返回值中有一个sacns的字典列表, 里面有name和id这两个字段
1{ 2 "folders": [ 3 folder Resource 4 ], 5 "scans": [ 6 { 7 "id": {integer}, 8 … 9 "name": {string}, 10 … 11 } 12 ], 13 "timestamp": {integer} 14}
注：scans列表中大部分内容我都隐去了，具体的内容大家可以参看:
https://localhost:8834/api#/resources/scans/list：
接下来我们首先确定任务名
然后遍历任务列表，获取指定任务的ID，代码如下：
1def get_scan_id(scanname): 2 # 任务ID 3 scan_id = 0 4 # 获取任务列表 5 scans_list = get_scans_list()['scans'] 6 if scans_list != '': 7 # 遍历任务列表 8 for scan in scans_list: 9 # 判断是否是指定的任务 10 if scan['name'] == scanname: 11 scan_id = scan['id'] 12 break 13 # 如果未找到，则返回0 14 return scan_id
由于不同的文件夹下允许存在同名的任务，所以为了更精确的定位任务，也可以加入folder_id来查询，调用接口**/scan**时加入查询字符串folder_id=3即可。folder_id也可以用和scan_id相同的方法获取，大家可以自己试一下。
2、发起任务
有了scan_id，我们就可以使用**/scans/{scan_id}/launch**接口来发起一个任务了。
另外这个接口需要用POST方法调用，扫描的目标需要放在请求的payload里。代码如下：
1# iplist为扫描目标IP的列表 2 def scan_luanch(iplist): 3 # header信息在全局变量中，之后的实例中将不再重复 4 # 调用/scans/{scan_id}/launch 5 url = 'https://localhost:8834/scans/{scan_id}/launch'.format(scan_id=get_scan_id('default')) 6 # 扫描目标放在请求的payload里 7 data = { 8 'alt_targets': iplist 9 } 10 # 发送请求 11 respon = requests.post(url, headers=header, data=data, verify=False) 12 # 是否请求成功 13 if respon.status_code == 200: 14 return True 15 else: 16 return False
我们可以调用一下scan_launch()看看效果
scan_luanch(['1.1.1.0', '1.1.1.1'])
可以看到我们已经成功的发起了一次任务了。
至此我们就完成了登录和发起任务的工作，之后还有许多内容可以完善，例如监听任务状态，获取任务结果，以及动态创建任务等，将在后续的文章中为大家分享。
本文转自 https://blog.csdn.net/u013578500/article/details/78702532，如有侵权，请联系删除。