LINE
获取你的 LINE 凭证
- 在 LINE 开发者控制台中创建一个通道。
- 请记下你的通道 ID（client_id）和通道密钥（client_secret）。
- 在通道设置中，添加你的重定向 URI，例如本地开发时使用
http://localhost:3000/api/auth/callback/line。 - 启用所需的权限范围（至少
openid；如果需要名称、头像、电子邮件，可添加profile、email）。
详情请参阅 LINE 登录 v2.1 参考：[https://developers.line.biz/en/reference/line-login/#issue-access-token]
配置提供者
在你的身份验证配置中，将你的 LINE 凭据添加到 socialProviders.line。
import { betterAuth } from "better-auth";
export const auth = betterAuth({
socialProviders: {
line: {
clientId: process.env.LINE_CLIENT_ID as string,
clientSecret: process.env.LINE_CLIENT_SECRET as string,
// redirectURI: "https://your.app/api/auth/callback/line", // uncomment to use a custom redirect URI
// scope: ["custom"], // uncomment to add additional scopes
// disableDefaultScope: true, // uncomment to replace default scopes [`openid`, `profile`, `email`]
},
},
});用法
🌐 Usage
使用 LINE 登录
🌐 Sign In with LINE
使用客户端 signIn.social 并设置 provider: "line"。
🌐 Use the client signIn.social with provider: "line".
import { createAuthClient } from "better-auth/client";
const authClient = createAuthClient();
async function signInWithLINE() {
const res = await authClient.signIn.social({ provider: "line" });
}使用 ID 令牌登录 LINE（可选）
🌐 Sign In with LINE using ID Token (optional)
如果你在客户端获取了 LINE ID 令牌，你可以直接登录，无需重定向。
🌐 If you obtain the LINE ID token on the client, you can sign in directly without redirection.
await authClient.signIn.social({
provider: "line",
idToken: {
token: "<LINE_ID_TOKEN>",
accessToken: "<LINE_ACCESS_TOKEN>",
},
});注意
🌐 Notes
- 默认作用域包括
openid profile email。可根据需要通过提供商选项进行调整。 - 请验证重定向 URI 是否与 LINE 开发者控制台中配置的值完全匹配。
- LINE ID 令牌验证使用官方端点，并根据规范检查受众和可选的随机数（nonce）。
设计登录按钮？请遵循 LINE 的按钮指南。
🌐 Designing a login button? Follow LINE's button guidelines.
多渠道支持
🌐 Multi-Channel Support
LINE 对不同国家（日本、泰国、台湾等）需要单独的 OAuth 渠道，每个渠道都有自己的 clientId 和 clientSecret。标准的 socialProviders.line 配置只支持单个渠道。
🌐 LINE requires separate OAuth channels for different countries (Japan, Thailand, Taiwan, etc.), each with its own clientId and clientSecret. The standard socialProviders.line configuration only supports a single channel.
要支持多个国家/渠道，请使用 通用 OAuth 插件 结合 line() 辅助函数。这允许你使用不同的 providerId 配置多个 LINE 提供者：
🌐 To support multiple countries/channels, use the Generic OAuth plugin with the line() helper function. This allows you to configure multiple LINE providers with different providerIds:
import { betterAuth } from "better-auth";
import { genericOAuth, line } from "better-auth/plugins";
export const auth = betterAuth({
plugins: [
genericOAuth({
config: [
// Japan channel
line({
providerId: "line-jp",
clientId: process.env.LINE_JP_CLIENT_ID,
clientSecret: process.env.LINE_JP_CLIENT_SECRET,
}),
// Thailand channel
line({
providerId: "line-th",
clientId: process.env.LINE_TH_CLIENT_ID,
clientSecret: process.env.LINE_TH_CLIENT_SECRET,
}),
// Taiwan channel
line({
providerId: "line-tw",
clientId: process.env.LINE_TW_CLIENT_ID,
clientSecret: process.env.LINE_TW_CLIENT_SECRET,
}),
],
}),
],
});登录时，使用相应的 providerId（例如："line-jp"、"line-th"、"line-tw"）来确定使用哪个通道：
🌐 When signing in, use the appropriate providerId (e.g., "line-jp", "line-th", "line-tw") to identify which channel to use:
import { createAuthClient } from "better-auth/client";
import { genericOAuthClient } from "better-auth/client/plugins";
const authClient = createAuthClient({
plugins: [genericOAuthClient()],
});
// Sign in with Japan channel
await authClient.signIn.social({ provider: "line-jp" });
// Sign in with Thailand channel
await authClient.signIn.social({ provider: "line-th" });