在本教程中,我们将引导您构建一个包含密钥身份验证的示例 SvelteKit 应用程序。我们将向您展示如何无缝集成 Corbado 的密钥 UI 组件以实现安全、无密码的身份验证。在此过程中,我们还将演示如何使用 Corbado Node.js SDK 在服务器上检索用户数据。
在这里查看完整的原始教程
在我们深入之前,您应该熟悉 Svelte、JavaScript、HTML 和 CSS。此外,您需要在开发计算机上安装 Node.js 和 NPM。
我们将从设置基本的 SvelteKit 项目结构开始。复制代码
. ├── .env ├── package.json └── src ├── app.html └── routes ├── +layout.svelte ├── +layout.server.ts ├── +page.svelte └── profile ├── +page.server.ts └── +page.svelte
这是我们将要使用的基本布局。出于本教程的目的,可以忽略大多数其他文件。
首先,使用以下命令初始化一个新的 Svelte 项目:
npm create svelte@latest example-passkeys-svelte cd example-passkeys-svelte npm install
在设置过程中,您可以选择以下选项:
接下来,安装Corbado的web-js和node-sdk包:
npm i @corbado/web-js @corbado/node-sdk npm i -D @corbado/types
在本地运行项目以验证设置:
npm run dev
默认的 Svelte 骨架应用程序应该可以在 http://localhost:5173 上找到。
在 Corbado 开发者面板上注册并创建一个新项目。为产品选择“Corbado Complete”,并指定“Svelte”作为框架。定义您的应用程序 URL 并将依赖方 ID 设置为 localhost。之后,检索您的项目 ID 和 API 密钥,您需要将其存储在环境变量中。
将它们添加到项目中的 .env 文件中:
PUBLIC_CORBADO_PROJECT_ID=your-corbado-project-id CORBADO_API_SECRET=your-corbado-api-secret
首先,禁用服务器端渲染(SSR),因为 Corbado 的 web-js 包当前不支持它。创建一个包含以下内容的 +layout.server.ts 文件:
export const ssr = false;
然后,通过在外部布局组件中初始化 Corbado 密钥 UI 组件来将其嵌入到前端中。这确保了应用程序的其余部分仅在 Corbado 初始化后才会呈现。
<script lang="ts"> import Corbado from "@corbado/web-js"; import { onMount } from "svelte"; import { PUBLIC_CORBADO_PROJECT_ID } from '$env/static/public';let isInitialized = false; onMount(async () => { await Corbado.load({ projectId: PUBLIC_CORBADO_PROJECT_ID, darkMode: 'off', setShortSessionCookie: true, }); isInitialized = true; }); </script> <div> {#if isInitialized} <slot></slot> {/if} </div>
在 src/routes/+page.svelte 中,集成注册和登录 UI 组件。通过身份验证后,将用户重定向到 /profile 页面。
<script lang="ts"> import Corbado from '@corbado/web-js'; import { onMount } from 'svelte';let authElement; onMount(() => { Corbado.mountAuthUI(authElement, { onLoggedIn: () => window.location.href = "/profile", }); }); </script> <div bind:this={authElement}></div>
在 /profile 路径下创建一个个人资料页面,您将在其中使用 Corbado 的 Node SDK 检索和显示用户信息。
在+page.server.ts中,检索会话cookie并返回用户数据:
import { SDK, Config } from '@corbado/node-sdk'; import { PUBLIC_CORBADO_PROJECT_ID } from '$env/static/public'; import { CORBADO_API_SECRET } from '$env/static/private'; const config = new Config(PUBLIC_CORBADO_PROJECT_ID, CORBADO_API_SECRET); const sdk = new SDK(config); export async function load({ request }) { const cookies = parseCookies(request.headers.get('Cookie') || ''); const cbo_short_session = cookies.cbo_short_session; if (!cbo_short_session) return { user: undefined }; try { const user = await sdk.sessions().getCurrentUser(cbo_short_session); if (!user.isAuthenticated()) return { user: undefined }; return { user: { email: user.getEmail(), userID: user.getID() } }; } catch { return { user: undefined }; } } function parseCookies(cookieHeader) { return Object.fromEntries( cookieHeader.split(';').map(cookie => { const [name, ...rest] = cookie.trim().split('='); return [name, rest.join('=')]; }) ); }
相应的页面将访问我们的加载程序的数据并显示用户的名称和用户 ID,并提供一个注销按钮。如果用户未登录,我们将显示返回主页的链接。
<script lang="ts"> import type { PageData } from './$types'; import Corbado from '@corbado/web-js'; import { goto } from '$app/navigation'; export let data: PageData async function handleLogout() { await Corbado.logout() await goto("/") } </script> <div> {#if (data.user)} <h1> Profile Page </h1> <p> User-id: {data.user.userID} </p> <p> Name: {data.user.email} </p> <button on:click={handleLogout}> Logout </button> {:else} <h1> You aren't logged in. </h1> <p>Go <a href="/">Home</a></p> {/if} </div>
一切设置完毕后,运行您的应用程序:
npm run dev
您的带有密钥身份验证的 SvelteKit 应用程序现已上线。登录后,用户将被重定向到显示其 ID 和电子邮件的个人资料页面。
在本指南中,我们展示了如何将 Corbado 的密钥身份验证集成到 SvelteKit 应用程序中。这种方法使用 Corbado 易于实现的 UI 组件提供安全、无密码的体验。您现在可以对此进行扩展并探索更高级的功能,例如会话管理或多设备支持。
以上是如何将密钥集成到 SvelteKit 中的详细内容。更多信息请关注PHP中文网其他相关文章!