A SilentShield egy láthatatlan, GDPR-kompatibilis CAPTCHA-alternatíva React és Next.js alkalmazásokhoz. Betölt egy könnyű kliensszkriptet, tokent kap, és a szerveren ellenőrzi azt a @forge12interactive/silentshield-sdk-js csomaggal és egyetlen API-kulccsal. Nincsenek sütik és nincs weboldalakon átívelő nyomon követés, a tárhely pedig alapértelmezés szerint az EU-ban van.
Láthatatlan CAPTCHA ehhez: React & Next.js
Bármely React vagy Next.js alkalmazással működik a könnyűsúlyú SilentShield szkript segítségével: küldéskor lekér egy nonce-ot, és a backenden a @forge12interactive/silentshield-sdk-js segítségével ellenőrzi. Láthatatlan és GDPR-kompatibilis.

Developer Experience
Kódpéldák
A kliensszkript beágyazása
<!-- In <head> or before </body> of every page with a form -->
<script src="https://api.silentshield.io/client.js?k=YOUR_API_KEY" defer></script>React komponens
import React, { useState } from "react";
export default function ContactForm() {
const [loading, setLoading] = useState(false);
const [message, setMessage] = useState("");
const handleSubmit = async (e) => {
e.preventDefault();
setLoading(true);
try {
// client.js injects a hidden behavior_nonce input into the form —
// read it from the form data (there is no global SilentShield object).
const formData = new FormData(e.currentTarget);
const nonce = formData.get("behavior_nonce");
// Verify on your backend
const res = await fetch("/api/verify", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ nonce }),
});
const data = await res.json();
if (res.ok && data.success) {
setMessage("Successfully verified!");
// Process form submission
} else {
setMessage("Bot detected. Please try again.");
}
} catch (error) {
console.error("Verification failed:", error);
setMessage("Verification failed. Please try again.");
} finally {
setLoading(false);
}
};
return (
<form onSubmit={handleSubmit}>
<input type="email" placeholder="Email" required />
<button type="submit" disabled={loading}>
{loading ? "Verifying..." : "Submit"}
</button>
{message && <p>{message}</p>}
</form>
);
}Backend-ellenőrzés (Next.js)
// app/api/verify/route.ts
export async function POST(req: Request) {
const { nonce } = await req.json();
const res = await fetch("https://api.silentshield.io/api/v1/captcha/verify-nonce", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Api-Key": process.env.SILENTSHIELD_API_KEY!,
},
body: JSON.stringify({ nonce: nonce }),
signal: AbortSignal.timeout(5000),
});
const result = await res.json().catch(() => ({}));
const human = res.ok && result.ok === true && result.verdict === "human" && result.confidence >= 0.7;
if (!human) {
return Response.json({ error: "Bot detected" }, { status: 403 });
}
// Human — process the form
return Response.json({ success: true });
}Hogyan működik a SilentShield a Reactben
A SilentShield betölt egy kis kliensszkriptet, amely láthatatlan ellenőrzést végez, miközben a felhasználó az űrlappal dolgozik. Beküldéskor a React vagy Next.js komponense elküldi a generált tokent a háttérrendszeréhez, ahol a @forge12interactive/silentshield-sdk-js csomaggal ellenőrzi. A felhasználók soha nem látnak rejtvényt, és a bundle könnyű marad, mert nincs megjelenítendő nehéz widget.
Kliensszkript és szerveroldali ellenőrzés
Nincs külön @silentshield/react webes csomag, amelyet telepíteni kellene — a SilentShield bármely React vagy Next.js alkalmazásban működik a kliensszkripten és egy szerveroldali ellenőrzésen keresztül. Hozzáadja a https://api.silentshield.io/client.js?k=YOUR_API_KEY szkriptet, kiolvassa a tokent a komponensében, és megerősíti a https://api.silentshield.io/api/v1/captcha/verify-nonce címmel szemben az X-Api-Key fejléc használatával egy route handlerből vagy API útvonalból.
Beállítási útmutató
Hozzon létre egy fiókot, és másolja ki az API-kulcsát. Adja hozzá a SilentShield kliensszkriptet az alkalmazásához, és rögzítse a tokent az űrlap beküldésekor. Telepítse a @forge12interactive/silentshield-sdk-js csomagot a szerverén, hozza létre a klienst az API-kulcsával, és hívja meg a verify függvényt a tokennel. Ha az eredmény ember, dolgozza fel a kérést; egyébként utasítsa el.
Adatvédelem és akadálymentesség alapértelmezés szerint
A SilentShield nem használ sütiket és weboldalakon átívelő nyomon követést; az IP-cím csak az ellenőrzést szolgálja, és nem tároljuk nyílt szövegként. Így az alkalmazását GDPR-kompatibilis módon védheti. Az ellenőrzés alapértelmezés szerint a németországi szervereinken fut. A láthatatlan ellenőrzés megfelel a WCAG 2.1 AA szabványnak, ami az űrlapjait használhatóvá teszi a billentyűzetet és képernyőolvasót használók számára bármilyen vizuális kihívás nélkül.
Integrálja most a Reacttel
Illessze be a szkriptet, és ellenőrizzen a szerverén – a @forge12interactive/silentshield-sdk-js csomaggal vagy anélkül.
Gyakran ismételt kérdések
Hogyan adhatok CAPTCHA-t egy React-alkalmazáshoz?
Töltse be a SilentShield `https://api.silentshield.io/client.js?k=YOUR_API_KEY` kliensszkriptet a React- vagy Next.js-alkalmazásában, beküldéskor szerezzen egy nonce-t, és ellenőrizze azt a háttérrendszerén a `https://api.silentshield.io/v1/verify` címen a `@forge12interactive/silentshield-sdk-js` SDK használatával. Nincs külön React webes csomag — a minta a kliensszkript és a háttéroldali ellenőrzés.
Van SilentShield React-csomag?
Nincs külön React-webcsomag. Reactban és Next.js-ben hozzáadja a kliens szkriptet (`https://api.silentshield.io/client.js?k=YOUR_API_KEY`), és a beszúrt `behavior_nonce`-t a backendjén ellenőrzi — néhány sor fetch-csel vagy a hivatalos `@forge12interactive/silentshield-sdk-js` csomaggal. A mobilalkalmazásokhoz készült React Native SDK jelenleg kérésre érhető el (early access).
Hogyan működik a SilentShield a Next.js-szel?
A Next.js-ben belefoglalja a SilentShield kliensszkriptet az oldalaiba, majd a nonce-t szerveroldalon ellenőrzi — egy route handlerben vagy API route-ban — a `@forge12interactive/silentshield-sdk-js` SDK-val, amely a `https://api.silentshield.io/v1/verify` címet hívja az `api-key` fejléccel. Ez láthatatlanul, egyetlen API-kulccsal védi az űrlapokat.
Támogatja a SilentShield a React Native-t?
A mobilalkalmazásokhoz készült React Native SDK jelenleg early accessben van — kérd a [email protected] címen. A backend-ellenőrzés már ma működik a `@forge12interactive/silentshield-sdk-js` csomaggal vagy egy egyszerű HTTP-hívással a `https://api.silentshield.io/api/v1/captcha/verify-nonce` végpontra, és képrejtvények nélkül blokkolja az automatizált visszaéléseket.
GDPR-kompatibilis a SilentShield egy React-alkalmazásban?
Igen. Keretrendszertől függetlenül a SilentShield németországi szervereinken őrzi az adatokat, nem állít be sütiket, és nem végez weboldalakon átívelő nyomkövetést. A React-frontendje egyetlen kliensszkriptet tölt be, a háttérrendszere pedig ellenőrzi a nonce-t; az IP-címet nem tároljuk nyílt szövegként.
Sok többletterhelést ad a SilentShield egy React-alkalmazáshoz?
Alig. A SilentShield egy körülbelül 49 KB-os kliensszkriptet tölt be (gzip, mérve 2026. 09. 23-án) képfájlok nélkül. Az ellenőrzés viselkedési jelek és egy proof-of-work nonce alapján történik, amelyet az Ön háttérrendszere ellenőriz, harmadik feles nyomkövető hívások nélkül.