在本教程中,我们将指导您完成将密钥身份验证集成到 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 项目
npx nuxi@latest init passkeys-demo-nuxtjs cd passkeys-demo-nuxtjs npm install npm run dev
这将在 http://localhost:3000 上启动您的应用程序。
首先,通过他们的开发者面板注册 corbado 帐户。在设置过程中,选择“corbado complete”作为您的产品,并指定“nuxt.js”作为您的框架。根据您本地的开发环境配置您的应用程序 url 和依赖方 id。
使用您的项目 id 更新您的 .env 文件,您可以从 corbado 开发者面板检索该文件:
vite_corbado_project_id=<your-project-id></your-project-id>
安装 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
在本指南中,我们演示了如何使用 corbado 的 ui 组件在 nuxt.js 应用程序中实现基于密码的身份验证。通过此设置,您可以在 web 应用程序中提供安全且用户友好的登录体验。有关会话管理和其他功能的更多详细信息,请参阅 corbado 文档或完整博客文章。
通过执行以下步骤,您可以通过现代的无密码身份验证来增强 nuxt.js 应用程序的安全性。