Authing 文档文档
快速开始
概念
使用指南
开发集成 V2 arrow
  • V2 文档
  • V3 文档
元数据
应用集成
身份自动化
加入 APN
开发集成
多租户(内测版)
控制台文档
多租户控制台
租户控制台
Saas 应用 Demo
快速开始
概念
使用指南
开发集成 V2 arrow
  • V2 文档
  • V3 文档
元数据
应用集成
身份自动化
加入 APN
开发集成
多租户(内测版)
控制台文档
多租户控制台
租户控制台
Saas 应用 Demo
旧版
开发集成
  • JavaScript SDK 索引
  • 单点登录(SSO)
  • 登录组件 (Guard)

  • 多因素认证组件(MFA)

  • JavaScript / Node.js

    • 用户认证模块

    • 管理模块

      • 管理用户
      • 管理应用
      • 管理策略
      • 管理角色
      • 管理资源与权限
      • 管理分组
      • 管理组织机构
      • 管理用户自定义字段
      • 管理日志统计信息
      • 管理注册白名单
      • 管理用户池配置
      • 管理 MFA
      • 管理主体认证
      • 管理多租户
      • 管理浏览器指纹
  • Java / Kotlin

  • Python

  • C#

  • PHP

  • Go

  • Ruby
  • Delphi
  • Android

  • iOS

  • Flutter

  • 微信小程序
  • 微信网页授权
  • React Native
  • 框架集成

  • Radius
  • 错误代码
  1. 开发集成
  2. /
  3. JavaScript / Node.js
  4. /
  5. 管理模块
  6. /
  7. 管理浏览器指纹

¶ 管理浏览器指纹

更新时间: 2025-02-18 09:00:47
编辑

此模块主要用来管理 浏览器指纹 相关操作,快速使用浏览器指纹相关数据接口以及功能。

使用方法:

import { ManagementClient } from 'authing-js-sdk'

const managementClient = new ManagementClient({
  userPoolId: 'YOUR_USERPOOL_ID',
  secret: 'YOUR_USERPOOL_SECRET',
})

¶ 管理员设备管理相关功能

¶ 设备管理 - 列表

¶ 参数

  • options.page <int> 分页,获取第几页,默认从 1 开始。
  • options.limit <int> 每页条目数量,默认为 10 个。

¶ 示例

const list = await managementClient.browserFingerprint.getDeviceList(options)
¶ 示例数据
{
    "data": [
      {
        "id": "64a55e45002360ccaaf03a88",
        "name": "chrome/114.0.0.0",//设备名称
        "loginCount": 4, //登录次数
        "os": "Mac OS", //系统
        "pluginsLength": 5, //  浏览器安装插件数量
        "status": "activated", //状态
        "productSub": "20030107", // 浏览器产品其他信息 
        "hks": null, //硬件存储秘钥
        "language": "zh-CN", //语音
        "deviceUniqueId": "4f24fab0d59272eca1365f742d69d9e6", //唯一设备 ID
        "screenWidth": 1920, //显示器宽度
        "metaCreateTime": 1688559173197, //创建时间
        "endTime": null, //挂起结束时间
        "ip": "49.7.66.98", //近登录 IP
        "mimeTypes": "[{\"type\":\"application/pdf\",\"description\":\"Portable Document Format\",\"suffixes\":\"pdf\"},{\"type\":\"text/pdf\",\"description\":\"Portable Document Format\",\"suffixes\":\"pdf\"}]", //浏览器的 MIME 类型数量
        "screenResolutionFingerprint": "72650525657bada16f55bf389ed83e60", //浏览器分辨率
        "webglFingerprint": "f639647c7bbd25bba16201bb4efd9e9e", //显卡及驱动程序指纹
        "description": null, //设备描述
        "onLine": true, //浏览器是否连接到网络
        "meid": null, //设备识别码
        "vendor": "Google", //浏览器厂家信息
        "fontsFingerprint": "6a1c2628518297552aea0012c63767db",  //字体及输入设备特征指纹
        "product": "WebKit",  //浏览器产品名称
        "imei": null, //国际设备识别码
        "canvasFingerprint": "01de172f1e21ac5e5e8b8bd5eafed897",  //2D 图像和动画绘制特征指纹
        "cookie": true, //是否开启 Cookies
        "mod": null, //设备模组
        "producer": null, //设备制造商
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36", //浏览器用户代理
        "audioFingerprint": "baa5294f4f33b5d27d5796b3b63c1f15", //音频设置和硬件特征指纹
        "pluginsFingerprint": "51f39c433a012791fdbdea2159a60068", //浏览器预装插件指纹信息
        "sn": null,  //设备序列号
        "screenHeight": 1080, //显示器高度
        "userAgentFingerprint": "0684c9635cd7939d659c26e58c1fb97c", //浏览器用户代理
        "hor": null, //硬件越狱
        "colorDepth": 24, //屏幕设置色彩位数
        "fde": null, //磁盘加密
        "mimeTypesLength": 2, //浏览器的 MIME 类型数量
        "plugins": "[{\"name\":\"PDF Viewer\",\"description\":\"Portable Document Format\"},{\"name\":\"Chrome PDF Viewer\",\"description\":\"Portable Document Format\"},{\"name\":\"Chromium PDF Viewer\",\"description\":\"Portable Document Format\"},{\"name\":\"Microsoft Edge PDF Viewer\",\"description\":\"Portable Document Format\"},{\"name\":\"WebKit built-in PDF\",\"description\":\"Portable Document Format\"}]", //浏览器安装插件信息列表
        "type": "Browser", //设备类型
        "version": "114.0.0.0", //系统版本
        "appCodeName": "Chrome", //浏览器代码名称
        "loginTime": 1688624246308 //最近活跃时间
    }
    ],
    "totalCount": 2 //数量
}

¶ 设备管理 - 详情

¶ 示例

const list = await managementClient.browserFingerprint.getDeviceDetails('64a55e45002360ccaaf03a88')
¶ 示例数据
 {
    "id": "64a55e45002360ccaaf03a88",
    "name": "chrome/114.0.0.0",//设备名称
    "loginCount": 4, //登录次数
    "os": "Mac OS", //系统
    "pluginsLength": 5, //  浏览器安装插件数量
    "status": "activated", //状态
    "productSub": "20030107", // 浏览器产品其他信息 
    "hks": null, //硬件存储秘钥
    "language": "zh-CN", //语音
    "deviceUniqueId": "4f24fab0d59272eca1365f742d69d9e6", //唯一设备 ID
    "screenWidth": 1920, //显示器宽度
    "metaCreateTime": 1688559173197, //创建时间
    "endTime": null, //挂起结束时间
    "ip": "49.7.66.98", //近登录 IP
    "mimeTypes": "[{\"type\":\"application/pdf\",\"description\":\"Portable Document Format\",\"suffixes\":\"pdf\"},{\"type\":\"text/pdf\",\"description\":\"Portable Document Format\",\"suffixes\":\"pdf\"}]", //浏览器的 MIME 类型数量
    "screenResolutionFingerprint": "72650525657bada16f55bf389ed83e60", //浏览器分辨率
    "webglFingerprint": "f639647c7bbd25bba16201bb4efd9e9e", //显卡及驱动程序指纹
    "description": null, //设备描述
    "onLine": true, //浏览器是否连接到网络
    "meid": null, //设备识别码
    "vendor": "Google", //浏览器厂家信息
    "fontsFingerprint": "6a1c2628518297552aea0012c63767db",  //字体及输入设备特征指纹
    "product": "WebKit",  //浏览器产品名称
    "imei": null, //国际设备识别码
    "canvasFingerprint": "01de172f1e21ac5e5e8b8bd5eafed897",  //2D 图像和动画绘制特征指纹
    "cookie": true, //是否开启 Cookies
    "mod": null, //设备模组
    "producer": null, //设备制造商
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36", //浏览器用户代理
    "audioFingerprint": "baa5294f4f33b5d27d5796b3b63c1f15", //音频设置和硬件特征指纹
    "pluginsFingerprint": "51f39c433a012791fdbdea2159a60068", //浏览器预装插件指纹信息
    "sn": null,  //设备序列号
    "screenHeight": 1080, //显示器高度
    "userAgentFingerprint": "0684c9635cd7939d659c26e58c1fb97c", //浏览器用户代理
    "hor": null, //硬件越狱
    "colorDepth": 24, //屏幕设置色彩位数
    "fde": null, //磁盘加密
    "mimeTypesLength": 2, //浏览器的 MIME 类型数量
    "plugins": "[{\"name\":\"PDF Viewer\",\"description\":\"Portable Document Format\"},{\"name\":\"Chrome PDF Viewer\",\"description\":\"Portable Document Format\"},{\"name\":\"Chromium PDF Viewer\",\"description\":\"Portable Document Format\"},{\"name\":\"Microsoft Edge PDF Viewer\",\"description\":\"Portable Document Format\"},{\"name\":\"WebKit built-in PDF\",\"description\":\"Portable Document Format\"}]", //浏览器安装插件信息列表
    "type": "Browser", //设备类型
    "version": "114.0.0.0", //系统版本
    "appCodeName": "Chrome", //浏览器代码名称
    "loginTime": 1688624246308 //最近活跃时间
  }

¶ 设备管理 - 设备状态

¶ 参数

  • id <string> 当前设备 ID
¶ 示例

const list = await authenticationClient.browserFingerprint.getDeviceStatus('64a53f19e32a3349ab5f2d56')
¶ 示例数据
{
  "status": "activated" // activated
}
¶ 字段 status 说明
值说明
activated已激活,可以使用
suspended挂起
deactivated停用

¶ 设备管理 - 移除设备

¶ 参数

  • id <string> 当前设备 ID

¶ 示例

await managementClient.browserFingerprint.delDevice('64a53f19e32a3349ab5f2d56')

¶ 返回值

boolean : true / false

¶ 设备管理 - 禁用设备

¶ 参数

  • id <string> 当前设备 ID

¶ 示例

await managementClient.browserFingerprint.disableDevice('64a53f19e32a3349ab5f2d56')

¶ 返回值

boolean : true / false

¶ 设备管理 - 启用设备

¶ 参数

  • id <string> 当前设备 ID

¶ 示例

await managementClient.browserFingerprint.enableDevice('64a53f19e32a3349ab5f2d56')

¶ 返回值

boolean : true / false

¶ 设备管理 - 挂起设备

¶ 参数

  • id <string> 当前设备 id
  • timestamp <number> timestamp 挂起结束时间 精确到毫秒

¶ 示例

await managementClient.browserFingerprint.suspendDevice('64a53f19e32a3349ab5f2d56',1689523200000)

¶ 返回值

boolean : true / false

¶ 用户设备管理相关功能

¶ 用户中心 - 设备列表

¶ 参数

  • options.page <int> 分页,获取第几页,默认从 1 开始。
  • options.limit <int> 每页条目数量,默认为 10 个。
  • options.uid <int> 用户id。

¶ 示例

const list = await managementClient.browserFingerprint.getDeviceUserList(options)
¶ 示例数据
{
    "data": [
        {
          "id": "64a62604d9c52b1fb1cea2ee", //设备 id
          "deviceName": "chrome/114.0.0.0", //设备名称
          "os": "Mac OS", //设备系统
          "version": "114.0.0.0", //系统版本
          "userId": "64a53f4079c9b6f43e56feb2",
          "deviceUniqueId": "4f24fab0d59272eca1365f742d69d9e6", //设备唯一标识
          "deviceRowId": "64a55e45002360ccaaf03a88", //行 id
          "status": "activated", //状态
          "ip": "49.7.66.98", //最近登录 ip
          "loginTime": 1688624246308, //最近活跃时间
          "isTrust": true,
          "endTime": null //挂起结束时间
        }
    ],
    "totalCount": 2 //数量
}

¶ 用户中心 - 移除设备

¶ 参数

  • options.userId <string> 当前 userId
  • options.id <string> 当前设备 ID

¶ 示例

await managementClient.browserFingerprint.delDeviceUser(options)

¶ 返回值

boolean : true / false

¶ 用户中心 - 禁用设备

¶ 参数

  • options.userId <string> 当前 userId
  • options.id <string> 当前设备 ID

¶ 示例

await managementClient.browserFingerprint.disableDeviceUser(options)

¶ 返回值

boolean : true / false

¶ 用户中心 - 启用设备

¶ 参数

  • options.userId <string> 当前 userId
  • options.id <string> 当前设备 ID

¶ 示例

await managementClient.browserFingerprint.enableDeviceUser(options)

¶ 返回值

boolean : true / false

¶ 用户中心 - 挂起设备

¶ 参数

  • options.userId <string> 当前 userId
  • options.id <string> 当前设备 ID
  • options.timestamp <number> timestamp 挂起结束时间 精确到毫秒

¶ 示例

await managementClient.browserFingerprint.suspendDeviceUser(options)

¶ 返回值

boolean : true / false
上一篇: 管理多租户 下一篇: Java / Kotlin
  • 管理员设备管理相关功能
  • 用户设备管理相关功能

用户身份管理

集成第三方登录
手机号闪验 (opens new window)
通用登录表单组件
自定义认证流程

企业内部管理

单点登录
多因素认证
权限管理

开发者

开发文档
框架集成
博客 (opens new window)
GitHub (opens new window)
社区用户中心 (opens new window)

公司

400 888 2106
sales@authing.cn
北京市朝阳区北辰世纪中心 B 座 16 层(总)
成都市高新区天府五街 200 号 1 号楼 B 区 4 楼 406 室(分)

京ICP备19051205号

beian京公网安备 11010802035968号

© 北京蒸汽记忆科技有限公司