關(guān)于Whispers

Whispers是一款功能強大的靜態(tài)代碼分析工具，該工具可以幫助廣大研究人員解析各種常見的數(shù)據(jù)格式，并搜索硬編碼憑證和危險函數(shù)。Whispers支持在命令行終端中運行，或者也可以將其集成到CI/CD管道中。

檢測功能

• 密碼
• API令牌
• AWS密鑰
• 私鑰
• 憑證哈希
• 身份認證令牌
• 危險函數(shù)
• 敏感文件

支持的格式

Whispers本質(zhì)上來說是一款結(jié)構(gòu)化的問版本解析工具，而不是一個代碼分析工具。

下面列出的是當(dāng)前版本W(wǎng)hispers支持的數(shù)據(jù)格式：

• YAML
• JSON
• XML
• .npmrc
• .pypirc
• .htpasswd
• .properties
• pip.conf
• conf / ini
• Dockerfile
• Dockercfg
• Shell scripts
• Python3

Python3文件會以AST進行解析，因為這是原生語言支持。

聲明和賦值格式

該工具可以將下列語言文件解析為文本，并檢測常見的變量聲明和賦值模式：

• JavaScript
• Java
• Go
• PHP

特殊格式支持

• AWS憑證文件
• JDBC連接字符串
• Jenkins配置文件
• SpringFramework配置文件
• Java屬性文件
• Dockercfg注冊認證文件
• GitHub令牌

工具安裝

通過PyPI安裝：

1. pip3 install whispers

GitHub安裝：

1. git clone https://github.com/Skyscanner/whispers
2. cd whispers
3. make install

工具使用

命令行接口：

1. whispers --help
2.  
3. whispers --info
4.  
5. whispers source/code/fileOrDir
6.  
7. whispers --config config.yml source/code/fileOrDir
8.  
9. whispers --output /tmp/secrets.yml source/code/fileOrDir
10.  
11. whispers --rules aws-id,aws-secret source/code/fileOrDir
12.  
13. whispers --severity BLOCKER,CRITICAL source/code/fileOrDir
14.  
15. whispers --exitcode 7 source/code/fileOrDir

Python：

1. from whispers.cli import parse_args
2.  
3. from whispers.core import run
4.  
5.  
6.  
7. src = "tests/fixtures"
8.  
9. configfile = "whispers/config.yml"
10.  
11. args = parse_args(["-c", configfile, src])
12.  
13. for secret in run(args):
14.  
15. print(secret)

工具配置

Whispers工具支持多種配置選項，我們可以根據(jù)需要來配置是否在結(jié)果中互毆文件路徑、密鑰或其他值等。config.yml的參考格式如下：

1. include:
2.  
3. files:
4.  
5. - "**/*.yml"
6.  
7.  
8.  
9. exclude:
10.  
11. files:
12.  
13. - "**/test/**/*"
14.  
15. - "**/tests/**/*"
16.  
17. keys:
18.  
19. - ^foo
20.  
21. values:
22.  
23. - bar$
24.  
25.  
26.  
27. rules:
28.  
29. starks:
30.  
31. message: Whispers from the North
32.  
33. severity: CRITICAL
34.  
35. value:
36.  
37. regex: (Aria|Ned) Stark
38.  
39. ignorecase: True

最快的配置方法就是將config.yml文件拷貝至一個新的文件中，然后直接將其以參數(shù)形式傳遞給Whispers：

1. whispers --config config.yml --rules starks src/file/or/dir

自定義規(guī)則

我們可以通過下列方式，在whispers/rules文件中添加和編輯自己的自定義規(guī)則：

1. rule-id: # unique rule name
2.  
3. description: Values formatted like AWS Session Token
4.  
5. message: AWS Session Token # report will show this message
6.  
7. severity: BLOCKER # one of BLOCKER, CRITICAL, MAJOR, MINOR, INFO
8.  
9.  
10.  
11. key: # specify key format
12.  
13. regex: (aws.?session.?token)?
14.  
15. ignorecase: True # case-insensitive matching
16.  
17.  
18.  
19. value: # specify value format
20.  
21. regex: ^(?=.*[a-z])(?=.*[A-Z])[A-Za-z0-9\+\/]{270,450}$
22.  
23. ignorecase: False # case-sensitive matching
24.  
25. minlen: 270 # value is at least this long
26.  
27. isBase64: True # value is base64-encoded
28.  
29. isAscii: False # value is binary data when decoded
30.  
31. isUri: False # value is not formatted like a URI
32.  
33.  
34.  
35. similar: 0.35 # maximum allowed similarity between key and value
36.  
37. # (1.0 being exactly the same)

插件

Whispers中所有的解析功能都是通過插件實現(xiàn)的，每一個插件都會使用pairs()方法實現(xiàn)一個類，并返回匹配規(guī)則的鍵值對：

1. class PluginName:
2.  
3. def pairs(self, file):
4.  
5. yield "key", "value"

項目地址

Whispers：【GitHub傳送門】

原文地址：https://www.freebuf.com/sectool/317584.html