trufflehog/pkg/detectors/snowflake/snowflake.go
Zubair Khan 519646342e
add snowflake detector (#1653)
Detect Snowflake secrets (compound URI of account, username, password) and enrich Secret Result with account and databases that the secret has access to.
2023-08-24 13:29:58 -04:00

165 lines
4.8 KiB
Go

package snowflake
import (
"context"
"database/sql"
"fmt"
_ "github.com/snowflakedb/gosnowflake"
"github.com/trufflesecurity/trufflehog/v3/pkg/common"
"github.com/trufflesecurity/trufflehog/v3/pkg/detectors"
"github.com/trufflesecurity/trufflehog/v3/pkg/pb/detectorspb"
"regexp"
"strings"
"unicode"
)
type Scanner struct {
}
// Ensure the Scanner satisfies the interface at compile time.
var _ detectors.Detector = (*Scanner)(nil)
var (
accountIdentifierPat = regexp.MustCompile(detectors.PrefixRegex([]string{"account"}) + `\b([a-zA-Z]{7}-[0-9a-zA-Z]{7})\b`)
usernameExclusionPat = `!@#$%^&*{}:<>,.;?()/\+=\s\n`
)
const (
database = "SNOWFLAKE"
retrieveAllDatabasesQuery = "SHOW DATABASES"
timeout = 3
)
// Keywords are used for efficiently pre-filtering chunks.
// Use identifiers in the secret preferably, or the provider name.
func (s Scanner) Keywords() []string {
return []string{"snowflake"}
}
func meetsSnowflakePasswordRequirements(password string) (string, bool) {
var hasLower, hasUpper, hasNumber, minLen bool
if len(password) < 8 {
minLen = false
} else {
minLen = true
}
for _, char := range password {
switch {
case unicode.IsLower(char):
hasLower = true
case unicode.IsUpper(char):
hasUpper = true
case unicode.IsNumber(char):
hasNumber = true
}
if hasLower && hasUpper && hasNumber && minLen {
return password, true
}
}
return "", false
}
// FromData will find and optionally verify Snowflake 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)
accountMatches := accountIdentifierPat.FindAllStringSubmatch(dataStr, -1)
usernameRegexState := common.UsernameRegexCheck(usernameExclusionPat)
usernameMatches := usernameRegexState.Matches(data)
passwordRegexState := common.PasswordRegexCheck(" ") // No explicit character exclusions by Snowflake for passwords
passwordMatches := passwordRegexState.Matches(data)
for _, accountMatch := range accountMatches {
if len(accountMatch) != 2 {
continue
}
resAccountMatch := strings.TrimSpace(accountMatch[1])
for _, resUsernameMatch := range usernameMatches {
for _, resPasswordMatch := range passwordMatches {
_, metPasswordRequirements := meetsSnowflakePasswordRequirements(resPasswordMatch)
if !metPasswordRequirements {
continue
}
// Override default timeout of 60 seconds to 3 seconds to prevent long scan times/improve performance.
uri := fmt.Sprintf("%s:%s@%s/%s?loginTimeout=%d", resUsernameMatch, resPasswordMatch, resAccountMatch, database, timeout)
s1 := detectors.Result{
DetectorType: detectorspb.DetectorType_Snowflake,
Raw: []byte(resPasswordMatch),
ExtraData: map[string]string{
"account": resAccountMatch,
"username": resUsernameMatch,
},
}
if verify {
// Open a connection to Snowflake
db, err := sql.Open("snowflake", uri) // Needs the snowflake driver from gosnowflake
if err != nil {
// sql.Open() only errors if unable to import the snowflake driver, in which case we should panic.
panic(err)
}
defer db.Close()
if ctx == nil {
ctx = context.Background()
}
err = db.PingContext(ctx)
if err != nil {
if strings.Contains(err.Error(), "Incorrect username or password was specified") {
s1.Verified = false
} else {
s1.VerificationError = err
}
} else {
rows, err := db.Query(retrieveAllDatabasesQuery)
if err != nil {
s1.ExtraData["Snowflake Querying Error on a Valid Credential"] = fmt.Sprintf("unable to query Snowflake %+v", err)
continue
}
defer rows.Close()
var databases []string
for rows.Next() {
var name, createdOn, isDefault, isCurrent, origin, owner, comment, option, retentionTime, kind string
err := rows.Scan(&createdOn, &name, &isDefault, &isCurrent, &origin, &owner, &comment, &option, &retentionTime, &kind)
if err != nil {
s1.ExtraData["Snowflake Querying Error on a Valid Credential"] = fmt.Sprintf("unable to finish querying Snowflake to enrich secret ExtraData %+v", err)
}
databases = append(databases, name)
}
s1.ExtraData["databases"] = strings.Join(databases, ", ")
if s1.VerificationError == nil {
s1.Verified = true
}
}
}
// This function will check false positives for common test words, but also it will make sure the key appears 'random' enough to be a real key.
if !s1.Verified && detectors.IsKnownFalsePositive(resPasswordMatch, detectors.DefaultFalsePositives, true) {
continue
}
results = append(results, s1)
}
}
}
return results, nil
}
func (s Scanner) Type() detectorspb.DetectorType {
return detectorspb.DetectorType_Snowflake
}