SilentShield je neviditelná alternativa CAPTCHA v souladu s GDPR pro aplikace React a Next.js. Načtete odlehčený klientský skript, získáte token a ověříte jej na serveru pomocí balíčku @forge12interactive/silentshield-sdk-js a jediného API klíče. Nejsou zde žádné cookies ani sledování napříč weby a hosting je ve výchozím nastavení v EU.
Neviditelná CAPTCHA pro React & Next.js
Funguje s libovolnou aplikací React nebo Next.js díky odlehčenému skriptu SilentShield: při odeslání získáte nonce a ověříte ho na backendu pomocí @forge12interactive/silentshield-sdk-js. Neviditelná a v souladu s GDPR.

Developer Experience
Příklady kódu
Vložení klientského skriptu
<!-- 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 komponenta
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>
);
}Ověření na backendu (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 });
}Jak SilentShield funguje v Reactu
SilentShield načte malý klientský skript, který provádí neviditelnou kontrolu, zatímco uživatel interaguje s vaším formulářem. Při odeslání vaše komponenta React nebo Next.js pošle vygenerovaný token na váš backend, kde jej ověříte pomocí balíčku @forge12interactive/silentshield-sdk-js. Uživatelé nikdy nevidí hádanku a váš bundle zůstává lehký, protože se nevykresluje žádný náročný widget.
Klientský skript plus serverové ověření
Není třeba instalovat žádný samostatný webový balíček @silentshield/react — SilentShield funguje v jakékoli aplikaci React nebo Next.js prostřednictvím klientského skriptu a serverového ověření. Přidáte skript https://api.silentshield.io/client.js?k=YOUR_API_KEY, přečtete token ve své komponentě a potvrdíte jej oproti https://api.silentshield.io/api/v1/captcha/verify-nonce pomocí hlavičky X-Api-Key z route handleru nebo API route.
Postup nastavení
Vytvořte účet a zkopírujte svůj API klíč. Přidejte klientský skript SilentShield do své aplikace a zachyťte token při odeslání formuláře. Nainstalujte @forge12interactive/silentshield-sdk-js na svůj server, vytvořte klienta se svým API klíčem a zavolejte verify s tokenem. Pokud je výsledkem člověk, zpracujte požadavek; jinak jej odmítněte.
Soukromí a přístupnost ve výchozím nastavení
SilentShield nepoužívá žádné cookies ani sledování napříč weby; IP adresa slouží pouze k ověření a neukládá se v otevřené podobě. Vaši aplikaci tak lze chránit v souladu s GDPR. Ověřování ve výchozím nastavení běží na našich serverech v Německu. Neviditelná kontrola splňuje WCAG 2.1 AA, což udržuje vaše formuláře použitelné pro uživatele klávesnice a čteček obrazovky bez jakékoli vizuální výzvy.
Integrujte React nyní
Vložte skript a kontrolujte na svém serveru – s @forge12interactive/silentshield-sdk-js nebo bez něj.
Časté dotazy
Jak přidat CAPTCHA do aplikace React?
Načtěte klientský skript SilentShield `https://api.silentshield.io/client.js?k=YOUR_API_KEY` ve své aplikaci React nebo Next.js, při odeslání získejte nonce a ověřte jej na svém backendu na adrese `https://api.silentshield.io/v1/verify` pomocí SDK `@forge12interactive/silentshield-sdk-js`. Neexistuje žádný samostatný webový balíček pro React — vzorem je klientský skript plus backendové ověření.
Existuje balíček React pro SilentShield?
Samostatný webový balíček pro React neexistuje. V Reactu a Next.js přidáte klientský skript `https://api.silentshield.io/client.js?k=YOUR_API_KEY` a vložený `behavior_nonce` ověříte na svém backendu — několika řádky fetch nebo oficiálním balíčkem `@forge12interactive/silentshield-sdk-js`. React Native SDK pro mobilní aplikace je momentálně k dispozici na vyžádání (early access).
Jak SilentShield funguje s Next.js?
V Next.js zahrnete klientský skript SilentShield do svých stránek a poté ověříte nonce na straně serveru — v route handleru nebo API route — pomocí SDK `@forge12interactive/silentshield-sdk-js`, které volá `https://api.silentshield.io/v1/verify` s hlavičkou `api-key`. Tím se formuláře chrání neviditelně jediným API klíčem.
Podporuje SilentShield React Native?
React Native SDK pro mobilní aplikace je momentálně v early access — vyžádejte si ho na [email protected]. Ověřování na backendu funguje už dnes s `@forge12interactive/silentshield-sdk-js` nebo jednoduchým HTTP voláním na `https://api.silentshield.io/api/v1/captcha/verify-nonce` a blokuje automatizované zneužití, aniž by uživatelům ukazovalo hádanky.
Je SilentShield v souladu s GDPR v aplikaci React?
Ano. Bez ohledu na framework uchovává SilentShield data na našich serverech v Německu, nenastavuje žádné cookies a nesleduje napříč weby. Váš React frontend načítá jediný klientský skript a váš backend ověřuje nonce; IP adresa se neukládá v čitelné podobě.
Přidává SilentShield velkou zátěž aplikaci React?
Téměř ne. SilentShield načítá klientský skript o velikosti zhruba 49 KB (gzip, měřeno 23. 9. 2026) bez obrazových souborů. Ověření probíhá pomocí behaviorálních signálů a proof-of-work nonce, kontrolovaného na vašem backendu, bez sledovacích volání třetích stran.