插件窝 干货文章 教程:如何将密钥集成到 Nuxtjs 中

教程:如何将密钥集成到 Nuxtjs 中

corbado gt div lt 630    来源:    2024-10-21

介绍

在本教程中,我们将指导您完成将密钥身份验证集成到 nuxt.js 应用程序中的过程。我们将涵盖从设置 nuxt.js 项目到实现 corbado ui 组件以实现无缝密钥登录体验的所有内容。

如果您想直接跳到代码中,可以在我们的 github 存储库中找到完整的示例。

在此处阅读完整的博客文章

先决条件

在深入实施之前,请确保您对 nuxt.js、html、css 和 javascript 有基本了解。此外,您需要在开发计算机上安装 node.js 和 npm。

项目结构

以下是我们 nuxt.js 项目结构的快速概述:

.
├── .env
├── package.json
├── nuxt.config.ts
├── pages
|   ├── index.vue 
|   └── profile.vue
└── layouts 
    └── default.vue

此结构将作为实现密钥身份验证的基础。

设置 nuxt.js 项目

首先,让我们初始化一个新的 nuxt.js 项目

npx nuxi@latest init passkeys-demo-nuxtjs
cd passkeys-demo-nuxtjs
npm install
npm run dev

这将在 http://localhost:3000 上启动您的应用程序。

实施 corbado 的密钥身份验证

设置您的 corbado 帐户

首先,通过他们的开发者面板注册 corbado 帐户。在设置过程中,选择“corbado complete”作为您的产品,并指定“nuxt.js”作为您的框架。根据您本地的开发环境配置您的应用程序 url 和依赖方 id。
使用您的项目 id 更新您的 .env 文件,您可以从 corbado 开发者面板检索该文件:

vite_corbado_project_id=<your-project-id></your-project-id>

嵌入 corbado ui 组件

安装 corbado web-js 库:

npm i @corbado/web-js
npm i -d @corbado/types

接下来,在 /layouts/default.vue 中设置布局以初始化您的 corbado 项目:

<script setup lang="ts">
  import corbado from "@corbado/web-js"
  import { onmounted } from "vue";const isinitialized = usestate('isinitialized', () => false);
  const projectid = import.meta.env.vite_corbado_project_id;
  onmounted(async () => {
    await corbado.load({
      projectid: projectid,
      darkmode: "off"
    });
    isinitialized.value = true;
  });
</script><template><div v-if="isinitialized">
    <slot></slot>
</div>
</template>

此设置可确保 corbado 项目在渲染任何组件之前初始化。

创建登录页面

现在,让我们在 /pages/index.vue 中创建登录页面:

<script setup lang="ts">
  import corbado from "@corbado/web-js"
  import { onmounted } from "vue";const authelement = usestate<htmldivelement | undefined>('authelement', () => undefined);
  onmounted(() => {
    if (authelement.value) {
      corbado.mountauthui(authelement.value, {
        onloggedin: () => {
          navigateto("/profile");
        },
      });
    }
  });
</script><template><div ref="authelement"></div>
</template>

此代码片段设置身份验证 ui 并在成功登录后处理重定向。

设置个人资料页面

登录后,用户将被重定向到个人资料页面,我们将在 /pages/profile.vue 中创建该页面:

<script setup lang="ts">
  import corbado from "@corbado/web-js"const user = corbado.user;
  async function handlelogout() {
    await corbado.logout();
    await navigateto("/");
  }
</script><template><div>
    <div v-if="user">
      <h1>profile page</h1>
      <p>
        user-id: {{ user.sub }}
        <br>
        email: {{ user.email }}
      </p>
      <button>logout</button>
    </div>
    <div v-else>
      <p>you're not logged in.</p>
      <p>
        please go back to <nuxtlink href="/">home</nuxtlink> to log in.
      </p>
    </div>
  </div>
</template>

此页面显示身份验证成功后的用户信息,并包含注销按钮。
使用以下命令运行应用程序:

npm run dev

教程:如何将密钥集成到 Nuxtjs 中

结论

在本指南中,我们演示了如何使用 corbado 的 ui 组件在 nuxt.js 应用程序中实现基于密码的身份验证。通过此设置,您可以在 web 应用程序中提供安全且用户友好的登录体验。有关会话管理和其他功能的更多详细信息,请参阅 corbado 文档或完整博客文章。
通过执行以下步骤,您可以通过现代的无密码身份验证来增强 nuxt.js 应用程序的安全性。