认证

使用 Spotify 登录

要为您的项目启用 Spotify 认证，您需要设置一个 Spotify OAuth 应用并将应用凭证添加到 Supabase 仪表板。

概述

为您的应用设置 Spotify 登录包含 3 个部分：

访问您的 Spotify 开发者账户

Spotify 开发者门户

获取您的回调 URL

下一步需要一个回调URL，格式如下：https://<项目引用>.supabase.co/auth/v1/callback

  • 前往您的 Supabase项目仪表板
  • 点击左侧边栏中的 “身份验证” 图标
  • 在 “配置” 部分下点击 “提供商”
  • 从手风琴列表中点击 Spotify 展开，您将找到 回调URL，您可以点击 “复制” 将其复制到剪贴板

创建 Spotify OAuth 应用

  • 登录 Spotify
  • 前往 Spotify 开发者仪表板
  • 点击 Create an App
  • 输入您的 App name
  • 输入您的 App description
  • 勾选同意 Developer TOS and Branding Guidelines
  • 点击 Create
  • 保存您的 Client ID
  • 保存您的 Client Secret
  • 点击 Edit Settings

在 Redirect URIs 部分：

  • 将您的 Supabase 回调 URL 粘贴到输入框中
  • 点击 Add
  • 点击底部的 Save

将 Spotify 凭证添加到 Supabase 项目

  • 前往您的 Supabase项目仪表板
  • 在左侧边栏中，点击 “身份验证” 图标（靠近顶部）
  • 在 “配置” 部分下，点击“提供商”
  • 从手风琴列表中点击 Spotify 展开，并将 Spotify 已启用 切换为 “开”
  • 输入您在上一步中保存的 Spotify 客户端ID 和 Spotify 客户端密钥
  • 点击 “保存”

为客户端应用添加登录代码

以下概述了使用Supabase Auth通过Spotify登录的步骤：

  1. 从客户端库调用登录方法
  2. 用户将被重定向到Spotify登录页面
  3. 完成登录流程后，用户将被重定向回您的应用，并显示需要确认电子邮件地址的错误提示。同时用户会收到来自Supabase Auth的确认邮件
  4. 用户点击邮件中的确认链接
  5. 用户返回应用并完成登录

当用户登录时，调用signInWithOAuth()方法，指定spotify作为provider：

1
2
3
4
5
async function () {  const { ,  } = await ..({    : 'spotify',  })}

以 PKCE 流程为例，比如在服务器端身份验证中，您需要额外的步骤来处理代码交换。调用 signInWithOAuth 时，提供一个指向回调路由的 redirectTo URL。此重定向 URL 应添加到您的重定向允许列表中。

在浏览器中，signInWithOAuth 会自动重定向到 OAuth 提供商的身份验证端点，然后再重定向到您的端点。

1
2
3
4
5
6
await ..({  ,  : {    : `http://example.com/auth/callback`,  },})

在回调端点，处理代码交换以保存用户会话。

在 app/auth/callback/route.ts 创建一个新文件，并填充以下内容：

app/auth/callback/route.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
import { NextResponse } from 'next/server'// 您根据服务器端身份验证说明创建的客户端import { createClient } from '@/utils/supabase/server'export async function GET(request: Request) {  const { searchParams, origin } = new URL(request.url)  const code = searchParams.get('code')  // 如果参数中有 "next"，则将其用作重定向 URL  let next = searchParams.get('next') ?? '/'  if (!next.startsWith('/')) {    // 如果 "next" 不是相对 URL，则使用默认值    next = '/'  }  if (code) {    const supabase = await createClient()    const { error } = await supabase.auth.exchangeCodeForSession(code)    if (!error) {      const forwardedHost = request.headers.get('x-forwarded-host') // 负载均衡器之前的原始来源      const isLocalEnv = process.env.NODE_ENV === 'development'      if (isLocalEnv) {        // 我们可以确定中间没有负载均衡器，因此无需关注 X-Forwarded-Host        return NextResponse.redirect(`${origin}${next}`)      } else if (forwardedHost) {        return NextResponse.redirect(`https://${forwardedHost}${next}`)      } else {        return NextResponse.redirect(`${origin}${next}`)      }    }  }  // 将用户重定向到带有说明的错误页面  return NextResponse.redirect(`${origin}/auth/auth-code-error`)}

当用户登出时，调用signOut()方法从浏览器会话和localStorage中移除用户数据：

1
2
3
async function () {  const {  } = await ..()}

相关资源