SilentShield je nevidna, s Splošno uredbo o varstvu podatkov skladna alternativa CAPTCHA za aplikacije React in Next.js. Naložite lahek odjemalski skript, pridobite žeton in ga preverite na strežniku s paketom @forge12interactive/silentshield-sdk-js in enim ključem API. Ni piškotkov, sledenja ali osebnih podatkov, gostovanje pa poteka privzeto izključno v EU.

Nevidni CAPTCHA za React & Next.js

Deluje s katero koli aplikacijo React ali Next.js prek lahke skripte SilentShield: ob oddaji pridobite nonce in ga na zaledju preverite z @forge12interactive/silentshield-sdk-js. Neviden in skladen z GDPR.

Integracija CAPTCHA v Reactu

Developer Experience

Neodvisen od ogrodja — deluje s katero koli aplikacijo React ali Next.js
Lahka odjemalska skripta — težek paket React ni potreben
Temelji na nonce — neviden, brez interakcije uporabnika
@forge12interactive/silentshield-sdk-js za preverjanje na zaledju
Deluje z App Router in Pages Router
Prijazen do TypeScripta

Primeri kode

Vdelava odjemalske skripte

<!-- Add to <head> with SRI for security -->
(function () {
  var KEY = "YOUR_API_KEY";
  var SITE = location.hostname;
  var V = "2025.09.1";
  var s = document.createElement('script');
  s.src = "https://api.silentshield.io/client.js?k=" + encodeURIComponent(KEY)
    + "&v=" + encodeURIComponent(V)
    + "&site=" + encodeURIComponent(SITE);
  s.async = true;
  s.crossOrigin = "anonymous";
  document.head.appendChild(s);
})();

Komponenta React

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>
  );
}

Preverjanje na zaledju (Next.js)

// app/api/verify/route.ts
import { SilentShield } from "@forge12interactive/silentshield-sdk-js";

export async function POST(req: Request) {
  const { nonce } = await req.json();
  const result = await SilentShield.verifyNonce(nonce, process.env.SILENTSHIELD_API_KEY);
  const human = result.ok && 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 });
}

Kako SilentShield deluje v Reactu

SilentShield naloži majhen odjemalski skript, ki izvaja nevidno preverjanje, medtem ko uporabnik komunicira z vašim obrazcem. Ob oddaji vaša komponenta React ali Next.js pošlje ustvarjeni žeton v vaš zaledni sistem, kjer ga preverite s paketom @forge12interactive/silentshield-sdk-js. Uporabniki nikoli ne vidijo uganke, vaš bundle pa ostane lahek, ker ni težkega gradnika za izris.

Odjemalski skript in strežniško preverjanje

Ni ločenega spletnega paketa @silentshield/react za namestitev — SilentShield deluje v kateri koli aplikaciji React ali Next.js prek odjemalskega skripta in preverjanja na strani strežnika. Dodate skript https://api.silentshield.io/client.js?k=YOUR_API_KEY, preberete žeton v svoji komponenti in ga potrdite proti https://api.silentshield.io/v1/verify z uporabo glave api-key iz route handlerja ali poti API.

Vodnik za nastavitev

Ustvarite račun in kopirajte svoj ključ API. Dodajte odjemalski skript SilentShield v svojo aplikacijo in zajemite žeton, ko je obrazec oddan. Namestite @forge12interactive/silentshield-sdk-js na svoj strežnik, ustvarite odjemalca s svojim ključem API in pokličite verify z žetonom. Če je rezultat človek, obdelajte zahtevo; sicer jo zavrnite.

Zasebnost in dostopnost privzeto

SilentShield ne shranjuje piškotkov, ne izvaja sledenja in ne zbira osebnih podatkov, zato vaša aplikacija ostane skladna s Splošno uredbo o varstvu podatkov. Preverjanje se privzeto izvaja na infrastrukturi izključno v EU. Nevidno preverjanje izpolnjuje WCAG 2.1 AA, kar ohranja vaše obrazce uporabne za uporabnike tipkovnice in bralnikov zaslona brez kakršnega koli vizualnega izziva.

Integrirajte z Reactom zdaj

Dodajte skripto, preverite z @forge12interactive/silentshield-sdk-js — pripravljeno v nekaj minutah.

Pogosta vprašanja

Kako dodam CAPTCHA v aplikacijo React?

Naložite odjemalsko skripto SilentShield `https://api.silentshield.io/client.js?k=YOUR_API_KEY` v svojo aplikacijo React ali Next.js, ob oddaji pridobite žeton in ga preverite na svojem zaledju na naslovu `https://api.silentshield.io/v1/verify` z uporabo SDK-ja `@forge12interactive/silentshield-sdk-js`. Ni ločenega spletnega paketa za React — odjemalska skripta in zaledno preverjanje sta vzorec.

Ali obstaja paket SilentShield za React?

Ločenega spletnega paketa za React ni. V Reactu in Next.js-u dodate odjemalsko skripto `https://api.silentshield.io/client.js?k=YOUR_API_KEY` in vstavljeni `behavior_nonce` preverite na svojem zaledju — z nekaj vrsticami fetch ali z uradnim paketom `@forge12interactive/silentshield-sdk-js`. React Native SDK za mobilne aplikacije je trenutno na voljo na zahtevo (zgodnji dostop).

Kako SilentShield deluje z Next.js?

V Next.js vključite odjemalsko skripto SilentShield na svoje strani, nato preverite žeton na strani strežnika — v obravnavalniku poti ali poti API — s SDK-jem `@forge12interactive/silentshield-sdk-js`, ki pokliče `https://api.silentshield.io/v1/verify` z glavo `api-key`. To nevidno ščiti obrazce z enim ključem API.

Ali SilentShield podpira React Native?

React Native SDK za mobilne aplikacije je trenutno v zgodnjem dostopu — zahtevajte ga na [email protected]. Preverjanje na zaledju že danes deluje s paketom `@forge12interactive/silentshield-sdk-js` ali s preprostim klicem HTTP na `https://api.silentshield.io/v1/verify` in blokira avtomatizirane zlorabe, ne da bi uporabnikom prikazovalo uganke.

Ali je SilentShield skladen z GDPR v aplikaciji React?

Da. Ne glede na ogrodje SilentShield privzeto gosti podatke v EU, ne nastavlja piškotkov, ne izvaja sledenja in shranjuje le psevdonimizirane podatke. Vaš vmesnik React naloži eno odjemalsko skripto, vaše zaledje pa preveri žeton — nobeni osebno določljivi podatki niso shranjeni.

Ali SilentShield doda veliko obremenitve aplikaciji React?

Ne. SilentShield naloži eno lahko odjemalsko skripto in nima slikovnih datotek za prenos. Preverjanje poteka prek vedenjskih signalov in žetona proof-of-work, preverjenega na vašem zaledju, brez klicev sledenja tretjih oseb — zato doda minimalno obremenitev vaši aplikaciji React ali Next.js.