didit-email-verification

✉️ 企业级邮箱OTP验证与风控方案

基于Didit商业API的邮箱OTP验证服务,支持泄露/一次性邮箱检测及IP设备欺诈信号识别,为应用提供高安全性身份核验能力。

收藏
14.6k
安装
3.1k
版本
v1.2.0
CLS 安全性认证2026-05-15
点击查看完整报告 >

使用说明

Didit Email Verification是一项专注于邮箱身份验证的API集成技能,通过对接Didit商业验证平台,为应用提供完整的OTP(一次性密码)邮箱验证解决方案。该技能采用两步验证机制,首先向目标邮箱发送验证码,随后验证用户输入的代码,整个过程集成反欺诈检测与风险邮箱识别能力,适用于用户注册、密码重置、身份核验等多种业务场景。

核心用法遵循简洁的双端点流程。开发者首先调用POST /v3/email/send/端点向指定邮箱发送验证码,支持自定义验证码长度(4-8位)及是否使用字母数字组合,同时可附加用户IP、设备ID和User-Agent等欺诈信号用于风险评分。验证码5分钟内有效,用户最多可尝试验证3次。随后通过POST /v3/email/check/端点校验用户输入,系统不仅比对验证码正确性,还会根据配置策略自动检测泄露邮箱(Breached)、一次性邮箱(Disposable)及无法投递地址(Undeliverable),支持设置"DECLINE"动作自动拒绝高风险验证请求。

该技能的显著优势在于其企业级风控能力。除了基础的OTP验证,它内置Have I Been Pwned等泄露数据库检测,可识别数据泄露中的受损邮箱;能自动标记临时邮箱服务商(10 Minute Mail等);通过欺诈信号收集实现风险评分;并提供完整的验证生命周期日志,包括发送时间、验证尝试次数及费用明细。策略配置灵活性高,开发者可针对重复邮箱、泄露邮箱等不同风险类型独立设置"通过"或"拒绝"策略,实现精细化的安全控制。

然而,该技能也存在一定局限性。首先,作为T3来源(个人开发者rosasalberto)的社区项目,长期维护更新存在不确定性。其次,功能强依赖于Didit第三方服务的可用性,若Didit API发生故障或网络不通,验证流程将完全中断。此外,每次验证调用均产生API费用(Send约$0.03/次),对于高频应用需考虑成本因素。数据隐私方面,用户邮箱及IP等敏感信息需传输至Didit服务器处理,虽采用HTTPS加密,但仍需符合GDPR等数据跨境传输合规要求。

该技能特别适合对身份安全性要求较高的SaaS平台、金融科技应用、电商平台及需要KYC(了解你的客户)合规的在线服务。对于需要防范批量注册、虚假账户及欺诈行为的业务场景,其一次性邮箱检测和泄露数据库比对功能具有重要价值。同时,支持多语言邮件模板(locale参数)的特性也使其适用于国际化产品。

使用风险主要包括:网络依赖风险(需确保服务器能访问verification.didit.me)、API配额管理风险(需监控Didit账户余额避免403错误)、数据隐私合规风险(需向用户明确告知邮箱验证涉及第三方服务),以及潜在的速率限制风险(429错误)。建议生产环境实施完善的错误重试机制,对"Undeliverable"和"Declined"状态进行用户友好的提示封装,避免暴露底层API错误细节。

安全解读

核心用法

Didit Email Verification 是一个专注于邮件地址验证与身份认证的API服务,采用双步OTP(一次性密码)验证机制。流程简洁:发送验证码用户接收并输入验证并返回风险分析

发送阶段:调用 /v3/email/send/ 接口,支持自定义验证码长度(4-8位)、字母数字混合模式,以及可选的欺诈信号采集(IP地址、设备ID、User-Agent)。这些信号用于后续风险评估,帮助识别异常请求来源。

验证阶段:调用 /v3/email/check/ 接口,不仅校验验证码正确性,还执行多维安全检测:

  • 泄露检测:比对已知数据泄露库
  • 临时邮箱识别:拦截一次性/ disposable 邮箱服务
  • 不可送达检测:验证邮箱实际可接收性
  • 重复验证检测:识别同一邮箱被多用户使用的场景

系统支持策略化自动拦截(DECLINE 模式),即使验证码正确,若触发风险规则也可拒绝验证,为金融、政务等高安全场景提供保障。

显著优点

1. 多层安全防护:超越基础OTP验证,整合泄露情报、设备指纹、行为信号,形成纵深防御
2. 灵活的合规控制:通过 *_action 参数按需启用风险规则,避免一刀切影响正常用户

3. 清晰的审计追踪lifecyclewarnings 字段完整记录验证过程,满足合规审计要求

4. 开发者友好:提供Python/TypeScript示例代码、命令行工具脚本,5分钟可完成集成

5. 经济透明的计费:按验证事件计费(发送¥0.03,验证免费),无隐藏成本

潜在局限性

  • 服务依赖风险:核心功能完全依赖Didit云服务,网络中断或服务故障将直接影响业务
  • 验证码有效期较短:5分钟过期+3次尝试限制,对网络延迟高的用户可能造成体验摩擦
  • 国际合规待定:文档未明确说明数据存储位置及跨境传输安排,GDPR等合规需额外确认
  • 深度定制受限:邮件模板、发送域名的品牌自定义能力未在文档中体现

适合人群

  • 金融科技/支付平台:需要强身份验证+反欺诈的KYC流程
  • SaaS/企业软件:防止批量注册、保护试用账号不被滥用
  • 政务/医疗系统:高安全要求的身份核验场景
  • 电商平台:防范虚假账号、提升交易信任度

常规风险

| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| API服务可用性 | 外部依赖单点故障 | 实现降级方案(如备用验证方式)|
| 密钥泄露 | DIDIT_API_KEY环境变量管理不当 | 使用密钥管理服务,定期轮换 |
| 数据跨境 | 用户邮箱、IP可能传输至境外 | 确认Didit DPA数据处理协议 |
| 误拦截 | 严格策略可能影响正常用户 | 分阶段灰度上线,监控误杀率 |

didit-email-verification 内容

scripts文件夹
手动下载zip · 5.4 kB
verify_email.pytext/plain
请选择文件