Added a new captcha(cloudflare turnstile) and its corresponding document. Cloudflare turnstile official instructions are here: https://developers.cloudflare.com/turnstile Signed-off-by: ByLCY <bylcy@bylcy.dev> Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com> Co-authored-by: Jason Song <i@wolfogre.com>
		
			
				
	
	
		
			93 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			93 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
// Copyright 2023 The Gitea Authors. All rights reserved.
 | 
						|
// SPDX-License-Identifier: MIT
 | 
						|
 | 
						|
package turnstile
 | 
						|
 | 
						|
import (
 | 
						|
	"context"
 | 
						|
	"fmt"
 | 
						|
	"io"
 | 
						|
	"net/http"
 | 
						|
	"net/url"
 | 
						|
	"strings"
 | 
						|
 | 
						|
	"code.gitea.io/gitea/modules/json"
 | 
						|
	"code.gitea.io/gitea/modules/setting"
 | 
						|
)
 | 
						|
 | 
						|
// Response is the structure of JSON returned from API
 | 
						|
type Response struct {
 | 
						|
	Success     bool        `json:"success"`
 | 
						|
	ChallengeTS string      `json:"challenge_ts"`
 | 
						|
	Hostname    string      `json:"hostname"`
 | 
						|
	ErrorCodes  []ErrorCode `json:"error-codes"`
 | 
						|
	Action      string      `json:"login"`
 | 
						|
	Cdata       string      `json:"cdata"`
 | 
						|
}
 | 
						|
 | 
						|
// Verify calls Cloudflare Turnstile API to verify token
 | 
						|
func Verify(ctx context.Context, response string) (bool, error) {
 | 
						|
	// Cloudflare turnstile official access instruction address: https://developers.cloudflare.com/turnstile/get-started/server-side-validation/
 | 
						|
	post := url.Values{
 | 
						|
		"secret":   {setting.Service.CfTurnstileSecret},
 | 
						|
		"response": {response},
 | 
						|
	}
 | 
						|
	// Basically a copy of http.PostForm, but with a context
 | 
						|
	req, err := http.NewRequestWithContext(ctx, http.MethodPost,
 | 
						|
		"https://challenges.cloudflare.com/turnstile/v0/siteverify", strings.NewReader(post.Encode()))
 | 
						|
	if err != nil {
 | 
						|
		return false, fmt.Errorf("Failed to create CAPTCHA request: %w", err)
 | 
						|
	}
 | 
						|
	req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
 | 
						|
 | 
						|
	resp, err := http.DefaultClient.Do(req)
 | 
						|
	if err != nil {
 | 
						|
		return false, fmt.Errorf("Failed to send CAPTCHA response: %w", err)
 | 
						|
	}
 | 
						|
	defer resp.Body.Close()
 | 
						|
	body, err := io.ReadAll(resp.Body)
 | 
						|
	if err != nil {
 | 
						|
		return false, fmt.Errorf("Failed to read CAPTCHA response: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	var jsonResponse Response
 | 
						|
	if err := json.Unmarshal(body, &jsonResponse); err != nil {
 | 
						|
		return false, fmt.Errorf("Failed to parse CAPTCHA response: %w", err)
 | 
						|
	}
 | 
						|
 | 
						|
	var respErr error
 | 
						|
	if len(jsonResponse.ErrorCodes) > 0 {
 | 
						|
		respErr = jsonResponse.ErrorCodes[0]
 | 
						|
	}
 | 
						|
	return jsonResponse.Success, respErr
 | 
						|
}
 | 
						|
 | 
						|
// ErrorCode is a reCaptcha error
 | 
						|
type ErrorCode string
 | 
						|
 | 
						|
// String fulfills the Stringer interface
 | 
						|
func (e ErrorCode) String() string {
 | 
						|
	switch e {
 | 
						|
	case "missing-input-secret":
 | 
						|
		return "The secret parameter was not passed."
 | 
						|
	case "invalid-input-secret":
 | 
						|
		return "The secret parameter was invalid or did not exist."
 | 
						|
	case "missing-input-response":
 | 
						|
		return "The response parameter was not passed."
 | 
						|
	case "invalid-input-response":
 | 
						|
		return "The response parameter is invalid or has expired."
 | 
						|
	case "bad-request":
 | 
						|
		return "The request was rejected because it was malformed."
 | 
						|
	case "timeout-or-duplicate":
 | 
						|
		return "The response parameter has already been validated before."
 | 
						|
	case "internal-error":
 | 
						|
		return "An internal error happened while validating the response. The request can be retried."
 | 
						|
	}
 | 
						|
	return string(e)
 | 
						|
}
 | 
						|
 | 
						|
// Error fulfills the error interface
 | 
						|
func (e ErrorCode) Error() string {
 | 
						|
	return e.String()
 | 
						|
}
 |