Bot Detection with Botd

name: Bot Detection with Botd slug: bot-protection-botd description: Botd is a browser library for bot detection. In this template we'll be using it alongside botd-integrations for bot detection at the edge. framework: Next.js useCase: Edge Middleware css: Tailwind deployUrl: /new/clone?repository-url=https://github.com/vercel/examples/tree/main/edge-middleware/bot-protection-botd&env=NEXT_PUBLIC_BOTD_API_TOKEN&project-name=bot-protection-botd&repository-name=bot-protection-botd demoUrl: https://edge-functions-bot-protection-botd.vercel.app relatedTemplates:

• bot-protection-datadome

Bot Detection with Botd

Botd (by FingerprintJS) is a browser library for bot detection. In this demo we'll be using it alongside botd-integrations for bot detection at the edge.

Demo

https://edge-functions-bot-protection-botd.vercel.app

If you try and go to /blocked you'll see the /bot-detected page being rendered instead, done by a rewrite from the edge after it identifies you as a bot. We do that by changing the user agent of the request before making a request to Botd.

How to Use

You can choose from one of the following two methods to use this repository:

One-Click Deploy

Deploy the example using Edgenivo:

Clone and Deploy

Execute create-next-app with pnpm to bootstrap the example:

1
pnpm create next-app --example https://github.com/vercel/examples/tree/main/edge-middleware/bot-protection-botd bot-protection-botd

You'll need to have a token for the beta access of Botd, the token is free and there are instructions in their github repo on how to get one.

Once that's done, copy the .env.example file in this directory to .env.local (which will be ignored by Git):

1
cp .env.example .env.local

Then open .env.local and set the Botd API token to match your token.

Next, run Next.js in development mode:

1
pnpm dev

Deploy it to the cloud with Edgenivo (Documentation).