SilentShield to niewidoczna, zgodna z RODO alternatywa dla CAPTCHA dla aplikacji React i Next.js. Ładujesz lekki skrypt kliencki, uzyskujesz token i weryfikujesz go na serwerze za pomocą pakietu @forge12interactive/silentshield-sdk-js oraz jednego klucza API. Nie ma żadnych plików cookie, śledzenia ani danych osobowych, a hosting domyślnie odbywa się wyłącznie w UE.

Niewidoczna CAPTCHA dla React & Next.js

Działa z dowolną aplikacją React lub Next.js dzięki lekkiemu skryptowi SilentShield: pobierz nonce przy wysyłce i zweryfikuj go w backendzie za pomocą @forge12interactive/silentshield-sdk-js. Niewidoczna i zgodna z RODO.

Integracja CAPTCHA w React

Developer Experience

Niezależna od frameworka — działa z dowolną aplikacją React lub Next.js
Lekki skrypt klienta — nie wymaga ciężkiego pakietu React
Oparta na nonce — niewidoczna, bez interakcji użytkownika
@forge12interactive/silentshield-sdk-js do weryfikacji w backendzie
Działa z App Router i Pages Router
Przyjazna dla TypeScript

Przykłady kodu

Osadzenie skryptu klienta

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

Weryfikacja w backendzie (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 });
}

Jak SilentShield działa w React

SilentShield ładuje mały skrypt kliencki, który wykonuje niewidoczną kontrolę, gdy użytkownik wchodzi w interakcję z Twoim formularzem. Podczas wysyłania Twój komponent React lub Next.js wysyła wygenerowany token do Twojego backendu, gdzie weryfikujesz go za pomocą pakietu @forge12interactive/silentshield-sdk-js. Użytkownicy nigdy nie widzą łamigłówki, a Twój bundle pozostaje lekki, ponieważ nie ma ciężkiego widżetu do wyrenderowania.

Skrypt kliencki plus weryfikacja po stronie serwera

Nie ma osobnego pakietu webowego @silentshield/react do zainstalowania — SilentShield działa w każdej aplikacji React lub Next.js dzięki skryptowi klienckiemu i weryfikacji po stronie serwera. Dodajesz skrypt https://api.silentshield.io/client.js?k=YOUR_API_KEY, odczytujesz token w swoim komponencie i potwierdzasz go względem https://api.silentshield.io/v1/verify, używając nagłówka api-key z route handlera lub trasy API.

Przewodnik konfiguracji

Utwórz konto i skopiuj swój klucz API. Dodaj skrypt kliencki SilentShield do swojej aplikacji i przechwyć token po wysłaniu formularza. Zainstaluj @forge12interactive/silentshield-sdk-js na swoim serwerze, utwórz klienta ze swoim kluczem API i wywołaj verify z tokenem. Jeśli wynik to człowiek, przetwórz żądanie; w przeciwnym razie je odrzuć.

Prywatność i dostępność domyślnie

SilentShield nie przechowuje plików cookie, nie prowadzi śledzenia i nie zbiera danych osobowych, dzięki czemu Twoja aplikacja pozostaje zgodna z RODO. Weryfikacja domyślnie działa na infrastrukturze wyłącznie w UE. Niewidoczna kontrola spełnia WCAG 2.1 AA, co utrzymuje Twoje formularze użytecznymi dla użytkowników klawiatury i czytników ekranu bez żadnego wyzwania wizualnego.

Zintegruj z React już teraz

Dodaj skrypt, zweryfikuj za pomocą @forge12interactive/silentshield-sdk-js — gotowe w kilka minut.

Najczęściej zadawane pytania

Jak dodać CAPTCHA do aplikacji React?

Załaduj skrypt kliencki SilentShield `https://api.silentshield.io/client.js?k=YOUR_API_KEY` w swojej aplikacji React lub Next.js, pobierz nonce przy wysyłaniu i zweryfikuj go na backendzie pod adresem `https://api.silentshield.io/v1/verify` za pomocą pakietu SDK `@forge12interactive/silentshield-sdk-js`. Nie ma osobnego pakietu React dla webu — wzorcem jest skrypt kliencki plus weryfikacja na backendzie.

Czy istnieje pakiet React dla SilentShield?

Nie ma osobnego pakietu webowego dla Reacta. W React i Next.js dodajesz skrypt kliencki `https://api.silentshield.io/client.js?k=YOUR_API_KEY` i weryfikujesz wstrzyknięty `behavior_nonce` na swoim backendzie — kilkoma linijkami fetch lub oficjalnym pakietem `@forge12interactive/silentshield-sdk-js`. SDK React Native dla aplikacji mobilnych jest obecnie dostępne na życzenie (wczesny dostęp).

Jak SilentShield działa z Next.js?

W Next.js dołączasz skrypt kliencki SilentShield do swoich stron, a następnie weryfikujesz nonce po stronie serwera — w route handlerze lub trasie API — za pomocą pakietu SDK `@forge12interactive/silentshield-sdk-js`, wywołując `https://api.silentshield.io/v1/verify` z nagłówkiem `api-key`. Chroni to formularze niewidocznie za pomocą jednego klucza API.

Czy SilentShield obsługuje React Native?

SDK React Native dla aplikacji mobilnych jest obecnie we wczesnym dostępie — napisz na [email protected]. Weryfikacja backendowa działa już dziś z `@forge12interactive/silentshield-sdk-js` lub prostym wywołaniem HTTP na `https://api.silentshield.io/v1/verify`, blokując zautomatyzowane nadużycia bez pokazywania użytkownikom łamigłówek.

Czy SilentShield jest zgodny z RODO w aplikacji React?

Tak. Niezależnie od frameworku, SilentShield domyślnie hostuje dane w UE, nie ustawia plików cookie, nie prowadzi śledzenia i przechowuje wyłącznie dane pseudonimizowane. Twój frontend React ładuje pojedynczy skrypt kliencki, a Twój backend weryfikuje nonce — nie są przechowywane żadne dane umożliwiające identyfikację.

Czy SilentShield dodaje duży narzut do aplikacji React?

Nie. SilentShield ładuje jeden lekki skrypt kliencki i nie ma zasobów graficznych do pobrania. Weryfikacja odbywa się za pomocą sygnałów behawioralnych i nonce proof-of-work, sprawdzanych na Twoim backendzie, bez wywołań śledzących do stron trzecich — więc dodaje minimalny narzut do Twojej aplikacji React lub Next.js.