Salesforce

获取 Salesforce 凭证

1. 登录您的 Salesforce 组织（生产版或开发者版）
2. 导航至 设置 > 应用管理器
3. 点击 新建连接应用
4. 填写基本信息：
   • 连接应用名称：您的应用名称
   • API 名称：根据应用名称自动生成
   • 联系邮箱：您的电子邮件地址
5. 启用 OAuth 设置：
   • 勾选 启用 OAuth 设置
   • 将 回调 URL 设置为您的重定向 URI（例如开发环境使用 http://localhost:3000/api/auth/callback/salesforce）
   • 选择所需的 OAuth 范围：
     • 访问基本信息（id）
     • 访问身份 URL 服务（openid）
     • 访问电子邮件地址（email）
     • 随时代表您发起请求（refresh_token, offline_access）
6. 启用 要求使用代码交换证明密钥（PKCE）（必需）
7. 保存并记录您的 消费者密钥（客户端 ID）和 消费者密钥（客户端密钥）

配置提供程序

要配置提供程序，您需要导入提供程序并将其传递给认证实例的 socialProviders 选项。

import { betterAuth } from "better-auth"

export const auth = betterAuth({
    socialProviders: {
        salesforce: { 
            clientId: process.env.SALESFORCE_CLIENT_ID as string, 
            clientSecret: process.env.SALESFORCE_CLIENT_SECRET as string, 
            environment: "production", // 或 "sandbox"
        }, 
    },
})

配置选项

• clientId：连接应用的消费者密钥
• clientSecret：连接应用的消费者密钥
• environment："production"（默认）或 "sandbox"
• loginUrl：自定义 My Domain URL（不含 https://）- 覆盖环境设置
• redirectURI：如需覆盖则手动生成重定向 URI

高级配置

export const auth = betterAuth({
    socialProviders: {
        salesforce: {
            clientId: process.env.SALESFORCE_CLIENT_ID as string,
            clientSecret: process.env.SALESFORCE_CLIENT_SECRET as string,
            environment: "sandbox", 
            loginUrl: "my-company.my.salesforce.com", // 自定义 My Domain
            redirectURI: "http://localhost:3000/api/auth/callback/salesforce", // 如有需要覆盖
        },
    },
})

环境变量

将以下环境变量添加到您的 .env.local 文件中：

SALESFORCE_CLIENT_ID=您的消费者密钥
SALESFORCE_CLIENT_SECRET=您的消费者密钥
BETTER_AUTH_URL=http://localhost:3000 # 对重定向 URI 生成很重要

对于生产环境：

SALESFORCE_CLIENT_ID=您的消费者密钥
SALESFORCE_CLIENT_SECRET=您的消费者密钥
BETTER_AUTH_URL=https://您的域名.com

使用 Salesforce 登录

要使用 Salesforce 登录，您可以使用客户端提供的 signIn.social 函数。signIn 函数接收以下属性的对象：

• provider：要使用的提供程序，应设置为 salesforce。

import { createAuthClient } from "better-auth/client"
const authClient = createAuthClient()

const signIn = async () => {
    const data = await authClient.signIn.social({
        provider: "salesforce"
    })
}

故障排除

重定向 URI 不匹配错误

如果遇到 redirect_uri_mismatch 错误：

1. 检查回调 URL：确保 Salesforce 已连接应用中的回调 URL 与 Better Auth 的回调 URL 完全匹配
2. 协议：确认使用相同的协议（http:// 与 https://）
3. 端口：确认端口号匹配（例如 :3000）
4. 如有必要覆盖：使用 redirectURI 选项明确设置回调 URI

salesforce: {
    clientId: process.env.SALESFORCE_CLIENT_ID as string,
    clientSecret: process.env.SALESFORCE_CLIENT_SECRET as string,
    redirectURI: "http://localhost:3000/api/auth/callback/salesforce", 
}

环境问题

• 生产环境：使用 environment: "production"（默认）配合 login.salesforce.com
• 沙盒：使用 environment: "sandbox" 配合 test.salesforce.com
• My Domain：使用 loginUrl: "yourcompany.my.salesforce.com" 用于自定义域名

PKCE 要求

Salesforce 要求 PKCE（代码交换证明密钥），此提供程序会自动处理。确保在连接应用设置中启用了 PKCE。