‫روش استفاده از ویژگی Turnstile کلودفلر برای پیاده‌سازی کپچا در برنامه‌های ASP.NET Core

1. در داشبورد Cloudflare، روی Turnstile در منوی سمت چپ کلیک کنید.
2. روی دکمه Add widget کلیک کنید.
3. یک نام برای ویجت انتخاب کرده و نام دامنه خود را اضافه کنید.
4. در Widget Mode، گزینه Managed را انتخاب کرده و سایر گزینه‌ها را به صورت پیش‌فرض رها کنید.
5. روی دکمه Save کلیک کرده و کلید سایت (site key) و کلید مخفی (secret key) را برای استفاده در مراحل بعدی کپی کنید.

<script src="https://challenges.cloudflare.com/turnstile/v0/api.js?render=explicit&onload=onloadTurnstileCallback" async defer></script>

<form ...>
  <div id="turnstile-container"></div>
</form>

const captchaSolved = ref(false);

window.onloadTurnstileCallback = function () {
  turnstile.render("#turnstile-container", {
    sitekey: "SITE_KEY",
    callback: function (token) {
        captchaSolved.value = true;
    },
    'expired-callback': function () {
        captchaSolved.value = false;
    }
  });
};

const onSubmit = handleSubmit(() => {
    const token = turnstile.getResponse();
    if (token === "" || token == undefined || token == null) {
        return;
    }

    captchaSolved.value = false;
    axios
        .post('/myendpoint', Qs.stringify({ captcha: token }))
        .then(response => {
            turnstile.reset("#turnstile-container");
            captchaSolved.value = false;
            
            // Success
        })
        .catch(error => {
            turnstile.reset("#turnstile-container");
            captchaSolved.value = false;

            // Failure
        });
});

public class MyController(Captcha captcha) : ControllerBase
{
    [HttpPost]
    [Route("myendpoint")]
    public async Task<ActionResult> MyEndpoint(string token)
    {
        if (!await captcha.IsValid(token)) return BadRequest();
        
        // Business logic goes here
        
        return Ok();
    }
}

public class Captcha(HttpClient captchaClient)
{
    public async Task<bool> IsValid(string token)
    {
        try
        {
            var formData = new Dictionary<string, string>
            {
                { "secret", "SITE_SECRET" },
                { "response", token }
            };

            var content = new FormUrlEncodedContent(formData);
            var postTask = await captchaClient.PostAsync("/turnstile/v0/siteverify", content);

            var result = await postTask.Content.ReadAsStringAsync();
            var resultObject = JsonSerializer.Deserialize<JsonElement>(result);
            return resultObject.GetProperty("success").GetBoolean();
        }
        catch
        {
            return false;
        }
    }
}

builder.Services.AddHttpClient<Captcha>(x =>
{
    x.BaseAddress = new Uri("https://challenges.cloudflare.com");
});