You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+10-6Lines changed: 10 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ The default API URL for the HashDB Lookup Service is `https://hashdb.openanalysi
33
33
When a new hash is identified by HashDB the hash and its associated string are added to an **enum** in IDA. This enum can then be used to convert hash constants in IDA to their corresponding enum name. The enum name is configurable from the settings in the event that there is a conflict with an existing enum.
34
34
35
35
### Hash Lookup
36
-
Once the plugin settings have been configured you can right-click on any constant in the IDA disassembly window and look up the constant as a hash. The right-click also provides a quick way to set the XOR value if needed.
36
+
Once the plugin settings have been configured you can right-click on any constant in the IDA disassembly or Pseudocode (Hex-Rays) window and look up the constant as a hash. The right-click also provides a quick way to set the XOR value if needed.
After a hash is resolved (or a module is bulk-imported), HashDB scans the current function and converts every matching constant to its enum name — across operands 0–2, with a 32-bit-mask fallback for sign-extended values. The disassembly and Hex-Rays views are refreshed automatically. Modules you've already imported are cached for the session, so you won't be re-prompted to import `kernel32` (etc.) on every new hash.
51
+
49
52
### Algorithm Search
50
53
HashDB also includes a basic algorithm search that will attempt to identify the hash algorithm based on a hash value. **The search will return all algorithms that contain the hash value, it is up to the analyst to decide which (if any) algorithm is correct.** To use this functionality right-click on the hash constant and select `HashDB Hunt Algorithm`.
51
54
@@ -68,13 +71,14 @@ Instead of resolving API hashes individually (inline in code) some malware devel
68
71
69
72
Simply select the import hash block, right-click and choose `HashDB Scan IAT`. HashDB will attempt to resolve each individual integer type (`DWORD/QWORD`) in the selected range.
70
73
71
-
## Installing HashDB
72
-
Before using the plugin you must install the python **requests** module in your IDA environment. The simplest way to do this is to use pip from a shell outside of IDA.
73
-
`pip install requests`
74
+
## Installing HashDB
75
+
HashDB requires the python **requests** module. Install it from a shell outside of IDA with `pip install requests`.
74
76
75
-
Once you have the requests module installed simply copy the latest release of [`hashdb.py`](https://github.com/OALabs/hashdb-ida/releases) into your IDA plugins directory and you are ready to start looking up hashes!
77
+
You can then install the plugin in either of two ways:
78
+
-**IDA Plugin Manager (IDA 7.5+):** install/update HashDB directly from the plugin manager.
79
+
-**Manual:** copy the latest [`hashdb.py`](https://github.com/OALabs/hashdb-ida/releases) into your IDA `plugins` directory.
76
80
77
81
78
82
## ❗Compatibility Issues
79
-
The HashDB plugin has been developed for use with the __IDA 7+__and __Python 3__it is not backwards compatible.
83
+
The HashDB plugin targets __IDA 7.5+__(including IDA 9.0) with __Python 3__and is not backwards compatible.
0 commit comments