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

  • 多因素认证组件(MFA)

  • JavaScript / Node.js

    • 用户认证模块

      • 认证核心模块
      • 标准协议认证模块
      • 扫码登录模块
      • 多因素认证模块
      • 社会化登录模块
      • 企业身份源登录模块
      • 主体认证模块
      • 浏览器指纹模块
    • 管理模块

  • 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 { AuthenticationClient } from 'authing-js-sdk';
const authenticationClient = new AuthenticationClient({
  appId: "AUTHING_APP_ID",
  appHost: 'https://{YOUR_DOMAIN}.authing.cn',
});

authenticationClient.browserFingerprint.getBrowserFingers; // 获取指纹信息 & 设备 id
authenticationClient.browserFingerprint.createDevice; // 浏览器设备上报
authenticationClient.browserFingerprint.myDevicesList; // 用户中心 - 列表
authenticationClient.browserFingerprint.myDevicesUnbind; // 用户中心 - 移除设备
authenticationClient.browserFingerprint.myDevicesLogout; // 用户中心 - 登出设备

¶ 获取指纹信息 & 设备 id

¶ 示例

import { AuthenticationClient } from "authing-js-sdk";

const authenticationClient = new AuthenticationClient({
  appId: "AUTHING_APP_ID",
  appHost: 'https://{YOUR_DOMAIN}.authing.cn',
});

const { browserId, deviceFingers } =  await authenticationClient.browserFingerprint.getBrowserFingers();

const {
  userAgentFingerprint, //浏览器用户代理指纹
  audioFingerprint, //音频设置和硬件特征指纹
  canvasFingerprint, //2D图像和动画绘制特征指纹
  screenResolutionFingerprint, //浏览器分辨率指纹
  webglFingerprint, //显卡及驱动程序指纹
  fontsFingerprint, //字体及输入设备特征指纹
  pluginsFingerprint, //浏览器预装插件指纹信息
} = deviceFingers;

console.log(browserId); //浏览器设备id

¶ 浏览器设备上报

¶ 示例

await authenticationClient.browserFingerprint.createDevice()

¶ 返回值

boolean : true / false

¶ 订阅设备事件

¶ 示例

import { AuthenticationClient } from "authing-js-sdk";
 
const authenticationClient = new AuthenticationClient( {
    appId: "AUTHING_APP_ID",
    appHost: 'https://{YOUR_DOMAIN}.authing.cn',
    socketUri:'YOUR_SOCKET_URL',
    token:'YOUR_TOKEN',
 });
 
//获取设备id
const { browserId } =  await authenticationClient.browserFingerprint.getBrowserFingers();
//事件监听
authenticationClient. event.sub(
  'authing.device.force-logout',
  (msgDataStr: string) => {
    const msgData = JSON.parse(msgDataStr);
    const { appId: msgAppid, logoutType, deviceId } = msgData;
    //对比必须是当前 appid 和当前设备
    if (msgAppid === appId && deviceId === browserId) {
            switch (logoutType) {
              case 0:
                console.log('使其他设备登出')
                break;
              case 1:
                console.log('个人中心 - 设备解绑')
                break;
              case 2:
                console.log('用户列表 - 个人详情 - 挂起设备')
                break;
              case 3:
                console.log('设备管理 - 挂起设备')
                break;
              case 4:
                console.log('用户列表 - 个人详情 - 禁用设备')
                break;
              case 5:
                console.log('设备管理 - 禁用设备')
                break;
              case 6:
                console.log('用户列表 - 个人详情 - 移除设备(解绑)')
                break;
              case 7:
                console.log('设备管理 - 删除设备')
                break;
              default:
                break;
            }
    }
  },
  () => {}
);

¶ 用户中心 - 列表

¶ 示例

import { AuthenticationClient } from "authing-js-sdk";

const authenticationClient = new AuthenticationClient({
    appId: "AUTHING_APP_ID",
    appHost: 'https://{YOUR_DOMAIN}.authing.cn',
});

const list = await authenticationClient.browserFingerprint.myDevicesList()

¶ 示例数据

[
  {
    "device": {
      "name": "chrome/114.0.0.0",
      "type": "Browser",
      "status": "activated",
      "os": "Mac OS",
      "version": "114.0.0.0",
      "mod": 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",
      "deviceId": "47a5d2ab86d90e6d2a8b7efcba939eec"
    },
    "lastLoginTime": "2023-07-06T02:25:08.879Z",
    "lastIp": "49.7.66.98",
    "online": true
  }
]

¶ 用户中心 - 移除设备

¶ 参数

  • deviceUniqueId <string> 当前用户的设备唯一标识

¶ 示例

await authenticationClient.browserFingerprint.myDevicesUnbind('47a5d2ab86d90e6d2a8b7efcba939eec')

¶ 返回值

boolean : true / false

¶ 用户中心 - 登出设备

¶ 参数

  • deviceUniqueId <string> 当前用户的设备唯一标识

¶ 示例

 await authenticationClient.browserFingerprint.myDevicesLogout('47a5d2ab86d90e6d2a8b7efcba939eec')

¶ 返回值

boolean : true / false
上一篇: 主体认证模块 下一篇: 管理模块
  • 获取指纹信息 & 设备 id
  • 浏览器设备上报
  • 订阅设备事件
  • 用户中心 - 列表
  • 用户中心 - 移除设备
  • 用户中心 - 登出设备

用户身份管理

集成第三方登录
手机号闪验 (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号

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