You need to enable JavaScript to run this app.
文档中心
飞连

飞连

复制全文
下载 pdf
认证管理
用户登录认证
复制全文
下载 pdf
用户登录认证

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

事件结构体

参数

类型

描述

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。

数据示例
{
  "schema": "1.0",
  "header": {
    "event_id": "e09288e2-a1b3-4b38-84a8-3c673725xxxx",
    "token": "token-test",
    "create_time": "1740385174957",
    "event_type": "auth.v1.login",
    "app_id": "897957767eda448e9e3c53c6a51dxxxx"
  },
  "data": {
    "events": [
      {
        "object": {
          "account": "xxxx@feilian.local",
          "account_type": "email",
          "auth_time": "1742797448",
          "client_ip": "10.xx.xx.245",
          "client_os": "web",
          "client_ua": "Mozilla/5.0 (iPhone; CPU iPhone OS xxx) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1",
          "login_source": "feilian",
          "login_type": "password",
          "renewal_time": 1728000,
          "result": "success",
          "user_open_id": "ou_0Yopzxxxx",
        }
      }
    ]
  }
}
最近更新时间:2025.09.23 14:24:20
这个页面对您有帮助吗?
有用
有用
无用
无用