Utiliser reCAPTCHA avec ASP.NET

Important: La version 1.0 de l'API reCAPTCHA n'est plus compatible. Veuillez passer à la version 2.0. En savoir plus

La bibliothèque reCAPTCHA ASP.NET offre un moyen simple de placer un CAPTCHA sur votre site Web ASP.NET, ce qui vous aide à empêcher les bots d'en abuser. La bibliothèque encapsule l'API reCAPTCHA. Vous pouvez l'utiliser dans n'importe quel langage .NET, y compris C# et Visual Basic .NET.

Pour utiliser reCAPTCHA avec ASP.NET, vous pouvez télécharger la bibliothèque ASP.NET reCAPTCHA.

Quick Start

Une fois que vous vous êtes inscrit pour obtenir vos clés API, vous trouverez ci-dessous des instructions de base pour installer reCAPTCHA sur votre site avec ASP.NET:

  1. Ajoutez une référence sur votre site Web à library/bin/Release/Recaptcha.dll: dans le menu du site Web de Visual Studio, sélectionnez "Ajouter une référence", puis cliquez sur l'onglet ".NET" de la boîte de dialogue. Sélectionnez le composant Recaptcha.dll dans la liste des composants .NET, puis cliquez sur OK. Si vous ne voyez pas le composant, cliquez sur l'onglet "Parcourir" et recherchez le fichier d'assembly sur votre disque dur.
  2. Insérez la commande reCAPTCHA dans le formulaire que vous souhaitez protéger en ajoutant les extraits de code suivants:

    En haut de la page aspx, insérez ceci:

      <%@ Register TagPrefix="recaptcha" Namespace="Recaptcha" Assembly="Recaptcha" %>
    

    Insérez ensuite le contrôle reCAPTCHA dans la balise <form runat="server"> :

      <recaptcha:RecaptchaControl
        ID="recaptcha"
        runat="server"
        PublicKey="your_public_key"
        PrivateKey="your_private_key"
        />
    

    Vous devez remplacer votre clé publique et votre clé privée par "PublicKey" (Clé publique) et "PrivateKey" (Clé privée), respectivement.

  3. Veillez à utiliser la validation ASP.NET pour valider votre formulaire (nous vous conseillons de vérifier "Page.IsValid" lors de l'envoi).

Voici un "Hello World" avec reCAPTCHA à l'aide de Visual Basic. Un exemple C# est inclus dans le téléchargement de la bibliothèque.

  <%@ Page Language="VB" %>
  <%@ Register TagPrefix="recaptcha" Namespace="Recaptcha" Assembly="Recaptcha" %>
  <script runat=server%gt;
      Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
          If Page.IsValid Then
              lblResult.Text = "You Got It!"
              lblResult.ForeColor = Drawing.Color.Green
          Else
              lblResult.Text = "Incorrect"
              lblResult.ForeColor = Drawing.Color.Red
          End If
      End Sub
  </script>
  <html>
  <body>
      <form runat="server">
          <asp:Label Visible=false ID="lblResult" runat="server" />
          <recaptcha:RecaptchaControl
              ID="recaptcha"
              runat="server"
              Theme="red"
              PublicKey="your_public_key"
              PrivateKey="your_private_key"
              />

          <asp:Button ID="btnSubmit" runat="server" Text="Submit" OnClick="btnSubmit_Click" />
      </form>
  </body>
  </html>

Documentation complémentaire

  • Personnalisation de l'apparence
  • Conseils et consignes
  • Dépannage