Anti-bot CAPTCHA

reCAPTCHA
reCAPTCHA protects your website from fraud and abuse. reCAPTCHA uses an advanced risk analysis engine and adaptive challenges to keep malicious software from engaging in abusive activities on your website. Meanwhile, legitimate users will be able to login, make purchases, view pages, or create accounts and fake users will be blocked.
Read more at: https://www.google.com/recaptcha/about/​
Using with Iris
The reCAPTCHA is a builtin middleware, you don't have to install it.
1.Import "github.com/kataras/iris/v12/middleware/recaptcha"
2.Get your public and secret keys from: https://www.google.com/recaptcha/admin 
3.Initialize with recaptcha.New(recaptchaSecret)
4.Create an HTML form which you want to protect from bots and add the script tag: <script src="https://www.google.com/recaptcha/api.js"></script>.
5.Add a hidden element or a div with class of g-recaptcha and set the data-sitekey attribute to your public key.
6.Use the middleware to protect the routes.
Example Code:
1
package main
2
​
3
import (
4
    "fmt"
5
​
6
    "github.com/kataras/iris/v12"
7
​
8
    "github.com/kataras/iris/v12/middleware/recaptcha"
9
)
10
​
11
// keys should be obtained by https://www.google.com/recaptcha/admin
12
const (
13
    recaptchaPublic = "6Lf3WywUAAAAAKNfAm5DP2J5ahqedtZdHTYaKkJ6"
14
    recaptchaSecret = "6Lf3WywUAAAAAJpArb8nW_LCL_PuPuokmEABFfgw"
15
)
16
​
17
func main() {
18
    app := iris.New()
19
​
20
    r := recaptcha.New(recaptchaSecret)
21
​
22
    app.Get("/comment", showRecaptchaForm)
23
​
24
    // pass the middleware before the main handler
25
    // or use the `recaptcha.SiteVerify`.
26
    app.Post("/comment", r, postComment)
27
​
28
    app.Listen(":8080")
29
}
30
​
31
// You can use view templates instead.
32
var htmlForm = `<form action="/comment" method="POST">
33
    <script src="https://www.google.com/recaptcha/api.js"></script>
34
    <div class="g-recaptcha" data-sitekey="%s"></div>
35
    <input type="submit" name="button" value="Verify">
36
</form>`
37
​
38
func showRecaptchaForm(ctx iris.Context) {
39
    contents := fmt.Sprintf(htmlForm, recaptchaPublic)
40
    ctx.HTML(contents)
41
}
42
​
43
// This handler is protected by the recaptcha middleware.
44
func postComment(ctx iris.Context) {
45
    // [...]
46
    ctx.JSON(iris.Map{"success": true})
47
}
Copied!
Navigate to http://localhost:8080/comment.
hCaptcha
Stop more bots. Start protecting user privacy. Do you use a captcha to keep out bots? hCaptcha protects user privacy, rewards websites, and helps companies get their data labeled. It is a drop-in replacement for reCAPTCHA: you can switch within minutes.
Read more at: https://www.hcaptcha.com/​
Using with Iris
The hCaptcha is a builtin middleware, you don't have to install it.
1.Import "github.com/kataras/iris/v12/middleware/hcaptcha"
2.Get your public and secret keys from: https://dashboard.hcaptcha.com.
3.Initialize with hcaptcha.New(secretKey)
4.Create an HTML form which you want to protect from bots and add the script tag: <script src="https://hcaptcha.com/1/api.js" async defer></script>.
5.Add a hidden element or a div with class of h-captcha and set the data-sitekey attribute to your public key.
6.Use the middleware to protect the routes.
Example Code:
For local development you have to setup your HOSTS file:
1
# https://docs.hcaptcha.com/#localdev
2
# Add to the end of your hosts file, 
3
# e.g. on windows: C:/windows/system32/drivers/etc/hosts
4
127.0.0.1 yourdomain.com
Copied!
Let's start by creating our HTML view template form:
1
<!-- ./templates/register_form.html -->
2
<html>
3
​
4
<head>
5
  <title>hCaptcha Demo</title>
6
  <script src="https://hcaptcha.com/1/api.js" async defer></script>
7
</head>
8
​
9
<body>
10
  <form action="/register" method="POST">
11
    <input type="text" name="email" placeholder="Email" />
12
    <input type="password" name="password" placeholder="Password" />
13
    <div class="h-captcha" data-sitekey="{{ .SiteKey }}"></div>
14
    <br />
15
    <input type="submit" value="Submit" />
16
  </form>
17
</body>
18
​
19
</html>
Copied!
The web server should look like this:
1
// ./main.go
2
package main
3
​
4
import (
5
    "os"
6
​
7
    "github.com/kataras/iris/v12"
8
    "github.com/kataras/iris/v12/middleware/hcaptcha"
9
)
10
​
11
// Get the following values from: https://dashboard.hcaptcha.com
12
// Also, check: https://docs.hcaptcha.com/#localdev to test on local environment.
13
var (
14
    siteKey   = os.Getenv("HCAPTCHA-SITE-KEY")
15
    secretKey = os.Getenv("HCAPTCHA-SECRET-KEY")
16
)
17
​
18
func main() {
19
    app := iris.New()
20
    app.RegisterView(iris.HTML("./templates", ".html"))
21
​
22
    hCaptcha := hcaptcha.New(secretKey)
23
    app.Get("/register", registerForm)
24
​
25
     // See `hcaptcha.SiteVerify` for manual validation too.
26
    app.Post("/register", hCaptcha, register)
27
​
28
    app.Logger().Infof("SiteKey = %s\tSecretKey = %s",
29
        siteKey, secretKey)
30
​
31
    // GET: http://yourdomain.com/register
32
    app.Listen(":80")
33
}
34
​
35
// This handler is protected by the hcaptcha middleware.
36
func register(ctx iris.Context) {
37
​
38
    // [Some action here...]
39
}
40
​
41
func registerForm(ctx iris.Context) {
42
    ctx.ViewData("SiteKey", siteKey)
43
    ctx.View("register_form.html")
44
}
Copied!
Navigate to http://yourdomain.com/register.
Optionally, to get the hCaptcha original response you need to call hcaptcha.Get(ctx). Example:
1
hcaptchaResp, ok := hcaptcha.Get(ctx)
2
if !ok {
3
    ctx.StatusCode(iris.StatusUnauthorized)
4
    ctx.WriteString("Are you a bot?")
5
    return
6
}
7
​
8
ctx.Writef("Register action here...action was asked by a Human.\nResponse value is: %#+v", hcaptchaResp)
Copied!
That's all!

🛡️Security - Previous

Access Control

Next - 🚀Responses

Text

Last modified 1yr ago

Export as PDF

Copy link

Contents