通过Shell实现MeterSphere Signature签名

发布于 2022年07月19日

编者注:

本文为公众号博主Wolfberry的原创文章。

原文链接:

https://mp.weixin.qq.com/s/4Nj8isNI2l0zInqxSDsvvw

本文将分享在MeterSphere开源持续测试平台中如何通过Shell生成Signature签名,并实现对MeterSphere API的调用操作。

最近在将MeterSphere与DevOps的CI/CD集成起来,主要是通过CI/CD流水线触发MeterSphere中的自动化接口用例和场景用例,第一步需要解决调用API所涉及的鉴权认证。

对于Java的实现,可以参考公众号文章:《在MeterSphere中使用预执行脚本功能生成接口认证签名》。然而在有些情况下,对MeterSphere API的调用需要通过Shell脚本来实现,即通过Shell生成Signature签名并调用接口。

根据上面链接中文章的描述,在通过API调用MeterSphere接口时,需要在请求头中传入accessKey和Signature。其中,accessKey为创建API Key时生成的Access Key,Signature通过如下加密算法得出:

通过Shell生成Signature

除了上述方法,我们还可以通过Shell来生成Signature。对于Shell,显然没有高级语言那样有丰富的类库,但Shell也能通过丰富的Linux命令和工具实现复杂的功能。对于本案例,可以利用OpenSSL命令生成该加密签名:

openssl enc -e -aes-128-cbc -base64 -K <加密密钥> -iv <加密向量>

另外,Shell也能十分便捷地用一条命令就能得到加密字符串所需的13位Unix时间戳,用符号“|” 将accessKey与Unix时间戳连接起来,就可以得到加密字符串。

操作示例

根据指定的MeterSphere项目名称,返回相应的项目ID:

■ 传入accessKey、secretKey、projectName和MeterSphere服务器地址,实时生成Signature:

################## Sample script ######################
#!/bin/bash
accessKey=$1
secretKey=$2
projectName=$3
HOST=$4
 
keySpec=$(echo -n "${secretKey}" | od -A n -t x1 | tr -d ' ')
iv=$(echo -n "${accessKey}" | od -A n -t x1 | tr -d ' ')
 
currentTimeMillis=$[$(date +%s%N)/1000000]
# use currentTimeMillis=$(date +s%000) instead for docker containers built from base image alpine or busybox.
 
seed=${accessKey}\|$currentTimeMillis
signature=$(printf %s "${seed}" | openssl enc -e -aes-128-cbc -base64 -K ${keySpec} -iv ${iv})
 
#Verify the signature by calling API through curl command to get project list.
RESULT=$(curl -k -s -H "accesskey: ${accessKey}" -H "signature: ${signature}" -H "Content-Type: application/json" https://${HOST}/project/listAll)
 
#Format and parse the returned JSON using jq
projectId=$(printf '%s\n' "${RESULT}" | jq '.data[] | select(.name == "'"${projectName}"'")' |jq .id) 
echo "Project ID of ${projectName} is:  ${projectId}"
################## End of the script ######################

■ 执行上述脚本:

$ sh getProjectId.sh <accessKey> <secretKey> <projectName> cloud.metersphere.com

■ 得到返回结果:

Project ID of Sample-Project is:  "e82f625a-aca6-4c72-9ac8-1234567890ms"

这证明接口已能成功调通,对于CI/CD流水线而言,只需将调用的API换成相应的触发测试计划或测试场景的接口即可。在需要的时候,也可以根据MeterSphere的Swagger接口文档,调用其他接口,实现更为强大而丰富的功能。