Hızlı Başlangıç

Bir dakikadan kısa sürede çalışır duruma gelin.

<script src="https://forge.benegedeniz.com/widget/forge.js" async defer></script>

<form action="/submit" method="POST">
    <div class="forge-captcha" data-sitekey="YOUR_SITEKEY"></div>
    <button type="submit">Submit</button>
</form>

İstemci Tarafı

Otomatik Oluşturma

Widget, forge-captcha sınıfına sahip tüm elementlerde otomatik olarak oluşturulur.

<div class="forge-captcha" data-sitekey="YOUR_SITEKEY"></div>

JavaScript API

Programatik kontrol için ForgeCaptcha global nesnesini kullanın.

// Programmatic rendering
const widgetId = ForgeCaptcha.render('#my-container', {
    sitekey: 'YOUR_SITEKEY',
    callback: function(token) {
        console.log('Verified:', token);
    },
    'error-callback': function() {
        console.log('Challenge failed');
    }
});

// Get the response token
const token = ForgeCaptcha.getResponse(widgetId);

// Reset the widget
ForgeCaptcha.reset(widgetId);

Data Özellikleri

Drop-In Entegrasyon

BenEgeDeniz Forge, diğer popüler captcha servisleri için %100 uyumlu bir Drop-In alternatifi olarak çalışır. Aşağıdaki servislerden herhangi birini kullanan bir sisteminiz varsa, HTML elementinizi veya sunucu doğrulama değişkenlerinizi değiştirmeden geçiş yapabilirsiniz.

Sunucu Tarafı

Widget bir token oluşturduktan sonra, isteği işlemeden önce sunucunuzda doğrulayın.

PHP

$response = file_get_contents('https://forge.benegedeniz.com/api/siteverify', false,
    stream_context_create(['http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/json',
        'content' => json_encode([
            'secret' => 'YOUR_SECRET_KEY',
            'response' => $_POST['forge-captcha-response'],
            'remoteip' => $_SERVER['REMOTE_ADDR'],
        ]),
    ]])
);

$result = json_decode($response, true);
if ($result['success']) {
    // User verified - process the form
}

Node.js

const res = await fetch('https://forge.benegedeniz.com/api/siteverify', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        secret: process.env.FORGE_SECRET_KEY,
        response: req.body['forge-captcha-response'],
    }),
});

const data = await res.json();
if (data.success) {
    // User verified
}

cURL

curl -X POST https://forge.benegedeniz.com/api/siteverify \
  -H "Content-Type: application/json" \
  -d '{"secret":"YOUR_SECRET","response":"TOKEN_FROM_WIDGET"}'

API Referansı

{ "sitekey": "your-site-uuid" }

{
    "success": true,
    "challenge_id": "uuid",
    "salt": "hex-string",
    "difficulty": 20,
    "algorithm": "SHA-256",
    "expires_at": "2025-01-01T00:00:00Z"
}

{
    "secret": "your-secret-key",
    "response": "token-from-widget",
    "remoteip": "optional-client-ip"
}

{
    "success": true,
    "challenge_ts": "2025-01-01T00:00:00+00:00",
    "hostname": "example.com",
    "difficulty": 20,
    "is_interactive": true
}

Yapılandırma

Panelden sitenizin zorluk seviyesini yapılandırın.

Sayfa Kuralları

Sayfa Kuralları, sitenizdeki farklı sayfa veya URL desenleri için özel doğrulama davranışları (Zorluk Seviyesi, Görünmez Mod, Otomatik Doğrulama) tanımlamanızı sağlar.

Eşleşme Tipleri

Kuralların Değerlendirilmesi

Kurallar, panelinizde belirlediğiniz öncelik sırasına göre (yukarıdan aşağıya) değerlendirilir. Ziyaret edilen URL ile eşleşen ilk kural uygulanır. Eğer hiçbir kural eşleşmezse, sitenizin genel ayarları geçerli olur.

Gelişmiş Güvenlik ve Tehdit İstihbaratı

BenEgeDeniz Forge, formlarınızı gelişmiş botlara ve başsız (headless) tarayıcılara karşı korumak için dinamik tehdit istihbaratı kullanır.

Güven Skorları ve Telemetri

Widget, fare hareketlerini, dokunmatik basınç varyansını ve tuş vuruşlarını güvenli bir şekilde değerlendirerek bir "etkileşim entropisi" hesaplar. Ayrıca pasif ortam sinyallerini (WebGL oluşturucu profilleri, cihaz belleği, webdriver bayrakları) toplar. Otomatik komut dosyaları ve başsız tarayıcılar bu kontrollerde başarısız olur ve Forge onların güven puanını sessizce düşürerek kriptografik zorluğu katlanarak artırır.

Bot Koruma Seviyeleri

Güvenlik motorunun katı kurallarını Bot Koruma Seviyeleri (Düşük, Orta, Yüksek) aracılığıyla yapılandırabilirsiniz. Daha yüksek seviyeler, daha sıkı güven skoru sınırları uygular ve şüpheli IP veya tarayıcı anormallikleri içeren istekleri anında reddeder.

Moda Duyarlı Koruma

Güvenlik motoru, yapılandırmanızın tamamen farkındadır. Bir doğrulama Görünmez (Invisible) veya Otomatik (Auto-Verify) moda ayarlanmışsa, aktif etkileşim cezaları akıllıca devre dışı bırakılır ve gerçek kullanıcılar cezalandırılmaz. Bunun yerine sistem, botları yakalamak için sıkı pasif ortam sinyallerine, Challenge-IP (İstek-Çözüm) eşleştirmesine ve PoW zamanlama sınırlarına (timing floors) güvenir.

Tehdit Günlükleme (Log)

Engellenen tüm saldırılar, kaba kuvvet (brute-force) denemeleri, alan adı sahtekarlıkları (domain spoofing), IP uyuşmazlıkları ve PoW zamanlama anomalileri gerçek zamanlı olarak kaydedilir. Bu metrikleri izleyebilir ve her bir saldırının ham verilerini site kontrol panelinizin Güvenlik sekmesinden inceleyebilirsiniz.