Skip to content

Commit b292103

Browse files
committed
update readme with new features
1 parent 7c0f40e commit b292103

1 file changed

Lines changed: 10 additions & 6 deletions

File tree

README.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ The default API URL for the HashDB Lookup Service is `https://hashdb.openanalysi
3333
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.
3434

3535
### 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.
3737

3838
<p align="center">
3939
<img width="380" src="/assets/HashDB-Xor_Key.png?raw=true">
@@ -46,6 +46,9 @@ If a hash is part of a module a prompt will ask if you want to import all the ha
4646
<img width="367" src="/assets/HashDB-Bulk_Import.png?raw=true">
4747
</p>
4848

49+
### Function-Wide Apply
50+
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+
4952
### Algorithm Search
5053
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`.
5154

@@ -68,13 +71,14 @@ Instead of resolving API hashes individually (inline in code) some malware devel
6871

6972
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.
7073

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`.
7476

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.
7680

7781

7882
## ❗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.
8084

0 commit comments

Comments
 (0)