在本文中,我们将学习如何将HCAPTCHA与Iris一起使用,Iris是一个Web框架,可快速简便地开发Web应用程序。 HCAPTCHA是一项通过向人类访客提出挑战来保护网站免受机器人和垃圾邮件的服务。通过使用HCAPTCHA,我们可以确保只有真正的用户才能访问我们的网站并防止自动攻击。
什么是hcaptcha?
HCAPTCHA是一项提供可以嵌入任何网页的小部件的服务。小部件显示出一个需要人类智能来解决的挑战,例如在图像或单词中识别对象。小部件与HCAPTCHA服务器进行通信,并验证用户是否通过了挑战。如果用户通过挑战,小部件会生成一个可以用于验证用户在服务器端验证的令牌。
HCAPTCHA类似于Recaptcha,这是另一项提供类似功能的流行服务。但是,HCAPTCHA声称比Recaptcha具有一些优势,例如:
- 更好的隐私:HCAPTCHA不会在网站上跟踪用户或收集个人数据。
- 更好的性能:HCAPTCHA使用的资源少于Recaptcha。
- 更好的奖励:HCAPTCHA支付使用其服务的网站所有者并支持各种原因和慈善机构。
如何将HCAPTCHA与虹膜一起使用?
要将HCAPTCHA与Iris一起使用,我们需要做两件事:
- 导入
github.com/kataras/iris/v12/middleware/hcaptcha
软件包,该软件包为HCAPTCHA提供了虹膜中间件。 - 使用
hcaptcha.New
函数创建iris.Handler
并将其注册在我们的iris应用中。
首先,我们需要安装Iris Web框架,该框架也包含中间件:
$ go get github.com/kataras/iris/v12@latest
然后,我们需要在我们的main.go文件中导入它:
import (
"github.com/kataras/iris/v12"
"github.com/kataras/iris/v12/middleware/hcaptcha"
)
接下来,我们需要使用hcaptcha.New
函数来创建iris.Handler
。该功能采用两个参数:一个秘密密钥,并且可以选择地是一个或多个功能来配置HCAPTCHA客户端实例。秘密密钥是一个字符串,我们在创建帐户并注册我们的网站后可以从HCAPTCHA网站获得。我们将在第二篇文章中注册一个错误处理程序。错误处理程序(FailureHandler
)是处理验证过程中可能发生的任何错误的函数。
我们可以使用以下代码来创建处理程序:
// Replace with your own secret key.
secret := "0x123456789abcdef"
// Create a hcaptcha middleware with the secret key and a custom error handler.
hcaptchaMiddleware := hcaptcha.New(secret, func(c *hcaptcha.Client) {
c.FailureHandler = func(ctx iris.Context) {
// Handle the error as you wish, for example:
ctx.StopWithText(iris.StatusBadRequest, "hcaptcha verification failed: %v", err)
}
})
可以通过:https://dashboard.hcaptcha.com找到秘密钥匙。请将其存储在安全且私人的地方。要在当地环境上测试HCAPTCHA
最后,我们需要在IRIS应用中注册HCAPTCHA中间件。我们可以使用app.UseRouter
方法将中间件应用于所有路由,或将其应用于所有非误差路由的app.Use/UseGlobal
方法。例如:
// Create an Iris app instance.
app := iris.New()
// Apply the hcaptcha middleware to all non-error routes.
app.Use(hcaptchaMiddleware)
// Or apply the hcaptcha middleware to specific routes.
app.Get("/protected", hcaptchaMiddleware, func(ctx iris.Context) {
// This route is protected by hcaptcha.
ctx.WriteString("Hello, human!")
})
结论
在本文中,我们学会了如何与Iris一起使用基本的HCAPTCHA中间件。有关更完整的示例,请导航:https://github.com/kataras/iris/tree/master/_examples/auth/hcaptcha。通过使用此类功能,我们可以创建一个更安全,用户友好且健壮的Web应用程序。
我希望您喜欢这篇文章,并发现它有用。如果您有任何疑问或反馈,请随时在下面发表评论。谢谢您的阅读! ð