PHP前端开发

使用 FACEIO 在 Nextjs 应用程序中进行无缝人脸验证

百变鹏仔 3天前 #JavaScript
文章标签 应用程序

在这篇博文中,我们将指导您逐步将 faceio 的人脸身份验证合并到 next.js 应用程序中,从设置 faceio 帐户到在代码库中实现集成。

先决条件

在我们深入之前,请确保您已准备好以下内容:

设置 faceio 应用程序

1.创建新的 faceio 应用程序:登录到您的 faceio 控制台并单击“创建新应用程序”按钮。

2.配置应用程序:填写所需信息,例如应用程序名称、描述和回调 url(这将是您的 next.js 应用程序的 url)。填写完表格后,点击“创建应用程序”。

3.获取faceio_app_id:创建应用程序后,您将获得一个唯一的faceio_app_id。这是您将用于将 faceio 集成到 next.js 应用程序中的标识符。

将 faceio 集成到您的 next.js 应用程序中

1.安装faceio npm包:在你的next.js项目中,使用npm或yarn安装faceio-npm包:

2.创建人脸验证组件:在您的 next.js 项目中,使用以下代码创建一个名为 components/dashboard.tsx (或您喜欢的任何其他名称)的新文件:

// dashboard.tsximport react from "react";import { card, cardheader, cardtitle, cardcontent } from "@/components/ui/card";import { button } from "@/components/ui/button";import { fausercircle, falock, facode, fachartbar, fasignoutalt } from 'react-icons/fa';interface dashboardprops {  useremail: string;  onlogout: () =&gt; void;}const dashboard: react.fc<dashboardprops> = ({ useremail, onlogout }) =&gt; {  return (    <div classname="max-w-7xl mx-auto p-4 md:p-6 space-y-6">      <card classname="w-full bg-black text-white"><cardheader classname="flex flex-col sm:flex-row items-start sm:items-center justify-between space-y-4 sm:space-y-0"><div>            <cardtitle classname="text-2xl sm:text-3xl font-bold">welcome to faceio</cardtitle><p classname="text-base sm:text-lg mt-2">email: {useremail}</p>          </div>          <button variant="secondary" size="sm" onclick="{onlogout}" classname="flex items-center w-full sm:w-auto justify-center mt-8">            <fasignoutalt classname="mr-2"></fasignoutalt> logout          </button>        </cardheader><cardcontent><p classname="text-lg sm:text-xl mb-4">you have successfully logged in.</p>        </cardcontent></card><h2 classname="text-xl sm:text-2xl font-bold text-center my-6">facial authentication for the web</h2>      <div classname="grid grid-cols-1 sm:grid-cols-2 gap-4 sm:gap-6">        <card><cardheader><cardtitle classname="flex items-center text-base sm:text-lg"><fausercircle classname="mr-2"></fausercircle> secure &amp; easy            </cardtitle></cardheader><cardcontent><p classname="text-sm sm:text-base">cross-browser, secure &amp; easy to implement. passwordless authentication sdks powered by face recognition for web sites &amp; apps.</p>          </cardcontent></card><card><cardheader><cardtitle classname="flex items-center text-base sm:text-lg"><falock classname="mr-2"></falock> privacy-focused            </cardtitle></cardheader><cardcontent><p classname="text-sm sm:text-base">your facial data is encrypted and securely stored. we prioritize user privacy and data protection.</p>          </cardcontent></card><card><cardheader><cardtitle classname="flex items-center text-base sm:text-lg"><facode classname="mr-2"></facode> developer-friendly            </cardtitle></cardheader><cardcontent><p classname="text-sm sm:text-base">easy integration with clear documentation. get started quickly and implement facial authentication in your projects.</p>          </cardcontent></card><card><cardheader><cardtitle classname="flex items-center text-base sm:text-lg"><fachartbar classname="mr-2"></fachartbar> analytics &amp; insights            </cardtitle></cardheader><cardcontent><p classname="text-sm sm:text-base">gain valuable insights into user authentication patterns and improve your applications security.</p>          </cardcontent></card></div>      <div classname="flex flex-col sm:flex-row justify-center items-center space-y-4 sm:space-y-0 sm:space-x-4 mt-8">        <button variant="default" size="lg" classname="w-full sm:w-auto">          get started →        </button>        <button variant="outline" size="lg" classname="w-full sm:w-auto">          integration guide →        </button>        <button variant="secondary" size="lg" classname="w-full sm:w-auto">          faceio console →        </button>      </div>      <card classname="mt-8 bg-gray-100"><cardcontent classname="text-center py-6"><p classname="text-base sm:text-lg font-semibold">ready to implement facial authentication in your project?</p>          <p classname="mt-2 text-sm sm:text-base">check out our documentation and start securing your application today!</p>        </cardcontent></card></div>  );};export default dashboard;</dashboardprops>

3.将 dashboard.tsx 组件导入 login.tsx 组件:

/* eslint-disable react-hooks/exhaustive-deps */"use client";import {  card,  cardcontent,  carddescription,  cardfooter,  cardheader,  cardtitle,} from "@/components/ui/card";import { terminal } from "lucide-react";import { mailicon, checkcircleicon } from "lucide-react";import { alert, alertdescription, alerttitle } from "@/components/ui/alert";import { input } from "@/components/ui/input";import { label } from "@/components/ui/label";import { button } from "./ui/button";import faceio from "@faceio/fiojs";import { useeffect, useref, usestate } from "react";import link from "next/link";import { toast } from "sonner";import dashboard from "./dashboard";type props = {};const login: react.fc<props> = ({}) =&gt; {  const faceioref = useref<faceio null>(null);  const [email, setemail] = usestate("");  const [userlogin, setuserlogin] = usestate("");  const [isloggedin, setisloggedin] = usestate(false);  const publickey = process.env.next_public_faceio_public_id as string;  const initialisefaceio = async () =&gt; {    try {      faceioref.current = new faceio(publickey);      console.log("faceio initialized successfully");    } catch (error) {      console.log(error);      handleerror(error);    }  };  useeffect(() =&gt; {    initialisefaceio();  }, []);  const handleregister = async () =&gt; {    try {      if (!faceioref.current) {        console.error("faceio instance is not initialized");        return;      }      await faceioref.current?.enroll({        userconsent: false,        locale: "auto",        payload: { email: `${email}` },      });      toast.success("successfully registered user.");    } catch (error) {      handleerror(error);      faceioref.current?.restartsession();    }  };  const handlelogin = async () =&gt; {    try {      const authenticate = await faceioref.current?.authenticate();      console.log("user authenticated successfully:", authenticate);      setuserlogin(authenticate.payload.email);      setisloggedin(true);      toast.success("successfully logged in.");    } catch (error) {      console.log(error);      handleerror(error);    }  };  const handlelogout = () =&gt; {    setisloggedin(false);    setuserlogin("");    toast.success("successfully logged out.");  };  function handleerror(errcode: any) {    const fioerrs = faceioref.current?.fetchallerrorcodes()!;    switch (errcode) {      case fioerrs.permission_refused:        toast.info("access to the camera stream was denied by the end user");        break;      case fioerrs.no_faces_detected:        toast.info(          "no faces were detected during the enroll or authentication process"        );        break;      case fioerrs.unrecognized_face:        toast.info("unrecognized face on this application's facial index");        break;      case fioerrs.many_faces:        toast.info("two or more faces were detected during the scan process");        break;      case fioerrs.face_duplication:        toast.info(          "user enrolled previously (facial features already recorded). cannot enroll again!"        );        break;      case fioerrs.minors_not_allowed:        toast.info("minors are not allowed to enroll on this application!");        break;      case fioerrs.pad_attack:        toast.info(          "presentation (spoof) attack (pad) detected during the scan process"        );        break;      case fioerrs.face_mismatch:        toast.info(          "calculated facial vectors of the user being enrolled do not matches"        );        break;      case fioerrs.wrong_pin_code:        toast.info("wrong pin code supplied by the user being authenticated");        break;      case fioerrs.processing_err:        toast.info("server side error");        break;      case fioerrs.unauthorized:        toast.info(          "your application is not allowed to perform the requested operation (eg. invalid id, blocked, paused, etc.). refer to the faceio console for additional information"        );        break;      case fioerrs.terms_not_accepted:        toast.info(          "terms &amp; conditions set out by faceio/host application rejected by the end user"        );        break;      case fioerrs.ui_not_ready:        toast.info(          "the faceio widget could not be (or is being) injected onto the client dom"        );        break;      case fioerrs.session_expired:        toast.info(          "client session expired. the first promise was already fulfilled but the host application failed to act accordingly"        );        break;      case fioerrs.timeout:        toast.info(          "ongoing operation timed out (eg, camera access permission, tos accept delay, face not yet detected, server reply, etc.)"        );        break;      case fioerrs.too_many_requests:        toast.info(          "widget instantiation requests exceeded for freemium applications. does not apply for upgraded applications"        );        break;      case fioerrs.empty_origin:        toast.info("origin or referer http request header is empty or missing");        break;      case fioerrs.forbiddden_origin:        toast.info("domain origin is forbidden from instantiating fio.js");        break;      case fioerrs.forbiddden_country:        toast.info(          "country iso-3166-1 code is forbidden from instantiating fio.js"        );        break;      case fioerrs.session_in_progress:        toast.info(          "another authentication or enrollment session is in progress"        );        break;      case fioerrs.network_io:      default:        toast.info(          "error while establishing network connection with the target faceio processing node"        );        break;    }  }  if (isloggedin) {    return <dashboard useremail="{userlogin}" onlogout="{handlelogout}"></dashboard>;  }  return (    <div classname="min-h-screen bg-gradient-to-r from-cyan-500 to-blue-500 flex items-center justify-center p-4 w-full">      <card classname="w-[400px] bg-white shadow-xl rounded-xl overflow-hidden"><cardheader classname="bg-gray-50 border-b p-6"><cardtitle classname="text-2xl font-bold text-gray-800">            secure workspace          </cardtitle><carddescription classname="text-sm text-gray-600">            authenticate to access your personalized work environment          </carddescription></cardheader><cardcontent classname="p-6 space-y-4"><div classname="space-y-2">            <label htmlfor="email" classname="text-sm font-medium text-gray-700">              work email            </label>            <input id="email" type="email" placeholder="you@company.com" classname="w-full px-3 py-2 border rounded-md" onchange="{(e)"> setemail(e.target.value)}            /&gt;          </div>          <div classname="space-y-4">            <button classname="w-full bg-blue-600 hover:bg-blue-700 text-white font-medium py-2 rounded-md transition duration-300 ease-in-out" onclick="{handlelogin}">              access workspace            </button>            <button classname="w-full bg-gray-100 hover:bg-gray-200 text-gray-800 font-medium py-2 rounded-md transition duration-300 ease-in-out" onclick="{handleregister}" disabled>              register new account            </button>          </div>        </cardcontent><cardfooter classname="bg-gray-50 border-t p-4"><div classname="w-full text-center text-xs text-gray-500">            protected by faceio™ technology.            <link href="https://faceio.net/security-policy" classname="text-blue-600 hover:underline ml-1">              learn about our security measures                      </div>        </cardfooter></card>      {userlogin &amp;&amp; !isloggedin &amp;&amp; (        <div classname="fixed bottom-4 right-4 bg-green-100 border-l-4 border-green-500 text-green-700 p-4 rounded-md shadow-lg">          <div classname="flex">            <div classname="flex-shrink-0">              <checkcircleicon classname="h-5 w-5 text-green-500"></checkcircleicon></div>            <div classname="ml-3">              <p classname="text-sm font-medium">workspace access granted</p>              <p classname="text-xs mt-1">logged in as: {userlogin}</p>            </div>          </div>        </div>      )}    </div>  );};export default login;</faceio></props>

记得将 'next_public_faceio_public_id' 替换为您从 faceio 控制台获取的实际 faceio_app_id。

  1. 将人脸验证组件集成到您的 next.js 页面中:在 next.js 应用程序的主页(例如 app/page.tsx)中,导入 home 组件并渲染它:
import { buttonVariants } from "@/components/ui/button";import { cn } from "@/lib/utils";import Link from "next/link";import { FaUserShield, FaImage, FaCode, FaRobot } from 'react-icons/fa';export default function Home() {  const demos = [    { title: "FACIO Web Authentication", href: "/faceio", icon: FaUserShield },    { title: "Image Processing", href: "/imageprocessing", icon: FaImage },    { title: "Code Generation", href: "/codegeneration", icon: FaCode },    { title: "AI Assistant", href: "/aiassistant", icon: FaRobot },  ];  return (    <div classname="max-h-screen  bg-gradient-to-br from-purple-700 via-blue-600 to-teal-500 text-white p-8 w-full">      <div classname="max-w-6xl mx-auto">        <h1 classname="text-5xl md:text-7xl font-bold text-center mb-8 animate-fade-in-down">          PixLab Faceio        </h1>        <p classname="text-xl text-center mb-12 animate-fade-in-up">          Explore cutting-edge technologies and innovative solutions        </p>        <div classname="grid grid-cols-1 md:grid-cols-2 gap-8">          {demos.map((demo, index) =&gt; (            <link key="{demo.href}" href="%7Bdemo.href%7D" classname="{cn(" buttonvariants variant: text-lg font-semibold flex flex-col items-center justify-center space-y-4 bg-white bg-opacity-10 backdrop-filter backdrop-blur-lg rounded-xl hover:bg-opacity-20 transition-all duration-300 animate-fade-in index><demo.icon classname="text-4xl"></demo.icon>              {demo.title}                      ))}        </div>        <div classname="mt-16 text-center animate-fade-in-up animate-delay-300">          <h2 classname="text-3xl font-bold mb-4">Why Choose PixLab?</h2>          <ul classname="text-lg space-y-2"><li>✨ Cutting-edge technologies</li>            <li>? High-performance solutions</li>            <li>? Advanced security features</li>            <li>? Seamless integrations</li>          </ul></div>        <footer classname="mt-16 text-center text-sm opacity-75 animate-fade-in-up animate-delay-500">          © 2024 PixLab. All rights reserved. Empowering innovation through technology.        </footer></div>    </div>  );}

就是这样!您现在已将 faceio 的人脸身份验证集成到您的 next.js 应用程序中。当用户点击“面部验证”按钮时,faceio 小部件将会出现,指导他们完成身份验证过程。

捕获正在运行的 faceio 小部件 - 注册

为了演示 faceio 小部件的功能,让我们捕获注册过程的 gif:

此 gif 展示了 next.js 应用程序中 faceio 人脸注册过程的用户体验。用户可以轻松注册自己的脸部,用于以后登录时的无缝身份验证。

捕获正在运行的 faceio 小部件

为了演示 faceio 小部件的功能,让我们捕获身份验证过程的 gif:

此 gif 展示了 next.js 应用程序中 faceio 人脸身份验证过程的用户体验。

faceio 应用程序的关键安全最佳实践

在 next.js 应用程序中使用 faceio 的好处

将 faceio 集成到您的 next.js 应用程序中具有以下几个好处:

结论

在这篇博文中,您学习了如何将 faceio 的人脸身份验证服务集成到您的 next.js 应用程序中。通过执行此处概述的步骤,您现在可以为用户提供安全且用户友好的身份验证体验,从而提高 web 应用程序的整体质量。

如果您还有任何其他问题或需要其他帮助,请随时联系 faceio 支持团队或浏览全面的 faceio 文档。

快乐编码!

有关此实现的完整源代码,您可以访问 github 存储库并详细探索该项目。