Files
trufflehog/pkg/detectors/telegrambottoken/telegrambottoken.go
Amaan Ullah 0fa069c12f Enable errcheck and staticcheck for golangci-lint v2 and resolve all issues (#4924)
* enable errcheck and staticcheck for golangci-lint v2 and resolve all issues

* skip lint on intentional reference of deprecated DetectorType values
2026-05-15 17:07:14 +05:00

103 lines
2.8 KiB
Go

package telegrambottoken
import (
"context"
"encoding/json"
"net/http"
"strings"
// "fmt"
regexp "github.com/wasilibs/go-re2"
"github.com/trufflesecurity/trufflehog/v3/pkg/common"
"github.com/trufflesecurity/trufflehog/v3/pkg/detectors"
"github.com/trufflesecurity/trufflehog/v3/pkg/pb/detector_typepb"
)
type Scanner struct{}
// Ensure the Scanner satisfies the interface at compile time.
var _ detectors.Detector = (*Scanner)(nil)
var (
client = common.SaneHttpClient()
// https://core.telegram.org/bots#6-botfather
// thanks https://stackoverflow.com/questions/61868770/tegram-bot-api-token-format
keyPat = regexp.MustCompile(detectors.PrefixRegex([]string{"telegram", "tgram://"}) + `\b([0-9]{8,10}:[a-zA-Z0-9_-]{35})\b`)
)
// Keywords are used for efficiently pre-filtering chunks.
// Use identifiers in the secret preferably, or the provider name.
func (s Scanner) Keywords() []string {
// Apprise uses the `tgram://` url scheme.
// https://github.com/caronc/apprise/wiki/Notify_telegram
return []string{"telegram", "tgram"}
}
// FromData will find and optionally verify TelegramBotToken secrets in a given set of bytes.
func (s Scanner) FromData(ctx context.Context, verify bool, data []byte) (results []detectors.Result, err error) {
dataStr := string(data)
matches := keyPat.FindAllStringSubmatch(dataStr, -1)
for _, match := range matches {
key := strings.TrimSpace(match[1])
s1 := detectors.Result{
DetectorType: detector_typepb.DetectorType_TelegramBotToken,
Raw: []byte(key),
SecretParts: map[string]string{"key": key},
}
if verify {
// https://core.telegram.org/bots/api#getme
req, err := http.NewRequestWithContext(ctx, "GET", "https://api.telegram.org/bot"+key+"/getMe", nil)
if err != nil {
continue
}
res, err := client.Do(req)
if err == nil {
defer func() { _ = res.Body.Close() }()
if res.StatusCode >= 200 && res.StatusCode < 300 {
s1.Verified = true
apiRes := apiResponse{}
err := json.NewDecoder(res.Body).Decode(&apiRes)
if err == nil && apiRes.Ok {
s1.ExtraData = map[string]string{
"username": apiRes.Result.Username,
}
}
}
}
}
results = append(results, s1)
}
return results, nil
}
// https://core.telegram.org/bots/api#making-requests
type apiResponse struct {
Ok bool `json:"ok"`
Result *userResponse `json:"result"`
}
// https://core.telegram.org/bots/api#user
type userResponse struct {
IsBot bool `json:"is_bot"`
Username string `json:"username"`
}
func (s Scanner) Type() detector_typepb.DetectorType {
return detector_typepb.DetectorType_TelegramBotToken
}
func (s Scanner) Description() string {
return "Telegram Bot API tokens are used to authenticate requests to the Telegram Bot API. They can be used to control and interact with Telegram bots."
}