数据结构

最近更新时间:2019-06-21 16:11:41

AdInfo

广告信息

被如下接口引用:DescribeScanResults。

名称 类型 描述
Spots Array of PluginInfo 插播广告列表
BoutiqueRecommands Array of PluginInfo 精品推荐广告列表
FloatWindowses Array of PluginInfo 悬浮窗广告列表
Banners Array of PluginInfo banner广告列表
IntegralWalls Array of PluginInfo 积分墙广告列表
NotifyBars Array of PluginInfo 通知栏广告列表

AppDetailInfo

app的详细基础信息

被如下接口引用:DescribeScanResults、DescribeShieldResult。

名称 类型 描述
AppName String app的名称
AppPkgName String app的包名
AppVersion String app的版本号
AppSize Integer app的大小
AppMd5 String app的md5
AppIconUrl String app的图标url
FileName String app的文件名称

AppInfo

提交的app基本信息

被如下接口引用:CreateScanInstances、CreateShieldInstance。

名称 类型 必选 描述
AppUrl String app的url,必须保证不用权限校验就可以下载
AppMd5 String app的md5,需要正确传递
AppSize Integer app的大小
FileName String app的文件名,指定后加固后的文件名是{FileName}_legu.apk
AppPkgName String app的包名,需要正确的传递此字段
AppVersion String app的版本号
AppIconUrl String app的图标url
AppName String app的名称

AppScanSet

扫描后app的信息,包含基本信息和扫描状态信息

被如下接口引用:DescribeScanInstances。

名称 类型 描述
ItemId String 任务唯一标识
AppName String app的名称
AppPkgName String app的包名
AppVersion String app的版本号
AppMd5 String app的md5
AppSize Integer app的大小
ScanCode Integer 扫描结果返回码
TaskStatus Integer 任务状态: 1-已完成,2-处理中,3-处理出错,4-处理超时
TaskTime Integer 提交扫描时间
AppIconUrl String app的图标url
AppSid String 标识唯一该app,主要用于删除
SafeType Integer 安全类型:1-安全软件,2-风险软件,3病毒软件
VulCount Integer 漏洞个数

AppSetInfo

加固后app的信息,包含基本信息和加固信息

被如下接口引用:DescribeShieldInstances。

名称 类型 描述
ItemId String 任务唯一标识
AppName String app的名称
AppPkgName String app的包名
AppVersion String app的版本号
AppMd5 String app的md5
AppSize Integer app的大小
ServiceEdition String 加固服务版本
ShieldCode Integer 加固结果返回码
AppUrl String 加固后的APP下载地址
TaskStatus Integer 任务状态: 1-已完成,2-处理中,3-处理出错,4-处理超时
ClientIp String 请求的客户端ip
TaskTime Integer 提交加固时间
AppIconUrl String app的图标url
ShieldMd5 String 加固后app的md5
ShieldSize Integer 加固后app的大小

BindInfo

用户绑定app的基本信息

被如下接口引用:DescribeResourceInstances、DescribeShieldPlanInstance。

名称 类型 描述
AppIconUrl String app的icon的url
AppName String app的名称
AppPkgName String app的包名

Filter

筛选数据结构

被如下接口引用:DescribeResourceInstances、DescribeScanInstances、DescribeShieldInstances。

名称 类型 必选 描述
Name String 需要过滤的字段
Value String 需要过滤字段的值

PlanDetailInfo

加固策略具体信息

被如下接口引用:DescribeShieldPlanInstance。

名称 类型 描述
IsDefault Integer 默认策略,1为默认,0为非默认
PlanId Integer 策略id
PlanName String 策略名称
PlanInfo PlanInfo 策略信息

PlanInfo

加固策略信息

被如下接口引用:CreateShieldPlanInstance、DescribeShieldPlanInstance。

名称 类型 描述
ApkSizeOpt Integer apk大小优化,0关闭,1开启
Dex Integer Dex加固,0关闭,1开启
So Integer So加固,0关闭,1开启
Bugly Integer 数据收集,0关闭,1开启
AntiRepack Integer 防止重打包,0关闭,1开启
SeperateDex Integer Dex分离,0关闭,1开启
Db Integer 内存保护,0关闭,1开启
DexSig Integer Dex签名校验,0关闭,1开启
SoInfo SoInfo So文件信息
AntiVMP Integer vmp,0关闭,1开启
SoType Array of String 保护so的强度,
AntiLogLeak Integer 防日志泄漏,0关闭,1开启
AntiQemuRoot Integer root检测,0关闭,1开启
AntiAssets Integer 资源防篡改,0关闭,1开启
AntiScreenshot Integer 防止截屏,0关闭,1开启
AntiSSL Integer SSL证书防窃取,0关闭,1开启

PluginInfo

插件信息

被如下接口引用:DescribeScanResults。

名称 类型 描述
PluginType Integer 插件类型,分别为 1-通知栏广告,2-积分墙广告,3-banner广告,4- 悬浮窗图标广告,5-精品推荐列表广告, 6-插播广告
PluginName String 插件名称
PluginDesc String 插件描述

ResourceInfo

拉取某个用户的所有资源信息

被如下接口引用:DescribeResourceInstances。

名称 类型 描述
ResourceId String 用户购买的资源id,全局唯一
Pid Integer 资源的pid,MTP加固-12767,应用加固-12750 MTP反作弊-12766 源代码混淆-12736
CreateTime Integer 购买时间戳
ExpireTime Integer 到期时间戳
IsBind Integer 0-未绑定,1-已绑定
BindInfo BindInfo 用户绑定app的基本信息
ResourceName String 资源名称,如应用加固,漏洞扫描

ResourceServiceInfo

资源服务信息

被如下接口引用:DescribeShieldPlanInstance。

名称 类型 描述
CreateTime Integer 创建时间戳
ExpireTime Integer 到期时间戳
ResourceName String 资源名称,如应用加固,源码混淆

ScanInfo

需要扫描的应用的服务信息

被如下接口引用:CreateScanInstances。

名称 类型 必选 描述
CallbackUrl String 任务处理完成后的反向通知回调地址,批量提交app每扫描完成一个会通知一次,通知为POST请求,post信息{ItemId:
ScanTypes Array of String VULSCAN-漏洞扫描信息,VIRUSSCAN-返回病毒扫描信息, ADSCAN-广告扫描信息,PLUGINSCAN-插件扫描信息,PERMISSION-系统权限信息,SENSITIVE-敏感词信息,可以自由组合

ScanPermissionInfo

安全扫描系统权限信息

被如下接口引用:DescribeScanResults。

名称 类型 描述
Permission String 系统权限

ScanPermissionList

安全扫描系统权限信息

被如下接口引用:DescribeScanResults。

名称 类型 描述
PermissionList Array of ScanPermissionInfo 系统权限信息

ScanSensitiveInfo

安全扫描敏感词

被如下接口引用:DescribeScanResults。

名称 类型 描述
WordList Array of String 敏感词
FilePath String 敏感词对应的文件信息
FileSha String 文件sha1值

ScanSensitiveList

安全扫描敏感词列表

被如下接口引用:DescribeScanResults。

名称 类型 描述
SensitiveList Array of ScanSensitiveInfo 敏感词列表

ScanSetInfo

app扫描结果集

被如下接口引用:DescribeScanResults。

名称 类型 描述
TaskStatus Integer 任务状态: 1-已完成,2-处理中,3-处理出错,4-处理超时
AppDetailInfo AppDetailInfo app信息
VirusInfo VirusInfo 病毒信息
VulInfo VulInfo 漏洞信息
AdInfo AdInfo 广告插件信息
TaskTime Integer 提交扫描的时间
StatusCode Integer 状态码,成功返回0,失败返回错误码
StatusDesc String 状态描述
StatusRef String 状态操作指引
PermissionInfo ScanPermissionList 系统权限信息
SensitiveInfo ScanSensitiveList 敏感词列表

ServiceInfo

提交app加固的服务信息

被如下接口引用:CreateShieldInstance。

名称 类型 必选 描述
ServiceEdition String 服务版本,基础版basic,专业版professional,企业版enterprise。
CallbackUrl String 任务处理完成后的反向通知回调地址,如果不需要通知请传递空字符串。通知为POST请求,post包体数据示例{"Response":{"ItemId":"4cdad8fb86f036b06bccb3f58971c306","ShieldCode":0,"ShieldMd5":"78701576793c4a5f04e1c9660de0aa0b","ShieldSize":11997354,"TaskStatus":1,"TaskTime":1539148141}},调用方需要返回如下信息,{"Result":"ok","Reason":"xxxxx"},如果Result字段值不等于ok会继续回调。
SubmitSource String 提交来源 YYB-应用宝 RDM-rdm MC-控制台 MAC_TOOL-mac工具 WIN_TOOL-window工具。
PlanId Integer 加固策略编号,如果不传则使用系统默认加固策略。如果指定的plan不存在会返回错误。

ShieldInfo

加固后app的信息

被如下接口引用:DescribeShieldResult。

名称 类型 描述
ShieldCode Integer 加固结果的返回码
ShieldSize Integer 加固后app的大小
ShieldMd5 String 加固后app的md5
AppUrl String 加固后的APP下载地址,该地址有效期为20分钟,请及时下载
TaskTime Integer 加固的提交时间
ItemId String 任务唯一标识
ServiceEdition String 加固版本,basic基础版,professional专业版,enterprise企业版

ShieldPlanInfo

加固策略信息

被如下接口引用:DescribeShieldPlanInstance。

名称 类型 描述
TotalCount Integer 加固策略数量
PlanSet Array of PlanDetailInfo 加固策略具体信息数组

SoInfo

so加固信息

被如下接口引用:CreateShieldPlanInstance、DescribeShieldPlanInstance。

名称 类型 描述
SoFileNames Array of String so文件列表

VirusInfo

病毒信息

被如下接口引用:DescribeScanResults。

名称 类型 描述
SafeType Integer 软件安全类型,分别为0-未知、 1-安全软件、2-风险软件、3-病毒软件
VirusName String 病毒名称, utf8编码,非病毒时值为空
VirusDesc String 病毒描述,utf8编码,非病毒时值为空

VulInfo

漏洞信息

被如下接口引用:DescribeScanResults。

名称 类型 描述
VulList Array of VulList 漏洞列表
VulFileScore Integer 漏洞文件评分

VulList

漏洞信息

被如下接口引用:DescribeScanResults。

名称 类型 描述
VulId String 漏洞id
VulName String 漏洞名称
VulCode String 漏洞代码
VulDesc String 漏洞描述
VulSolution String 漏洞解决方案
VulSrcType Integer 漏洞来源类别,0默认自身,1第三方插件
VulFilepath String 漏洞位置
RiskLevel Integer 风险级别:1 低风险 ;2中等风险;3 高风险