Gmail邮件发送与授权对接
接收用户的授权凭据与邮件内容,在智能合约后端通过 OAuth 2.0 PKCE 协议与 Gmail API 进行非复制安全通信,实现以用户个人邮箱身份发送邮件及
功能与用途
本配置方案为 Caffeine 框架及 Motoko 智能合约提供了标准的 Google 邮箱对接方案。它结合 google-oauth 和 googlemail-client 两个核心模块,实现链上针对每个登录用户(Principal)的独立 OAuth 2.0 PKCE 授权流、凭据加密存储与静默刷新机制;同时强制采用非复制 HTTP 出站调用(is_replicated = false),杜绝 Bearer Token 泄露、重复扣减 Gas 周期与多节点重复发信问题。
适用场景
- 用户个人 Gmail 授权链路接入:在智能合约中集成 OAuth 2.0 PKCE 握手流,实现多用户凭据的安全存储与免人工静默刷新。
- 链上代发个人邮件服务搭建:通过非复制 HTTP 外部调用安全请求 Gmail REST API,以登录用户个人邮箱身份稳定发信。
- 应用权限最小化范围配置:依据只发信或读写混合等实际场景,精确收敛 Google OAuth Scopes 权限并配置回调地址。
适用人群
- Motoko 后端开发工程师
- Web3 应用全栈开发者
- Caffeine 平台智能合约架构师
使用步骤
- 通过 Mops 安装 googlemail-client、google-oauth 和 caffeineai-authorization 依赖库。
- 在 Google Cloud Console 创建 Web 客户端并设置合法的 redirectUri,随后由管理员向 Canister 写入 Client ID 与 Secret。
- 引入 MixinGmailMessaging 与 MixinGmailConfig,实现 startGmailOAuth 与 completeGmailOAuth 完成 PKCE 授权交换。
- 在 lib/gmail.mo 中配置 scope(如 openid email 和 gmail.send),并强制将 is_replicated 设置为 ?false。
- 调用 sendEmail 接口,系统将以当前登录用户身份发送邮件并在 Token 失效时自动刷新重试。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
>-
依赖与权限
- 读取用户主动提供的内容