@centinel/nextjs
v1.2.2
Published
Package designed to add Centinel Analytica functionality to Next.js applications
Downloads
222
Maintainers
centinel-analyticaReadme
Centinel Analytica Next.js Integration
Bot protection middleware for Next.js applications.
Installation
npm install @centinel/nextjsSetup
1. Environment Variables
CENTINEL_SITE_KEY=your_site_key_here
CENTINEL_SECRET_KEY=your_secret_key_here
NEXT_PUBLIC_CENTINEL_SITE_KEY=your_site_key_here2. Client Script
// app/layout.tsx
import { CentinelLayout } from '@centinel/nextjs';
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html>
<body>
<CentinelLayout siteKey={process.env.CENTINEL_SITE_KEY!}>
{children}
</CentinelLayout>
</body>
</html>
);
}3. Middleware
Simple Middleware
import { createCentinelMiddlewareFromEnv } from '@centinel/nextjs';
import { NextRequest } from 'next/server';
const centinelMiddleware = createCentinelMiddlewareFromEnv();
export default async function middleware(request: NextRequest) {
const result = await centinelMiddleware(request);
return result.response;
}
export const config = {
matcher: ['/api/:path*', '/dashboard/:path*']
};With Multiple Middlewares
import { createCentinelMiddleware } from '@centinel/nextjs';
import { NextRequest, NextResponse } from 'next/server';
const centinelMiddleware = createCentinelMiddleware({
siteKey: process.env.CENTINEL_SITE_KEY!,
secretKey: process.env.CENTINEL_SECRET_KEY!
});
export default async function middleware(request: NextRequest) {
const result = await centinelMiddleware(request);
if (result.should_intercept) {
return result.response;
}
// Your other middleware logic
return NextResponse.next();
}
export const config = {
matcher: ['/api/:path*', '/dashboard/:path*']
};Manual Validation (API Routes)
// app/api/login/route.ts
import { createRequestValidatorFromEnv } from '@centinel/nextjs';
import { NextRequest, NextResponse } from 'next/server';
const { isBot } = createRequestValidatorFromEnv();
export async function POST(request: NextRequest) {
if (await isBot(request)) {
return NextResponse.json({ error: 'Blocked' }, { status: 403 });
}
return handleLogin(request);
}Advanced
CentinelResult
interface CentinelResult {
response: NextResponse;
decision: 'allow' | 'block' | 'redirect' | 'not_matched';
should_intercept: boolean;
}should_intercept: true→blockorredirect(return immediately)should_intercept: false→allowornot_matched(continue)
CentinelMiddleware Class
import { CentinelMiddleware } from '@centinel/nextjs';
const centinel = new CentinelMiddleware({
siteKey: process.env.CENTINEL_SITE_KEY!,
secretKey: process.env.CENTINEL_SECRET_KEY!,
timeout: 1000, // ms (default: 500)
debugMode: true
});
const result = await centinel.validate({ request });Check Cookie in API Routes
export async function POST(request: NextRequest) {
if (!request.cookies.get('_centinel')) {
return NextResponse.json({ error: 'Blocked' }, { status: 403 });
}
// ...
}