This repository demonstrates how to add passkey login functionality to your Next.js app using the Hanko Passkey API. Passkey authentication is a secure and user-friendly alternative to traditional password-based authentication, providing a seamless login experience for users.
For a detailed tutorial on implementing passkey login in your Next.js app, refer to our blog post: How to add passkeys to your Next.js Application
Before you begin, ensure you have the following:
- Node.js installed (version 20.0.0 or later)
- Hanko Passkey API key and tenant ID from Hanko Cloud
Note: You'll need to create a Passkey Project on Hanko Cloud with the App URL
http://localhost:3000. See our docs to learn how to setup a passkey project.
- Clone the repository
git clone https://github.com/teamhanko/passkeys-nextjs.git-
Set up environment variables
- Create a
.envfile in the root directory and add the following environment variables:
PASSKEYS_API_KEY=your-hanko-passkey-api-key PASSKEYS_TENANT_ID=your-hanko-passkey-tenant-id
- Replace
your-hanko-passkey-api-keyandyour-hanko-passkey-tenant-idwith your actual Hanko Passkey API key and tenant ID.
- Create a
-
Install the dependencies using your preferred package manager (e.g.,
npm,pnpm,yarn, orbun). For this project, we've usedpnpm:
pnpm install- Start the development server:
pnpm dev-
Start the application:
- Access the application by navigating to
http://localhost:3000in your web browser.
- Access the application by navigating to
-
Log in with a pre-configured user: Navigate to login page, login with one of the pre-configured users.
{
"id": "b3fbbdbd-6bb5-4558-9055-3b54a9469629",
"email": "[email protected]",
"password": "password123",
},
{
"id": "22c81b3d-1e7d-4a72-a6b0-ad946e0c0965",
"email": "[email protected]",
"password": "very_secure_password",
},
{
"id": "55c81b3d-1e7d-4a72-a6b0-ad946e0c0965",
"email": "[email protected]",
"password": "123",
}-
Register a passkey:
- After logging in, register a passkey for the logged-in user.
-
Log out:
- After the passkey registration is successful, log out of the application.
-
Login with with a passkey
- On the login page, choose sign in with a passkey option to authenticate using a passkey.
Feel free to reach out to us on Discord if you get into any issues.
This project is licensed under the MIT License.