SilentShield hija alternattiva għal CAPTCHA inviżibbli u konformi mal-GDPR għall-applikazzjonijiet React u Next.js. Int ittella' skript klijent ħafif, tikseb token u tivverifikah fuq is-server bil-pakkett @forge12interactive/silentshield-sdk-js u ċavetta API waħda. M'hemmx cookies, m'hemmx traċċar u m'hemmx dejta personali, u l-hosting huwa awtomatikament biss fl-UE.

CAPTCHA inviżibbli għal React & Next.js

Jaħdem ma' kwalunkwe applikazzjoni React jew Next.js permezz tal-iskript ħafif ta' SilentShield: iġbor nonce mal-issottomettar u vverifikah fil-backend b'@forge12interactive/silentshield-sdk-js. Inviżibbli u konformi mal-GDPR.

Integrazzjoni CAPTCHA f'React

Developer Experience

Indipendenti mill-framework — jaħdem ma' kwalunkwe applikazzjoni React jew Next.js
Skript tal-klijent ħafif — l-ebda pakkett React tqil mhux meħtieġ
Ibbażat fuq nonce — inviżibbli, mingħajr interazzjoni tal-utent
@forge12interactive/silentshield-sdk-js għall-verifika fil-backend
Jaħdem ma' App Router u Pages Router
Kompatibbli ma' TypeScript

Eżempji ta' kodiċi

Inkorpora l-iskript tal-klijent

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

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

Verifika fil-backend (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 });
}

Kif jaħdem SilentShield f'React

SilentShield itella' skript klijent żgħir li jwettaq verifika inviżibbli waqt li utent jinteraġixxi mal-formola tiegħek. Meta tissottometti, il-komponent React jew Next.js tiegħek jibgħat it-token iġġenerat lill-backend tiegħek, fejn tivverifikah bil-pakkett @forge12interactive/silentshield-sdk-js. L-utenti qatt ma jaraw puzzle, u l-bundle tiegħek jibqa' ħafif għax m'hemm ebda widget tqil x'jiġi renderjat.

Skript klijent flimkien ma' verifika fuq is-server

M'hemm ebda pakkett web @silentshield/react separat x'jiġi installat — SilentShield jaħdem fi kwalunkwe applikazzjoni React jew Next.js permezz tal-iskript klijent u verifika min-naħa tas-server. Iżżid l-iskript https://api.silentshield.io/client.js?k=YOUR_API_KEY, taqra t-token fil-komponent tiegħek, u tikkonfermah kontra https://api.silentshield.io/v1/verify billi tuża l-header api-key minn route handler jew rotta API.

Gwida tal-konfigurazzjoni

Oħloq kont u kkopja ċ-ċavetta API tiegħek. Żid l-iskript klijent SilentShield mal-applikazzjoni tiegħek u aqbad it-token meta l-formola tiġi sottomessa. Installa @forge12interactive/silentshield-sdk-js fuq is-server tiegħek, oħloq il-klijent biċ-ċavetta API tiegħek, u sejjaħ verify bit-token. Jekk ir-riżultat ikun bniedem, ipproċessa t-talba; inkella irrifjutaha.

Privatezza u aċċessibbiltà awtomatikament

SilentShield ma jaħżen ebda cookies, ma jwettaq ebda traċċar u ma jiġbor ebda dejta personali, għalhekk l-applikazzjoni tiegħek tibqa' konformi mal-GDPR. Il-verifika taħdem awtomatikament fuq infrastruttura biss fl-UE. Il-verifika inviżibbli tissodisfa l-WCAG 2.1 AA, li żżomm il-formoli tiegħek użabbli għall-utenti tat-tastiera u tal-qarrejja tal-iskrin mingħajr ebda sfida viżiva.

Integra ma' React issa

Żid l-iskript, ivverifika b'@forge12interactive/silentshield-sdk-js — lest fi ftit minuti.

Mistoqsijiet frekwenti

Kif inżid CAPTCHA ma' app ta' React?

Għabbi l-iskript tal-klijent ta' SilentShield `https://api.silentshield.io/client.js?k=YOUR_API_KEY` fl-app ta' React jew Next.js tiegħek, ikseb nonce mas-sottomissjoni, u vverifikah fuq il-backend tiegħek fuq `https://api.silentshield.io/v1/verify` bl-użu tal-SDK `@forge12interactive/silentshield-sdk-js`. Ma hemm l-ebda pakkett web separat għal React — l-iskript tal-klijent flimkien mal-verifika fil-backend huwa l-mudell.

Hemm pakkett ta' SilentShield għal React?

M'hemmx pakkett web separat għal React. F'React u Next.js iżżid l-iskript tal-klijent `https://api.silentshield.io/client.js?k=YOUR_API_KEY` u tivverifika l-`behavior_nonce` injettat fuq il-backend tiegħek — bi ftit linji ta' fetch jew bil-pakkett uffiċjali `@forge12interactive/silentshield-sdk-js`. SDK ta' React Native għall-apps mobbli bħalissa huwa disponibbli fuq talba (early access).

Kif jaħdem SilentShield ma' Next.js?

F'Next.js, inkludi l-iskript tal-klijent ta' SilentShield fil-paġni tiegħek, imbagħad vverifika n-nonce min-naħa tas-server — f'route handler jew API route — bl-SDK `@forge12interactive/silentshield-sdk-js`, li jsejjaħ `https://api.silentshield.io/v1/verify` bl-header `api-key`. Dan jipproteġi l-formoli b'mod inviżibbli b'API key wieħed.

SilentShield jappoġġja React Native?

SDK ta' React Native għall-apps mobbli bħalissa jinsab f'early access — itolbu fuq [email protected]. Il-verifika tal-backend taħdem diġà llum bil-pakkett `@forge12interactive/silentshield-sdk-js` jew b'sejħa HTTP sempliċi lejn `https://api.silentshield.io/v1/verify`, u timblokka l-abbuż awtomatizzat mingħajr ma turi puzzles lill-utenti.

SilentShield huwa konformi mal-GDPR f'app ta' React?

Iva. Irrispettivament mill-framework, SilentShield jospita d-data fl-UE b'mod awtomatiku, ma jżid l-ebda cookie, ma jwettaq l-ebda tracking, u jaħżen biss data psewdonimizzata. Il-frontend ta' React tiegħek jgħabbi skript tal-klijent wieħed u l-backend tiegħek jivverifika n-nonce — l-ebda informazzjoni li tidentifika l-persuna ma tinħażen.

SilentShield iżid ħafna piż fuq app ta' React?

Le. SilentShield jgħabbi skript tal-klijent wieħed u ħafif u ma għandu l-ebda assi ta' stampi biex jitniżżlu. Il-verifika sseħħ permezz ta' sinjali ta' mġiba u nonce proof-of-work, ivverifikat fuq il-backend tiegħek, mingħajr sejħiet ta' tracking ta' partijiet terzi — u għalhekk iżid piż minimu fuq l-app ta' React jew Next.js tiegħek.