TrustComponent
.NET
TrustCaptcha · Protection anti-bots

Intégration CAPTCHA .NET

Ajoutez un CAPTCHA .NET à vos formulaires et API ASP.NET en quelques minutes : utilisez le widget côté frontend et vérifiez le jeton avec notre package .NET. Protégez les inscriptions, connexions, formulaires de contact et parcours de paiement contre les bots, sans puzzle. Hébergé dans l'UE et conforme au RGPD.

Démarrage rapide

Comment fonctionne l'intégration

1. Créer un CAPTCHA

Créez un compte utilisateur ou connectez-vous avec un compte existant. Ensuite, créez un nouveau CAPTCHA ou choisissez-en un existant. Si vous voulez d’abord essayer TrustCaptcha, chaque offre commence par un essai gratuit de 14 jours.

La page d’aperçu du CAPTCHA affiche votre site key et votre license key, et c’est là que vous créez votre API key. Ajoutez les domaines de votre site aux domaines autorisés dans les règles de sécurité du CAPTCHA pour qu’ils puissent utiliser votre CAPTCHA.

Début du formulaire de création de CAPTCHA.
Règles de sécurité d’un CAPTCHA de démonstration.

2. Intégrer le widget CAPTCHA dans votre frontend

Intégrez le widget CAPTCHA dans votre site web ou votre application. Le guide du widget CAPTCHA de notre documentation contient les instructions pas à pas.

Lire la documentation

Le widget CAPTCHA s’affichera ensuite sur votre site ou application :

Début du CAPTCHA

Intégrations frontend préconstruites
Nos intégrations frontend préconstruites ajoutent le widget CAPTCHA à votre site web ou à votre application. S’il n’en existe pas encore pour votre technologie frontend, vos développeurs peuvent intégrer le widget eux-mêmes à l’aide de notre documentation ou demander à notre équipe support une intégration préconstruite.

Angular
Contact Form 7
Craft CMS
JavaScript
Joomla
JTL-Shop
Keycloak
Magento 2
React
Shopware 6
Svelte
TYPO3
Vue
Webflow
WordPress

3. Valider le résultat CAPTCHA dans votre backend

Les étapes suivantes montrent comment un backend .NET récupère le résultat de vérification sur notre serveur et décide de la suite. Les instructions complètes se trouvent dans le guide d’intégration CAPTCHA pour .NET de notre documentation.

Lire la documentation

Installez d’abord notre package TrustCaptcha pour .NET :

Installation
bash
dotnet add package TrustComponent.TrustCaptcha

Récupérez le résultat de vérification sur notre serveur avec le jeton de vérification et votre API key :

Récupérer le résultat
C#
// Récupération du résultat de vérification
VerificationResult verificationResult;
try
{
  verificationResult = await TrustCaptcha.GetVerificationResultAsync("<your_api_key>", "<verification_token_from_your_client>");
}
catch (Exception ex)
{
  // La récupération du résultat de vérification a échoué - gérer l’erreur
}

En fonction du résultat et de vos besoins, décidez de la suite :

Traiter le résultat
C#
// Agir en fonction du résultat de vérification
if (!verificationResult.VerificationPassed || verificationResult.Score > 0.5)
{
  // La vérification a échoué ou le bot score est > 0.5 – requête automatisée possible
}

Besoin d’informations détaillées sur l’intégration .NET ?
Notre guide d’intégration CAPTCHA pour .NET contient les instructions détaillées, et notre dépôt d’exemples CAPTCHA sur GitHub un exemple d’intégration complet.

Une autre technologie backend que .NET ?
Si votre serveur n’utilise pas .NET, ou si vous avez plusieurs backends, choisissez une autre intégration ici. S’il n’existe pas encore d’intégration préconstruite pour votre technologie backend, vos développeurs peuvent intégrer la vérification eux-mêmes à l’aide de notre documentation ou demander à notre équipe support une intégration préconstruite.

.NET
Go
Groovy
Java
Kotlin
Node.js
PHP
Python
Ruby
Rust
Scala

4. Testez votre intégration

TrustCaptcha est maintenant actif. Envoyez une requête de test et vérifiez qu’elle passe.

CAPTCHA terminé

Questions fréquentes

Comment fonctionne la vérification CAPTCHA en C# avec .NET ?
Un CAPTCHA C# est une vérification que votre backend .NET effectue avant de traiter une requête de formulaire ou d'API. Le widget TrustCaptcha s'exécute dans le navigateur du visiteur, résout une tâche de proof-of-work en arrière-plan et ajoute un jeton de vérification au formulaire. Votre backend .NET transmet ce jeton et votre clé API à TrustCaptcha.GetVerificationResultAsync et récupère le résultat : vérification réussie ou non, avec un score de bot de 0 (très probablement humain) à 1 (très probablement un bot). Vous tenez ainsi le spam, le credential stuffing et les fausses inscriptions à l'écart de vos formulaires et API ASP.NET, sans puzzle.
Dois-je enregistrer TrustCaptcha comme singleton dans l'injection de dépendances ?
Si vous avez besoin de paramètres personnalisés, oui. TrustCaptcha.NewBuilder(apiKey) permet de définir l'hôte de l'API, les délais de connexion et de lecture (3 et 5 secondes par défaut) et un proxy, et l'instance construite est immuable et thread-safe. Construisez-la une fois au démarrage, enregistrez-la comme singleton et injectez-la dans vos contrôleurs ou vos handlers de minimal API. Avec les paramètres par défaut, l'appel statique GetVerificationResultAsync suffit.
Est-ce que cela fonctionne avec ASP.NET Core MVC, Razor Pages et Blazor ?
Oui. Le package ne fait que l'appel côté serveur, il s'intègre donc à tout projet .NET qui reçoit la requête du formulaire ou de l'API : contrôleurs MVC, handlers Razor Pages, minimal APIs et backend d'une application Blazor. Le widget lui-même se place dans votre balisage HTML ou Razor. Notre guide CAPTCHA pour ASP.NET Core montre un exemple complet.
Quelles exceptions mon code .NET doit-il gérer ?
GetVerificationResultAsync lève des exceptions typées comme VerificationTokenInvalidException, VerificationResultExpiredException ou VerificationResultRetrievalLimitReachedException : traitez-les comme une vérification échouée. ServerUnreachableException signifie que votre serveur n'a pas pu joindre notre API du tout, et notre documentation suggère d'accepter la requête et de consigner l'incident. ClientReportedServerUnreachableException signifie que le widget a signalé une panne que votre serveur ne peut pas confirmer : rejetez la requête ou demandez une vérification supplémentaire.
TrustCaptcha est-il conforme au RGPD et hébergé dans l'UE ?
TrustCaptcha est hébergé dans l'UE : toutes les données CAPTCHA sont traitées et stockées exclusivement dans l'UE sur une infrastructure certifiée ISO 27001. Il ne dépose aucun cookie, chiffre les données en transit, et chaque client dispose d'un accord de traitement des données (DPA). La conformité de votre mise en œuvre au RGPD dépend aussi de la façon dont vous l'utilisez. Ceci n'est pas un conseil juridique ; voyez les détails avec votre délégué à la protection des données (DPO).
Puis-je personnaliser l'apparence de TrustCaptcha ?
Oui. Le widget propose 37+ langues prêtes à l'emploi, vous pouvez ajouter n'importe quelle autre langue et remplacer chaque texte du widget. Choisissez un thème clair ou sombre ou suivez le réglage système du visiteur ; à partir de l'offre Team, vous ajustez aussi les couleurs, les bordures et l'arrondi des coins. Un widget sans notre marque et un widget entièrement invisible sont proposés avec l'option payante Captcha Branding.
TrustCaptcha a-t-il un impact sur les performances ou l'accessibilité ?
Les visiteurs ne résolvent jamais de puzzle : le widget démarre tout seul dès que quelqu'un remplit le formulaire et exécute la preuve de travail en arrière-plan. Elle ne devient plus difficile, et plus longue, que si une requête paraît risquée. Le widget est livré avec des libellés ARIA et des textes pour lecteurs d'écran, et il est conçu pour respecter les normes WCAG et la loi européenne sur l'accessibilité (European Accessibility Act). Côté serveur, la validation représente un appel API par formulaire envoyé.
Vous perdez des prospects à cause des CAPTCHAs ?

TrustCaptcha bloque le spam et les bots, pas vos clients. Sans puzzle, conforme au RGPD, hébergé en UE.

Début du CAPTCHA
CAPTCHA terminé
Aucun puzzle pour vos visiteurs
La vérification tourne en arrière-plan pendant la saisie. Davantage de visiteurs vont au bout de vos formulaires au lieu d'abandonner.
Conforme au RGPD
Hébergé dans l'UE, sans cookies, avec transmission chiffrée et suppression automatique des données. Chaque client reçoit un accord de traitement des données (DPA).
Sécurité multicouche
Le proof-of-work adaptatif et le scoring de risque stoppent les abus tôt, même lors d'un pic d'attaques.
Contrôle total
Réglez la sensibilité, gérez des listes d'autorisation et de blocage et utilisez le géoblocage. Vous décidez du niveau d'exigence de la vérification.

Protégez votre application .NET avec TrustCaptcha en quelques étapes !

  • Hébergé en UE & conforme RGPD
  • Aucun puzzle
  • Essai gratuit de 14 jours