登录日志(login)接口
http://account.ose.aliyun.com/express/login
登录日志可以帮助我们分析帐号有关的风险。当用户有登录动作时,发送用户登录信息,不管成功或失败,都要发送。登录日志需要实时发送。
参数 |
类型 |
是否必须 |
描述 |
appId |
string |
Y |
御城河应用标识,和御城河appKey 值一样 |
appKey |
string |
Y |
御城河分配的appKey |
sign |
string | Y | API调用签名 |
time |
string |
Y |
支持两种格式:(1)整型时间戳,精确到毫秒,1970年01月01日0点中以来的毫秒数。(2)yyyy-MM-dd HH:mm:ss格式的字符串 |
operation_time |
string |
Y |
yyyy-MM-dd HH:mm:ss格式的字符串 |
company |
string |
Y |
公司名全称 |
station_id |
string |
Y |
站点id |
station |
string |
Y |
站点名称,例如:xxx 数据中心 |
province |
string |
Y |
站点所在省份 |
city |
string |
Y |
站点所在城市 |
user_id |
string |
Y |
接入方帐号体系中的用户ID,需保证唯一性(例如不同系统的admin账号名可能重复)。可选账号格式: (2)如果登陆账号在应用的账号系统中唯一,传登陆用户ID; (3)独立部署的识别代码:用户ID。 |
user |
string |
Y |
用户账号名称 |
source_type |
string |
Y |
发起请求的终端应用类型:web、client、ios、android、database |
source_application |
string |
Y |
发起请求的应用,如果是从数据库直接登陆数据库(source_type=Database),则记数据库名。如果是登陆系统,记录发起登录请求的应用(source_type=web、client、ios 或android),若有跳转或通过单点登录方式登录,记录跳转前的应用名称;否则source_application 应和target_application 一致。 |
source_public_ip |
string | Y | 登陆操作源公网IP,如果请求通过公网,记录来源的公网IP,如:xxx.xxx.xxx.xxx |
source_private_ip |
string | Y | 登陆操作源内网IP,如果使用了NAT 转换,记录内网IP,如:192.168.xxx.xxx |
source_vpn_ip |
string | Y | 登陆操作源VPN IP,如果使用了vpn,使用vpn 分配的IP,如:192.168.xxx.xxx |
source_mac |
string | N | 源MAC 地址,如果是CS 架构则记录,BS 架构无需记录 |
target_public_ip |
string | Y | 登陆目标端公网IP,如果通过公网访问目标,记录目标的公网IP。如:xxx.xxx.xxx.xxx |
target_private_ip |
string | Y | 登陆目标端内网IP,如果目标进行了NAT 转换或使用了负载均衡,记录目标的内网IP,如:192.168.xxx.xxx |
target_application |
string |
Y |
登录的目标应用,如果从数据库直接登陆数据库(source_type=Database),则记数据库名。如果登录系统(source_type=web、client、ios 或android),则记录登录的目标系统名称,若有跳转或通过单点登录方式登录,记录跳转后的系统名称;否则target_application 应和source_application 一致。 |
operation_type |
string |
Y |
操作类型,login/logout(两种类型必须记录) |
result |
string |
Y |
操作结果,success/fail(两种类型必须记录) |
reason |
string |
Y |
结果原因,当登录失败,或者退出时记录原因。 例如timeout,password error 等 |
feature |
string |
Y |
预留拓展字段,用键值对记录拓展字段,英文分号隔开 |
返回结果:
1)调用成功时,返回:
{
"result":"success",
"errMsg":""
}
2)调用失败时,返回:
{
"result":"fail",
"errMsg":"错误描述"
}