Flarum

Extension officielle CaptchaLa pour Flarum. Ajoute la vérification CAPTCHA aux actions habituellement ciblées par les bots sur un forum — inscription, connexion, réinitialisation de mot de passe et publication — avec des interrupteurs par action dans le panneau d'administration.

Ce qui est couvert

Chaque action ci-dessous est un interrupteur individuel sous Admin → Extensions → CaptchaLa.

• Inscription
• Connexion
• Réinitialisation de mot de passe
• Réponses aux messages
• Nouvelles discussions
• Modifications de profil

Les sessions authentifiées ouvertes via un fournisseur SSO / Auth Sync sont exemptées — voir SSO / Auth Sync ci-dessous.

Installation

1. Exiger l'extension

Depuis la racine de votre installation Flarum :

composer require captchala/flarum

Alternativement, dans Admin → Extension Manager, collez captchala/flarum dans le champ Install. L'extension cible Flarum ≥ 1.8 et PHP ≥ 8.1.

2. Activer dans le panneau d'administration

Ouvrez Admin → Extensions, trouvez CaptchaLa et cliquez sur Enable.

3. Configurer

Dans le panneau de réglages de l'extension :

1. Collez vos App Key et App Secret depuis dash.captcha.la.
2. Activez les actions à protéger.
3. Enregistrez.

Configuration

Les réglages sont stockés dans la table standard des réglages Flarum sous le préfixe captchala.*.

Réglage	Type	Valeur par défaut	Description
App Key	string	—	Clé publique (cl_pub_…) issue du tableau de bord CaptchaLa. Obligatoire.
App Secret	string	—	Secret serveur. Obligatoire. Utilisé uniquement côté serveur pour appeler /v1/validate.
Protéger l'inscription	bool	true	Challenge à l'inscription.
Protéger la connexion	bool	false	Challenge sur la modale de connexion. Désactivé par défaut car la plupart des forums protègent la connexion par limitation de débit.
Protéger la réinitialisation de mot de passe	bool	true	Challenge lors de la demande d'un e-mail de réinitialisation de mot de passe.
Protéger les réponses aux messages	bool	false	Challenge lors de la publication d'une réponse. Désactivé par défaut ; activez-le si le forum subit une pression de spam.
Protéger les nouvelles discussions	bool	false	Challenge lors de l'ouverture d'une discussion.
Mode de vérification	enum	popup	Une valeur parmi popup, bind, embed. Mappé sur l'option product du SDK Web.
Thème	enum	auto	light, dark ou auto.
Ignorer pour les utilisateurs de confiance	bool	true	Les utilisateurs des groupes marqués comme de confiance (par ex. modérateurs) contournent le challenge.

SSO / Auth Sync

L'extension coopère avec les hooks standard de fournisseurs d'authentification de Flarum (UserAuthenticated, fournisseurs Auth Sync tiers, passerelles OAuth).

• Si l'utilisateur arrive via une session SSO authentifiée, aucun challenge n'est affiché — l'extension considère la session comme déjà vérifiée.
• Pour les configurations mixtes où certains utilisateurs se connectent via SSO et d'autres via le formulaire local, seul le chemin du formulaire local exécute le challenge.
• L'interrupteur skip_for_trusted_users s'empile par-dessus : les groupes de confiance contournent le challenge même sur une connexion par formulaire local.

FAQ

L'extension est-elle gratuite ?

Oui. Le package Composer est gratuit. L'offre gratuite CaptchaLa couvre 1 000 vérifications par mois.

Bloque-t-elle les inscriptions de spam ?

Elle bloque ou challenge la plupart des inscriptions automatisées dès le premier score de risque. Aucun CAPTCHA ne bloque 100 % — mais sur nos forums de test, le volume d'inscriptions de spam chute d'environ un ordre de grandeur après activation.

Puis-je l'exiger uniquement à l'inscription ?

Oui. Chaque action est un interrupteur séparé. Le profil par défaut active uniquement l'inscription et la réinitialisation de mot de passe.

Fonctionne-t-elle avec SSO / Auth Sync ?

Oui. Les sessions ouvertes par un fournisseur SSO / Auth Sync ignorent le challenge. Voir SSO / Auth Sync.

Est-elle open source ?

Oui — le code de l'extension PHP est open source. Les appels de vérification sont effectués vers le service hébergé CaptchaLa.

Sources

• Dépôt de l'extension : github.com/Captcha-La/captchala-flarum
• Packagist : captchala/flarum
• À voir aussi : SDK Web · SDK serveur PHP · Référence de l'API