如何将密钥集成到 SvelteKit 中

php中文网 2024-10-15 11:49:21

在本教程中，我们将引导您构建一个包含密钥身份验证的示例 sveltekit 应用程序。我们将向您展示如何无缝集成 corbado 的密钥 ui 组件以实现安全、无密码的身份验证。在此过程中，我们还将演示如何使用 corbado node.js sdk 在服务器上检索用户数据。

在这里查看完整的原始教程

先决条件

在我们深入之前，您应该熟悉 svelte、javascript、html 和 css。此外，您需要在开发计算机上安装 node.js 和 npm。

带有密钥的 sveltekit 项目结构

我们将从设置基本的 sveltekit 项目结构开始。复制代码

.
├── .env
├── package.json
└── src
    ├── app.html
    └── routes
        ├── +layout.svelte
        ├── +layout.server.ts
        ├── +page.svelte
        └── profile
            ├── +page.server.ts
            └── +page.svelte

这是我们将要使用的基本布局。出于本教程的目的，可以忽略大多数其他文件。

设置 sveltekit 项目

首先，使用以下命令初始化一个新的 svelte 项目：

npm create svelte@latest example-passkeys-svelte
cd example-passkeys-svelte
npm install

在设置过程中，您可以选择以下选项：

应用程序模板： 骨架项目
类型检查：我们正在使用 typescript，但请根据您的喜好随意选择。
其他选项：我们建议使用 eslint 和 prettier 来提高代码质量和格式。

接下来，安装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 添加密钥

第 1 步：设置您的 corbado 帐户和项目

在 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

第 2 步：嵌入 passkey ui 组件

首先，禁用服务器端渲染（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>

第 4 步：设置个人资料页面

在 /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 =&gt; {
      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>