Intégrations

Intégration Laravel

1. Déclarer le dépôt

Ajoutez le dépôt CaptchaCore dans votre composer.json :

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://captchacore.eu/packages"
        }
    ]
}

2. Installer le paquet

composer require captchacore/laravel

3. Configurer le .env

CAPTCHACORE_URL=https://captchacore.eu
CAPTCHACORE_SITE_KEY=cc_pub_dein_key
CAPTCHACORE_SECRET_KEY=cc_sec_dein_secret
CAPTCHACORE_WIDGET_MODE=interactive  # interactive | visible | invisible
CAPTCHACORE_WIDGET_THEME=auto        # auto | light | dark
CAPTCHACORE_WIDGET_COLOR=#4ade80
CAPTCHACORE_WIDGET_LABEL=Ich bin kein Bot
CAPTCHACORE_WIDGET_BRAND=CaptchaCore

Composant Blade

<form method="post" data-captchacore="interactive">
    @csrf
    <!-- Formularfelder -->
    <x-captchacore::widget />
    <button type="submit">Absenden</button>
</form>

Middleware

// Route schützen
Route::post('/register', RegisterController::class)
    ->middleware('captchacore:register');

// Oder als Validation Rule
'captchacore_token' => ['required', new CaptchaCoreToken('contact')]

// Tests: fake() mockt alle Verifikationen
CaptchaCore::fake();

Symfony Bundle

Pour Symfony 6.4 LTS et 7.x. Quatre voies d'intégration : FormType, contrainte de validation, attributs de contrôleur et badge Security.

1. Installer

composer require captchacore/captchacore-bundle

Symfony Flex enregistre le bundle et crée automatiquement config/packages/captchacore.yaml.

2. Configurer le .env

CAPTCHACORE_URL=https://api.captchacore.eu
CAPTCHACORE_SITE_KEY=cc_pub_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
CAPTCHACORE_SECRET_KEY=cc_sec_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

FormType (recommandé)

use CaptchaCore\SymfonyBundle\Form\Type\CaptchaCoreType;

$builder
    ->add('email', EmailType::class)
    ->add('message', TextareaType::class)
    ->add('captcha', CaptchaCoreType::class, [
        'form_type' => 'contact',
    ]);

Attributs de contrôleur

use CaptchaCore\SymfonyBundle\Security\Attribute\RequiresCaptcha;

#[Route('/contact', methods: ['POST'])]
#[RequiresCaptcha(formType: 'contact')]
public function submit(Request $request): Response { /* ... */ }

Contrainte Validator (DTOs)

use CaptchaCore\SymfonyBundle\Validator\CaptchaCoreToken;

final class ContactDto {
    public function __construct(
        #[Assert\NotBlank]
        public string $email,

        #[CaptchaCoreToken(formType: 'contact')]
        public string $captchaToken,
    ) {}
}

Programmatique

use CaptchaCore\SymfonyBundle\Client\CaptchaCoreClient;

$result = $this->captcha->verify($token, 'login');

if ($result->blocked()) {
    throw new AccessDeniedHttpException();
}

// Properties: valid, riskScore, action, confidence, reasons, stepUp

Twig (standalone)

{{ captchacore_widget(mode: 'interactive') }}

Tests

CaptchaCoreClient::fake(VerificationResult::allow());
$this->client->request('POST', '/contact', [...]);
self::assertResponseIsSuccessful();

Plugin WordPress

1. Installez l’extension — dans WordPress, ouvrez Extensions → Ajouter et cherchez « CaptchaCore » (fiche dans le répertoire WordPress). Les mises à jour viennent ensuite de WordPress. Sinon, téléversez le ZIP depuis votre espace client.
2. Activer dans Extensions
3. Ouvrir Réglages > CaptchaCore
4. Renseigner l'URL du service, la clé de site et la clé secrète
5. Choisir le mode du widget, le thème et la couleur
6. Activer les formulaires souhaités (connexion, inscription, commentaires, etc.)

WoltLab Suite

Le paquet est distribué via la boutique officielle de plugins WoltLab. L’installation et toutes les mises à jour passent par elle — il n’y a pas de téléchargement séparé dans l’espace client.

1. Achetez le paquet dans la boutique de plugins et installez-le dans l’ACP sous Paquets → Installer un paquet
2. Saisissez vos identifiants sous Options → Sécurité → Anti-spam → CaptchaCore : URL du service, site key et secret key
3. Choisissez l’apparence : mode, thème, couleur d’accent et langue — « auto » suit la langue du forum.
4. Sélectionnez CaptchaCore comme captcha sous Options → Sécurité → Anti-spam → Captcha — il s’applique alors à l’inscription, au formulaire de contact et à tous les autres formulaires du système

Créer votre propre intégration

Vous voulez intégrer CaptchaCore dans un système sans paquet existant, comme Shopware, Joomla ou votre propre framework ? Comptez quelques heures. Cet ordre a fait ses preuves.

Modèles dont s'inspirer

Toutes les intégrations fournies suivent le même schéma. Pour un système basé sur Symfony comme Shopware 6, le bundle Symfony est le modèle le plus proche ; pour un CMS classique, l'extension WordPress.

À vérifier avant publication

• Formulaire envoyé sans JavaScript — votre règle de repli s'applique-t-elle ?
• Jeton utilisé deux fois — la seconde vérification doit échouer, le nonce est à usage unique.
• Jeton envoyé après plus de cinq minutes — le widget le renouvelle de lui-même, vérifiez-le lors d'un test de longue durée.
• Deux formulaires protégés sur une page — les deux doivent fonctionner indépendamment.
• Formulaire chargé via AJAX — le widget apparaît-il ?
• La clé secrète n'apparaît nulle part dans le HTML ni en JavaScript.
• Une réponse avec decision=step_up — l'utilisateur ne doit pas se retrouver dans une impasse.