Skript + verifika fuq is-server

Integrazzjonijiet SilentShield

Integrazzjoni sempliċi fil-pjattaformi u l-oqfsa preferuti tiegħek: skript fil-brawżer u verifika fuq is-server tiegħek. Iffukat fuq l-API u indipendenti mill-qafas.

Bidu mgħaġġel

Attiv fi 3 passi

Mir-reġistrazzjoni sal-protezzjoni attiva — mingħajr tibdil fis-server.

Oħloq API key

Irreġistra u ġġenera Site-Key għad-dominju tiegħek fid-Dashboard — b'xejn, f'inqas minn minuta.

Pakkett NPM għal Node.js, React & Next.js

Inkorpora l-iskript tal-klijent ta' SilentShield fil-frontend tiegħek u vverifika n-nonces fil-backend bil-pakkett Node uffiċjali tagħna.

@forge12interactive/silentshield-sdk-js

Pakkett Node.js uffiċjali għall-verifika fil-backend

Installazzjoni

npm install @forge12interactive/silentshield-sdk-js

Użu

// In your backend (e.g. a Next.js route handler)
import { createClient } from '@forge12interactive/silentshield-sdk-js';

const shield = createClient({ apiKey: process.env.SILENTSHIELD_API_KEY });

const { human } = await shield.verify(nonce);
if (!human) return new Response("Verification failed", { status: 403 });

NPM Package Dokumentazzjoni

📝

Plugin ta' WordPress

Integrazzjoni nattiva għall-plugins tal-formoli ta' WordPress l-aktar popolari. Protezzjoni inviżibbli kontra l-ispam mingħajr ostakli CAPTCHA.

SilentShield Captcha

Il-plugin uffiċjali tagħna ta' WordPress issa huwa disponibbli fid-direttorju ta' WordPress. Integrazzjoni bla xkiel ma' Contact Form 7: Inviżibbli, konformi mal-GDPR, aċċessibbli.

Installazzjoni b'klikk waħda direttament minn WordPress
Konfigurazzjoni ċentrali fl-amministrazzjoni ta' WordPress
Aġġornamenti u manutenzjoni awtomatiċi

Ibda l-gwida għal WordPress Niżżel il-Plugin ta' WordPress

Contact Form 7Ittestjat

Protezzjoni inviżibbli kontra l-bots għall-formoli CF7, ittestjata mal-plugin.

WPFormsIttestjat

Protezzjoni kontra l-bots għall-formoli WPForms, ittestjata mal-plugin.

Elementor FormsIttestjat

Protezzjoni kontra l-bots għall-formoli Elementor Forms, ittestjata mal-plugin.

WooCommerceIttestjat

Il-checkout klassiku u l-checkout bil-blokki ttestjati.

Avada FormsIttestjat

Protezzjoni kontra l-bots għall-formoli Avada Forms, ittestjata mal-plugin.

Fluent FormsIttestjat

Protezzjoni kontra l-bots għall-formoli Fluent Forms, ittestjata mal-plugin.

☁️

Kompatibilità ma' Cloudflare

SilentShield jaħdem bla xkiel ma' Cloudflare. Użah quddiem il-Load Balancer tiegħek jew ikkombinah ma' servizzi oħra ta' Cloudflare.

Quddiem Cloudflare Load Balancer?

Iva, possibbli mingħajr problemi.

SilentShield jista' jiġi skjerat direttament quddiem il-Load Balancer ta' Cloudflare tiegħek. L-iskript jaħdem min-naħa tal-klijent u jintegra bla xkiel fl-infrastruttura eżistenti tiegħek.

L-ebda kunflitt mas-servizzi ta' Cloudflare
Kompatibbli ma' CDN u caching
Saff ta' sigurtà addizzjonali

Ospitar ta' Data fl-UE bħala Fattur ta' Differenzjazzjoni

Id-differenza kruċjali

Filwaqt li ħafna jaħdmu ma' Cloudflare Turnstile, SilentShield joffri vantaġġ ċar permezz ta' infrastruttura ospitata fl-UE u arkitettura mingħajr cookies.

Użu konformi mal-GDPR, data fil-Ġermanja
L-ebda cookies jew ħażna persistenti
Ipprezzar trasparenti u ġust

Integrazzjoni ma' Cloudflare

Daħħal l-iskript f'<head>:

<script
  src="https://api.silentshield.io/client.js?k=YOUR_API_KEY"
  crossorigin="anonymous"
  defer
></script>

Gwida Sħiħa

Gwidi ta' Integrazzjoni CMS

Istruzzjonijiet pass pass għal sistemi popolari ta' ġestjoni tal-kontenut.

🛍️

Shopify

Żid SilentShield mal-formola ta' kuntatt tiegħek ta' Shopify

Ara l-Gwida

🌊

Webflow

Integrazzjoni permezz ta' Custom Code Embed

Ara l-Gwida

✨

Wix

Inklużjoni permezz ta' Wix Code (Velo)

Ara l-Gwida

📝

WordPress

Integrazzjoni manwali fit-temi ta' WordPress

Gwida ta' Integrazzjoni SilentShield

SilentShield jipproteġi l-formoli tiegħek b'mod affidabbli mill-bots – inviżibbli, konformi mal-GDPR, u aċċessibbli. Għal sigurtà sħiħa, il-kodiċi tal-frontend (JavaScript) irid jiġi inkorporat u vverifikat min-naħa tas-server.

🛍️Integrazzjoni Shopify

Frontend – Script-Einbindung

Mur fuq Shopify Admin → Ħanut Online → Temi
Ikklikkja fuq "Azzjonijiet → Editja l-kodiċi"
Iftaħ il-fajl theme.liquid taħt Layout
Daħħal il-kodiċi li ġej qabel it-tag </head>

<script
  src="https://api.silentshield.io/client.js?k=YOUR_API_KEY"
  crossorigin="anonymous"
  defer
></script>

Ibdel YOUR_API_KEY biċ-ċavetta API tiegħek mid-dashboard ta' SilentShield.

Backend – Verifika (Eżempju PHP)

Shopify ma jħaddimx kodiċi tas-server tiegħek fit-temi, u l-formoli ta’ kuntatt u tal-klijenti ta’ Shopify jibagħtu direttament lil Shopify – hemmhekk SilentShield ma jivverifika xejn. Għal verifika fuq in-naħa tas-server, il-formola trid tibgħat lis-server tiegħek, lil rotta App Proxy jew lil servizz bħal Make, n8n jew funzjoni cloud li tħaddem il-kodiċi hawn taħt qabel ma tgħaddi d-data. L-iskript fit-tema waħdu ma jissostitwixxix din il-verifika.

<?php
$api_key = "YOUR_API_KEY";
$nonce = $_POST['behavior_nonce'] ?? '';

$payload = json_encode(['nonce' => $nonce]);

$ch = curl_init("https://api.silentshield.io/api/v1/captcha/verify-nonce");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Api-Key: " . $api_key,
  ],
  CURLOPT_POSTFIELDS => $payload,
  CURLOPT_TIMEOUT => 5,
]);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http_code !== 200) {
  http_response_code(400);
  exit(json_encode(['error' => 'Verification failed']));
}

$data = json_decode($response, true);
if (!($data['ok'] && $data['verdict'] === 'human' && $data['confidence'] >= 0.7)) {
  http_response_code(403);
  exit(json_encode(['error' => 'Bot detected']));
}

// ✅ Human verified – handle form submission normally
?>

🌊Integrazzjoni Webflow

Frontend

Iftaħ il-proġett tiegħek → Project Settings → Custom Code → Head Code
Daħħal dan il-kodiċi
Ippubblika l-paġna

<script
  src="https://api.silentshield.io/client.js?k=YOUR_API_KEY"
  crossorigin="anonymous"
  defer
></script>

Backend

Peress li Webflow ma jappoġġjax loġika diretta tas-server, ibgħat il-formola tiegħek lil server jew servizz tiegħek (eż. Make, n8n, AWS Lambda, Firebase Function). Hemmhekk, eżegwixxi l-istess kodiċi ta' verifika bħal fl-eżempju ta' Shopify hawn fuq, qabel ma tipproċessa l-formola aktar 'il quddiem.

✨Integrazzjoni Wix

Frontend

Iftaħ l-Editur Wix
Attiva l-Modalità Dev (Velo)
Agħżel Żid Kodiċi Personalizzat → Head
Daħħal l-istess kodiċi <script>
Ippubblika l-websajt

<script
  src="https://api.silentshield.io/client.js?k=YOUR_API_KEY"
  crossorigin="anonymous"
  defer
></script>

Backend (Funzjoni HTTP ta' Velo)

import { ok, badRequest, forbidden } from 'wix-http-functions';
import { fetch } from 'wix-fetch';

export function post_verify_silentshield(request) {
  return request.body.json()
    .then(body => {
      return fetch("https://api.silentshield.io/api/v1/captcha/verify-nonce", {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "X-Api-Key": "YOUR_API_KEY"
        },
        body: JSON.stringify({ nonce: body.behavior_nonce })
      });
    })
    .then(resp => resp.json())
    .then(data => {
      if (data.ok && data.verdict === "human" && data.confidence >= 0.7)
        return ok({ body: { success: true } });
      return forbidden({ body: { error: "Bot detected" } });
    })
    .catch(() => badRequest({ body: { error: "Verification failed" } }));
}

📝Integrazzjoni WordPress

Frontend (Manwali jew Plugin)

add_action('wp_head', function () {
  echo '<script src="https://api.silentshield.io/client.js?k=YOUR_API_KEY" crossorigin="anonymous" defer></script>';
});

Backend (Verifika PHP)

$api_key = "YOUR_API_KEY";
$nonce = $_POST['behavior_nonce'] ?? '';
$payload = json_encode(['nonce' => $nonce]);

$ch = curl_init("https://api.silentshield.io/api/v1/captcha/verify-nonce");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json", "X-Api-Key: $api_key"],
  CURLOPT_POSTFIELDS => $payload,
  CURLOPT_TIMEOUT => 5,
]);
$response = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($code !== 200) wp_die('Verification failed.');
$data = json_decode($response, true);
if (!($data['ok'] && $data['verdict'] === 'human' && $data['confidence'] >= 0.7))
  wp_die('Bot detected.');

Rakkomandazzjoni: Uża l-plugin uffiċjali tagħna ta' WordPress

Għal integrazzjoni aktar faċli, uża l-plugin tagħna direttament mid-direttorju ta' WordPress.

Niżżel il-Plugin ta' WordPress

Sommarju

Pjattaforma	Integrazzjoni Frontend	Verifika Backend
Shopify	theme.liquid <script>	App-Proxy / PHP / Node
Webflow	Project Settings → Head	Kontroll tas-Server Estern
Wix (Velo)	Custom Code → Head	Funzjoni HTTP
WordPress	wp_head() jew Plugin	Maniġer tal-Formoli PHP

Lest għall-integrazzjoni?

Ibda b'xejn bis-soluzzjoni tagħna ffukata fuq l-API.

Ibda b'xejn Dokumentazzjoni