← Cloudflare Pages / pages / functions / plugins

hCaptcha

hCaptcha Pages Plugin ověřuje tokeny hCaptcha.

npm i @cloudflare/pages-plugin-hcaptcha

import hCaptchaPlugin from "@cloudflare/pages-plugin-hcaptcha";

export const onRequestPost: PagesFunction[] = [
	hCaptchaPlugin({
		secret: "0x0000000000000000000000000000000000000000",
		sitekey: "10000000-ffff-ffff-ffff-000000000001",
	}),
	async (context) => {
		// Request has been validated as coming from a human

		const formData = await context.request.formData();

		// Store user credentials

		return new Response("Successfully registered!");
	},
];

Tento Plugin zpřístupňuje pouze jednu trasu. Bude dostupný tam, kam ho připojíte. V předchozím příkladu je připojen v functions/register.ts, ověří požadavky na /register. Plugin se připojuje pomocí jediného parametru typu objekt s následujícími vlastnostmi.

secret ↗ (povinné) a sitekey ↗ (nepovinné) najdete obě v dashboardu hCaptcha.

response a remoteip jsou volitelné řetězce. response token hCaptcha k ověření (výchozí hodnotou je extrahování h-captcha-response z multipart/form-data požadavek). remoteip by měla být IP adresa žadatele (výchozí hodnotou je CF-Connecting-IP hlavičky požadavku).

onError je volitelná funkce, která přijímá kontextový objekt Pages Function a vrací Promise z Response. Ve výchozím nastavení vrátí chybu čitelnou pro člověka Response.

data.hCaptcha se naplní v následujících Pages Functions (mimo jiné pro onError funkci) s objekt odpovědi hCaptcha ↗.