You need to enable JavaScript to run this app.
导航
用户登录认证
最近更新时间:2025.04.23 10:15:40首次发布时间:2025.04.23 10:15:40
我的收藏
有用
有用
无用
无用

订阅该事件后,当有用户登录认证时(包括认证成功和认证失败),将会触发该事件。

事件结构体

参数

类型

描述

schema

string

事件消息格式版本。当前固定为 1.0

header

object

消息头,包含事件的基础信息。

└ event_id

string

事件 ID,每个消息的事件 ID 唯一。

└ token

string

验证 token,取值与飞连事件订阅的加密策略内设置的 Verification Token 一致,通过验证该值可以确保消息来自飞连。

└ create_time

string

事件发送时间,Unix 时间戳(单位毫秒)。

└ event_type

string

事件类型。当前事件的类型为 auth.v1.login

└ app_id

string

事件回调配置 ID。

data

object

事件数据。

└ events

object[]

事件详细数据列表,支持数组格式。

└└ object

object

事件对象信息。

└└└ auth_time

int

用户完成认证时间的时间戳。

└└└ client_ip

string

请求来源 IP。

└└└ client_os

string

设备操作系统。可能值有 iOS、Android、Mac、Windows、Linux、Harmony、web(浏览器)。

└└└ client_ua

string

请求中的 UA(User-Agent)。

└└└ account

string

登录账号。仅当登录来源(login_source)为 feilian 时该参数有值。

└└└ account_type

string

账号类型。仅当登录来源(login_source)为 feilian,且登录方式(login_type)为密码(password)或动态口令(otp)时,该参数有值。可能值:

  • mobile:手机号
  • email:邮箱
  • userid:员工 ID

└└└ login_source

string

登录来源。根据实际来源返回值,例如,feilian 表示飞连、okta 表示 Okta、aad 表示 Azure AD、custom_oidc 表示自定义 OIDC、custom_cas 表示自定义 CAS。

└└└ login_type

string

登录方式。可能值:

  • password:密码
  • mobile:手机号
  • email:邮箱
  • otp:动态口令
  • scan:扫码
  • quick_login:浏览器快捷登录

└└└ error_type

string

认证失败类型,仅当认证失败时该参数有值。返回值示例 2FA_code_verify_failed,返回值以下划线(_)进行分割,第一段为认证错误信息,例如 1FA(一次认证)、2FA(二次认证)、ChangeInitPassword、ForgetPassword,后半段为具体的错误内容,仅供辅助排查问题使用。

└└└ mfa_type

string

二次认证方式。可能值:

  • password:密码
  • email:邮箱
  • mobile:手机号
  • otp:动态口令

└└└ result

string

认证结果,success 表示成功、failed 表示失败。

└└└ renewal_time

int

登录成功后的登录态有效期,仅当认证成功时该参数有值,单位:秒。

└└└ user_open_id

string

用户 ID。