文档中心 > 御城河

登录日志

更新时间：2023/08/29 访问次数：40046

建议采用异步的HTTP GET或POST(application/x-www-form-urlencoded)请求方式

设定合理的调用超时时间。如果在指定的时间内没有返回，结束HTTP请求。


应用应保存用户的登录日志，并回传御城河平台用以日常信息审计。

日志回传字段：


日志接口:http://gw.ose.aliyun.com/event/Login

参数

类型

是否必须

描述

userId

string

Y

接入方帐号体系中的用户ID或者用户名，需保证唯一性（例如不同系统的admin账号名可能重复）。可选账号格式：
(1)公司名：子账号；
(2)如果登陆账号在应用的账号系统中唯一，传登陆实际账号；
(3)独立部署的识别代码：子账号。

userIp

string

Y

该访问请求的客户端IP。如果使用了SLB，客户端IP添加在HTTP访问请求的X-Forwarded-For属性的末尾。如果使用了CWAF，客户端IP放在X-Real-Ip属性。

ati

string

Y

(1)对B/S架构的应用，接入孔明锁后，会在域名下生成一个cookie _ati。在服务器端，可从HTTP请求中获取名称为_ati的cookie的值。
(2)对C/S架构的应用，接入孔明锁后，在客户端自己生成一个标志客户端的SID，然后访问服务器时作为_ati发送给服务器端。

topAppKey

string

Y

（1）对于聚石塔ISV接入方，填写TOP应用对应的topAppKey。
（2）对于非聚石塔ISV接入方，如果存在对应开放平台的appkey，填写对应平台的appkey。
（3）对于非聚石塔ISV接入方，且没有开放平台，填写和御城河分配的appKey字段相同的值。
如果存在多个topAppKey，以英文分号分开，如：12345;12345;12347

appName

string

Y

登录的应用名称，可以使用app名字或域名

tid

string

Y

（1）和用户关联的淘宝帐号，如果关联多个帐号，用英文逗号分隔
（2）如果没有关联淘宝帐号，填写可以关联到淘宝帐号的信息，如店铺名。

loginResult

string

Y

登录成功，设置为success；登录失败，设置为fail

loginMessage

string

Y

额外信息，比如失败原因

time

string

Y

整型时间戳，精确到毫秒，1970年01月01日0点中以来的毫秒数。

appKey

string

Y

御城河分配的appKey

sellerNick

string

Y

对应淘系商家主账号昵称，如同一账号对应多个昵称，则以逗号分隔

sign

string

Y

查看日志接入步骤获取sign计算方式

ps：有部分字段进行删改，历史接入的开发者需要进行对应字段调整，请认真核对！

FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
返回
顶部