本文介绍如何通过 shopify multipass 实现 firebase 登录用户免密跳转至 shopify 商店自动登录，避免用户重复输入凭证，适用于 shopify plus 用户。
在基于 Firebase 构建的 Android Web 应用中，若后端已使用 Firebase Authentication（如 Email/Password、Google 或 Phone 登录）完成用户身份验证，但前端需跳转至 Shopify 独立商店页面（如商品页、结账页），则用户常面临“二次登录”问题——即 Firebase 已登录，却仍需在 Shopify 端再次输入邮箱/密码。这不仅损害用户体验，也违背单点登录（SSO）的设计原则。
核心解决方案：Shopify Multipass（仅限 Shopify Plus 计划）
Multipass 是 Shopify 提供的服务器端单点登录机制，允许你使用自有用户系统（如 Firebase）生成加密令牌，将用户安全重定向至 Shopify 商店并自动登录（或静默创建账户）。其工作流程如下：
- 用户在你的 App 中通过 Firebase 成功登录，获取 user.getEmail() 和必要元数据（如 firstName, lastName）；
- 你的应用后端（必须是可信服务端，不可在客户端生成 Multipass token）使用 Shopify 提供的 Multipass 密钥对用户信息进行 AES-256 加密，并生成有效期 ≤ 24 小时的 token；
- 后端返回该 token，前端将其拼入 Shopify 登录 URL：https://your-store.myshopify.com/account/login/multipass/{token}；
- Shopify 验证签名与时效性后，自动登录对应邮箱用户（若不存在则创建新客户）。
✅ 示例（Node.js 后端生成 Multipass Token）：
const crypto = require('crypto');
function generateMultipassToken(email, firstName, lastName, shopifySecret) {
const now = Math.floor(Date.now() / 1000);
const data = JSON.stringify({
email,
created_at: new Date(now * 1000).toISOString(),
expires: now + 3600, // 1小时有效期（强烈建议 ≤ 3600 秒）
...(firstName && { first_name: firstName }),
...(lastName && { last_name: lastName })
});
const iv = crypto.randomBytes(16);
const cipher = crypto.createCipheriv('aes-256-cbc', shopifySecret, iv);
let encrypted = cipher.update(data, 'utf8', 'base64');
encrypted += cipher.final('base64');
const hmac = crypto.createHmac('sha256', shopifySecret);
hmac.update(iv.toString('base64') + encrypted);
const signature = hmac.digest('hex');
return Buffer.from(`${iv.toString('base64')}.${encrypted}.${signature}`).toString('base64');
}
// 使用示例（需替换为你的 Shopify Multipass Secret）
const token = generateMultipassToken(
'user@example.com',
'John',
'Doe',
'your_shopify_multipass_secret_here' // ⚠️ 严格保密，切勿硬编码在前端！
);
console.log(`https://your-store.myshopify.com/account/login/multipass/${token}`);⚠️ 关键注意事项：
- 仅 Shopify Plus 可用：标准版/高级版 Shopify 不支持 Multipass，需确认客户订阅计划；
- 服务端生成强制要求：Multipass token 必须由你控制的后端生成（如 Cloud Functions、Node.js API），因涉及敏感密钥和加密逻辑，绝不可在 Android 客户端或 WebView 中实现；
- 邮箱一致性是唯一凭证：Firebase 用户邮箱必须与 Shopify 客户邮箱完全一致（大小写敏感），否则无法匹配登录；
- 数据同步非实时：Multipass 不同步订单、地址等历史数据，仅解决登录态透传；若需双向数据同步（如将 Firebase 用户收货地址写入 Shopify），需额外调用 Shopify Admin API；
- 替代方案考量：若非 Plus 用户，可考虑将 Firebase Auth 作为唯一登录入口，通过自定义结账链接（/checkout?customer_email=...）预填邮箱（仅限结账页，不触发登录），或采用嵌入式 Shopify Buy SDK（需自行处理会话管理）。
综上，Firebase + Shopify 的跨平台免登体验，本质是借助 Multipass 在服务端完成身份信任传递。它不是 OAuth 授权协议，而是一种轻量级、面向商户自有系统的 SSO 桥接机制。实施前务必评估成本与架构合理性——将核心电商数据（如订单、库存）长期托管于 Firebase 而非 Shopify 原生系统，可能增加合规风险、维护复杂度及潜在费用（如 Shopify 的交易手续费豁免依赖订单归属）。建议与客户明确业务边界：Firebase 专注用户画像与营销数据，Shopify 专注交易与履约，各司其职方为长久之计。
