获得API密匙
API密钥API是表示帐户中出现的最流行密钥的端点。
URL
https://REGION.rest.logs.insight.rapid7.com/management/organizations/apikeys区域是您的帐户所在的数据中心,例如。"us","eu", "ca"或"au"。
方法:
得到
身份验证
所有者或读写密钥是必需的。
成功的回应:
响应代码:
- 存在的、未过期的和活动的API密钥为200。
- 404用于不匹配的API密钥参数和已验证的API密钥。
内容:
json
1
{
2
“apikey”:[
3.
{
4
“id”:“181 c9a30-xxxx-4c7d-af1a-xxxxxxxxxxxx”,
5
“api_key”:“00112233 - 4455 - 6677 - 8899 - aabbccddeeff’”,
6
“acl_type”:“ReadOnly”,
7
“apilimits”:{
8
“默认”:500,
9
“管理”:1500,
10
“查询”:1500
11
},
12
“过期”:零,
13
“活跃”:真正的
14
},
15
{
16
“id”:“xxxxxxxx-0bd9-xxxx-8eaa-xxxxxxxxxxxx”,
17
“api_key”:“xxxxxxxxx-fa82-xxxx-xxxx-b7db2c3fa542”,
18
“acl_type”:“读写”,
19
“apilimits”:{
20.
“默认”:500,
21
“管理”:1500,
22
“查询”:1500
23
},
24
“过期”:零,
25
“活跃”:真正的
26
}
27
]
28
}
地点:
关键 |
关于 |
例子 |
|---|---|---|
id |
URL中用于获取此资源的API密钥id |
“id”:“181 c9a30-xxxx-4c7d-af1a-xxxxxxxxxxxx” |
api_key |
实际的API密钥 |
:“api_key xxxxxxxx-dca9-xxxx-ae4f-a5432fc3aafc”, |
acl_type |
与此密钥关联的acl类型-所有者、ReadWrite或ReadOnly |
“acl_type”:“ReadOnly”, |
apilimits |
由name:value对组成,其中name是management或query或任何具有特定限制的其他api端点 |
" apilimits ": { |
到期 |
创建时设置,验证时检查 |
“到期”:空, |
活跃的 |
如果密钥仍然有效,则为True(如果禁用,则为false) |
“活跃”:真的 |
注意:
- 对于所有者密钥,实际的api_key永远不会返回。
示例调用
python
1
进口请求
2
进口json
3.
进口时间
4
5
API_KEY=“xxxxxxxxx——fa82 - xxxx - 8422 b7db2c3fa542”
6
7
defhandle_response(分别地):
8
响应=分别地
9
时间.睡眠(1)
10
如果响应.status_code==200:
11
打印json.转储(分别地.json(),缩进=4)
12
其他的:
13
打印响应.status_code
14
15
defmake_request(provided_url=没有一个):
16
头={“x-api-key”:API_KEY}
17
18
url=“https://rest.logentries.com/management/organizations/apikeys”
19
要求的事情=请求.得到(url,头=头)
20.
返回要求的事情
21
22
23
defget_log():
24
要求的事情=make_request()
25
handle_response(要求的事情)
26
27
def开始():
28
get_log()
29
30.
如果__name__==“__main__ ':
31
开始()
这个页面对你有帮助吗?