跳转至正文
@capgo/capacitor-verisoul 身份验证与安全 开源

Verisoul Capacitor 插件

在 iOS 和 Android 端的 Capacitor 应用中收集 Verisoul 原生防欺诈会话

安装

bun add @capgo/capacitor-verisoul bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-verisoul
  • pnpm add @capgo/capacitor-verisoul
  • yarn add @capgo/capacitor-verisoul

指南

如何在 Capacitor 中使用 Verisoul

使用 @capgo/capacitor-verisoul

@capgo/capacitor-verisoul 将 Capacitor 应用连接到 iOS 和 Android 上的 Verisoul 原生反欺诈会话。

安装

npm install @capgo/capacitor-verisoul
npx cap sync

插件暴露的内容

  • configure - 使用您的环境和项目 ID 初始化原生 Verisoul SDK。
  • getSessionId - 返回当前的 Verisoul session ID,用于后端风险评估。
  • reinitialize - 在账户上下文发生变化后,启动全新的 Verisoul session。
  • recordTouchEvent - 将 Android 触摸事件发送至 Verisoul 触摸信号采集系统。

用法示例

import { Verisoul } from '@capgo/capacitor-verisoul';

await Verisoul.configure({
  environment: 'prod',
  projectId: 'YOUR_PROJECT_ID',
});

const { sessionId } = await Verisoul.getSessionId();

await fetch('/api/risk/verisoul', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ sessionId }),
});

重置会话

调用 reinitialize() 当用户登出或切换账户时:

await Verisoul.reinitialize();

完整参考

从使用 @capgo/capacitor-verisoul 继续

如果你正在使用 使用 @capgo/capacitor-verisoul 若要添加防欺诈信号,请将其与以下内容连接: @capgo/capacitor-verisoul 了解实现细节, 快速入门 查看安装步骤, iOS 配置 查看 App Attest 说明, Android 配置 查看 Gradle 配置,以及 Capgo 安全 用于更广泛的安全工作流。

常见问题

Verisoul 插件常见问题

如何在 Capacitor 应用中安装 Verisoul 插件?

运行 "bun add @capgo/capacitor-verisoul"(或 "npm install @capgo/capacitor-verisoul"),然后运行 "bunx cap sync",让 iOS 和 Android 项目引入原生 code。再在你的应用 code 中从 "@capgo/capacitor-verisoul" 导入它。

@capgo/capacitor-verisoul 支持 React、Vue 和 Angular 吗?

支持。Verisoul 是一个 Capacitor 包,所以任何运行在 Capacitor 里的 Web 框架都能用,包括 Ionic、React、Vue、Angular、Svelte 和纯 JavaScript。

@capgo/capacitor-verisoul 支持哪个 Capacitor 版本?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-verisoul 是免费开源的吗?

是的。code 源码已在 GitHub 公开,地址是 https://github.com/Cap-go/capacitor-verisoul/,也可以从 npm 免费安装。欢迎提交 Bug 报告和 Pull Request。

使用 Verisoul 的 code 能否不经过 App Store 审核就更新?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App 审核,即可快速发布 Verisoul 更新

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo