文档中心 > 御城河

login(物流)

更新时间:2017/06/02 访问次数:3684

登录日志(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账号名可能重复)。可选账号格式:
(1)公司名:用户ID;

(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":"错误描述"

}

FAQ

关于此文档暂时还没有FAQ
返回
顶部