代码拉取完成，页面将自动刷新
同步操作将从 雷纳科斯/devops-api 强制同步，此操作会覆盖自 Fork 仓库以来所做的任何修改，且无法恢复！！！
确定后同步将在后台操作，完成时将刷新页面，请耐心等待。
Golang + Beego编写, 提供一些开发/运维常见操作的HTTP API接口，提供开发/运维常用操作的HTTP API接口: IP地址查询、工作日节假日判断、微信报警、钉钉报警、2步验证、密码存储、发送邮件、生成随机密码等功能
更多功能,正在思考中...
直接下载二级制文件即可
注意: 如果配置文件app.conf中, security->enableToken 的值是 false, 可以跳过 步骤2 和 步骤3, 默认为true, 如果是false 可以不用在请求头里面添加 DEVOPS-API-TOKEN 头
自定义配置(该步骤可选)
首先初始化, 会生成root token，该root token 管理其他的token(该步骤可选)
./devops-api init
注意: 忘记root token, 可以使用以下重新生成
./devops-api init --refresh-root-token
./devops-api token --create=名称 --root-token=上边的root token
注意：忘记token，重新生成即可
./devops-api server --mode=prod
--mode 指定程序运行模式, prod: 生产模式 dev: 开发模式, 默认是开发模式
也可以在配置文件app.conf中修改 runmode=prod 也可以设置为生产模式
使用生成token就能愉快的访问API了
注意: token必须放到请求头里面,名称必须是: DEVOPS-API-TOKEN
./devops-api --help
./devops-api backup --filepath=备份文件路径
go get github.com/astaxie/beego
go get github.com/robfig/cron
go get gopkg.in/alecthomas/kingpin.v2
go get github.com/satori/go.uuid
go get github.com/sec51/twofactor
go get github.com/tidwall/gjson
go get github.com/chanyipiaomiao/hltool
go get github.com/chanyipiaomiao/weixin-kit
go get github.com/chanyipiaomiao/cal
go get github.com/chanyipiaomiao/ip2region/binding/golang
本功能使用了 狮子的魂 项目提供的IP地址数据库.
首先要执行 script 目录下的 gen_ip_region.sh 脚本, 来下载IP地址数据库, 可以定期执行脚本.
GET /api/v1/queryip?ip=1.1.1.1
ip 要查询的IP地址
返回:
{
"entryType": "query ip",
"errmsg": "",
"ip": "1.1.1.1",
"ipInfo": {
"CityId": 0,
"Country": "中国",
"Region": "0",
"Province": "上海",
"City": "上海",
"ISP": "电信"
},
"requestID": "474b7bbc-a453-45cd-8d01-03f57de22a44",
"statuscode": 0
}
POST /api/v1/holiworkday
设置头部: Content-Type: application/json
内容: 参考下面的模板
节假日和工作日模板json, 每年都要根据国内的放假安排提前做一下设置,毕竟国内放假安排不是固定的,日期不足2位必须补0
workday 是指放假安排中的调整上班的日期
{
"year": "2018",
"holiday": [
{
"name": "yuandan",
"zh_name": "元旦",
"start_time": "2018-01-01",
"end_time": "2018-01-01"
},
{
"name": "chunjie",
"zh_name": "春节",
"start_time": "2018-02-15",
"end_time": "2018-02-21"
},
{
"name": "qingming",
"zh_name": "清明节",
"start_time": "2018-04-05",
"end_time": "2018-04-07"
},
{
"name": "laodong",
"zh_name": "劳动节",
"start_time": "2018-04-29",
"end_time": "2018-05-01"
},
{
"name": "duanwu",
"zh_name": "端午节",
"start_time": "2018-06-16",
"end_time": "2018-06-18"
},
{
"name": "zhongqiu",
"zh_name": "中秋节",
"start_time": "2018-09-22",
"end_time": "2018-09-24"
},
{
"name": "guoqing",
"zh_name": "国庆节",
"start_time": "2018-10-01",
"end_time": "2018-10-07"
}
],
"workday": [
"2018-02-11",
"2018-02-24",
"2018-04-08",
"2018-04-28",
"2018-09-29",
"2018-09-30"
]
}
GET /api/v1/holiworkday?date=2018-10-08
date: 判断的日期, 日期格式不足2位必须补0
返回:
{
"date": "2018-10-08",
"dateType": "workday",
"entryType": "judgment holiday/workday",
"errmsg": "",
"requestID": "2a0cb77a-f622-4f75-b5e4-e574c015f6f6",
"statuscode": 0
}
dateType: 有3种 workday: 工作日 holiday: 节假日 weekend: 周末
点击查看设置微信报警流程
还需要在 conf/app.conf 中配置已下3个参数
这3个参数可以在企业微信后台管理页面可以看到，详情可以查看上面的文档。
POST /api/v1/sendmsg/weixin
msgType: text 消息类型,目前只支持文本消息
toTag: 标签ID 在企业微信后台可以查看到
toUser： 用户ID 在企业微信后台可以查看到
toParty: 部门ID 在企业微信后台可以查看到
msg： 要发送的消息
需要在conf/app.conf 配置钉钉机器人的URL，或者是在POST中传递url参数指定钉钉机器人地址
POST /api/v1/sendmsg/dingding
msgType： text|markdown
msg: 要发送的消息
title: 发送markdown消息时需要指定此参数，指定标题
url: 可以指定钉钉机器人的URL，这样就不用在conf/app.conf 配置钉钉机器人的URL
注意: 在发送markdown消息时，markdown的语法可以查看官方文档
2步验证,可以方便的集成到系统中,只需要调用3个API即可.
GET /api/v1/twostepauth/enable?username=用户名&issuer=发行者
username email或者是用户名
issuer 可以是比如 公司的域名/公司的代号等
返回结果:
{
"enable": true,
"key": "656C7AAU556TAMNONWZXLPEYTCXR3QE2",
"qrImage": "/static/download/qr/lei.he.png",
"requestId": "ee3145bf-c329-4830-947b-69ef74a269f5",
"statuscode": 0
}
enable 启用成功
qrImage 2步验证 二维码图片路径
key 没办法扫描二维码时可以手动添加
statuscode 返回0,代表成功,其他失败
POST /api/v1/twostepauth/auth
username: 用户名
issuer: 发行者
token: 6位数字的验证码
返回结果:
{
"auth": true,
"requestId": "2f9aa9b5-2c02-4c7f-af4e-3c1d931eb7aa",
"statuscode": 0,
"username": "lei.he"
}
auth: 验证成功true, 不成功false
GET /api/v1/twostepauth/disable?username=用户名
返回结果:
{
"disable": true,
"requestId": "4f73c93c-ae99-4582-81b1-81ce75133599",
"statuscode": 0,
"username": "lei.he"
}
disable 禁用成功,删除二维码图片,从数据库中删除该用户
POST /api/v1/storepass/update
设置头部: Content-Type: application/json
请求体内容格式:
{
"uniqueId": "10.10.1.2",
"password": [
{"name": "root", "password": "444"},
{"name": "user1", "password": "333"}
]
}
uniqueId 唯一标识
注意字段名称必须是以上格式
返回结果:
{
"requestID": "13b4dc78-7f28-4477-a7c6-e319cb1c00ea",
"statuscode": 0,
"update": true
}
GET /api/v1/storepass/get?id=10.10.1.2,1.1.1.1
多个标识逗号分开
返回结果:
{
"get": true,
"password": {
"1.1.1.1": {},
"10.10.1.2": {
"root": "444",
"user1": "333"
}
},
"requestID": "35ce7716-2721-4c0b-82ee-f258fdb9a6c1",
"statuscode": 0
}
1.1.1.1 在数据库中不存在则返回的是空
GET /api/v1/storepass/delete?id=10.10.1.2,1.1.1.1
如果请求的标识在数据库中不存从则返回空
返回结果:
{
"delete": true,
"id": "10.10.1.2,1.1.1.1",
"requestID": "562ca3e3-52bd-43ff-8ba2-09b20b928baa",
"statuscode": 0
}
POST /api/v1/sendmsg/mail
curl -X POST \
http://127.0.0.1:8080/api/v1/sendmsg/mail \
-H 'DEVOPS-API-TOKEN: 生成Token' \
-H 'content-type: multipart/form-data' \
-F subject=haha \
-F 'content=测试一下哈' \
-F type=text/plain \
-F to=xxxx@qq.com,xxx@163.com \
-F cc=xxxx@qq.com,xxx@163.com \
-F 'attach=@C:\Users\41176\Desktop\1111.txt' \
-F isattach=true
记得安装 requests
pip install requests
import requests
url = "http://127.0.0.1:8080/api/v1/sendmsg/mail"
token = "生成的Token"
headers = {'DEVOPS-API-TOKEN': token}
payload = {
"subject": u"测试邮件",
"content": u"测试邮件内容", # u"<h1>测试邮件内容</h1>",
"type": "text/plain", # "text/html"
"to": "xxxx@qq.com,xxx@163.com",
"cc": "xxxx@qq.com,xxx@163.com",
}
response = requests.post(url, data=payload, headers=headers)
print(response.json())
import requests
url = "http://127.0.0.1:8080/api/v1/sendmsg/mail"
token = "生成的Token"
payload = {
"subject": u"测试邮件",
"content": u"测试邮件内容",
"type": "text/plain",
"to": "xxxx@qq.com",
"cc": "xxxx@163.com",
"isattach": "true"
}
headers = {'DEVOPS-API-TOKEN': token}
files = {'attach': open('文件的路径', 'rb')} # 键名必须是 attach
response = requests.post(url, data=payload, headers=headers, files=files)
print(response.json())
记得安装 grequests
go get github.com/levigross/grequests
package main
import (
"log"
"github.com/levigross/grequests"
)
func main() {
url := "http://127.0.0.1:8080/api/v1/sendmsg/mail"
token := "生成的Token"
o := &grequests.RequestOptions{
Headers: map[string]string{
"DEVOPS-API-TOKEN": token,
},
Data: map[string]string{
"subject": "测试邮件",
"content": "测试邮件内容", // <h1>测试邮件内容</h1>
"type": "text/plain", // text/html
"to": "xxxx@qq.com,xxx@163.com",
"cc": "xxxx@qq.com,xxx@163.com",
},
}
resp, err := grequests.Post(url, o)
if err != nil {
log.Fatalln("Unable to make request: ", err)
}
log.Println(resp.String())
}
package main
import (
"log"
"os"
"github.com/levigross/grequests"
)
func main() {
url := "http://127.0.0.1:8080/api/v1/sendmsg/mail"
token := "生成的token"
fd, err := os.Open("文件路径")
if err != nil {
log.Fatalln("open file error: ", err)
}
o := &grequests.RequestOptions{
Headers: map[string]string{
"DEVOPS-API-TOKEN": token,
},
Data: map[string]string{
"subject": "测试邮件",
"content": "测试邮件内容",
"type": "text/plain",
"to": "xxx@qq.com",
"cc": "xxxx@163.com",
"isattach": "true",
},
Files: []grequests.FileUpload{
grequests.FileUpload{
FileName: "上传之后生成的文件名",
FileContents: fd,
FieldName: "attach", // FieldName 必须是 attach
},
},
}
resp, err := grequests.Post(url, o)
if err != nil {
log.Fatalln("Unable to make request: ", err)
}
log.Println(resp.String())
}
GET /api/v1/password/generation
生成随机密码 默认32位, 可以添加如下参数
curl http://127.0.0.1:8080/api/v1/password/generation?length=64 \
-H 'DEVOPS-API-TOKEN: 生成的Token'
export DEVOPS_API_TOKEN=生成的Token
Linux
alias genpwd="curl -H \"DEVOPS-API-TOKEN: ${DEVOPS_API_TOKEN}\" http://127.0.0.1:8080/api/v1/password/generation?length=64;echo"
alias genpwdspecial="curl -H \"DEVOPS-API-TOKEN: ${DEVOPS_API_TOKEN}\" http://127.0.0.1:8080/api/v1/password/generation?length=64&specialChar=yes;echo"
Mac 可能需要把?=&转义一下
alias genpwd="curl -H \"DEVOPS-API-TOKEN: ${DEVOPS_API_TOKEN}\" http://127.0.0.1:8080/api/v1/password/generation\?length\=64;echo"
alias genpwdspecial="curl -H \"DEVOPS-API-TOKEN: ${DEVOPS_API_TOKEN}\" http://127.0.0.1:8080/api/v1/password/generation\?length\=64\&specialChar\=yes;echo"
import requests
import pprint
url = "http://127.0.0.1:8080/api/v1/password/generation"
token = "生成的Token"
payload = {
"length": 64, # 指定密码长度
"name": "user1,user2,user3", # 可以为多个名称生成密码
"specialChar": "yes" # 密码中是否带有特殊字符
}
headers = {'DEVOPS-API-TOKEN': token}
response = requests.get(url, params=payload, headers=headers)
pprint.pprint(response.json())
package main
import (
"log"
"github.com/levigross/grequests"
)
func main() {
url := "http://127.0.0.1:8080/api/v1/password/generation"
token := "生成的Token"
o := &grequests.RequestOptions{
Headers: map[string]string{
"DEVOPS-API-TOKEN": token,
},
Params: map[string]string{
"length": "64", // 指定密码长度
"name": "user1,user2,user3", // 可以为多个名称生成密码
"specialChar": "yes", // 密码中是否带有特殊字符
},
}
resp, err := grequests.Get(url, o)
if err != nil {
log.Fatalln("Unable to make request: ", err)
}
log.Println(resp.String())
}
GET /api/v1/md5?string=123456
可以写一个shell脚本命令行传入字符串，返回MD5值
GET /api/v1/password/manualGenAuthPassword
手动生成验证密码，该功能是 生成一个32位的密码，然后通过钉钉或者邮件通知，别人可以拿这个密码到本程序验证是否正确，这个密码也会定时的清除，不会一直生效 执行成功返回 {"manualGenAuthPassword": true}
POST /api/v1/password/authPassword
验证密码是否正确，就上一个API生成的密码, 参数: password 执行成功返回 {"auth", true}
GET /version
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。