
- Splunk 7.1.3 >
- Python 2.7.14 > ($SPLUNK_HOME/bin/python)
Setup
- Open a terminal and run the following commands as the user running Splunk:
cd /opt/splunk/etc/apps
git clone https://github.com/leunammejii/osweep.git
mv osweep-master osweep
sudo -H -u $SPLUNK_USER /opt/splunk/bin/splunk restart # $SPLUNK_USER = User running Splunk
- Edit “config.py” and add the necessary values as strings to the config file:
vim ./osweep/etc/config.py
Note: Values for the proxies should be the full URL including the port (ex. http://<IP Adress>:<Port>).
3. Save “config.py” and close the terminal.
4. Install Pip packages:
cd /opt/splunk/etc/apps/osweep/bin
bash py_pkg_update.sh
Commands
- crtsh – https://crt.sh/
- cybercrimeTracker – http://cybercrime-tracker.net/index.php
- cymon – https://cymon.io/
- greyNoise – https://greynoise.io/
- phishingCatcher – https://github.com/x0rz/phishing_catcher
- phishingKitTracker – https://github.com/neonprimetime/PhishingKitTracker
- ransomwareTracker – https://ransomwaretracker.abuse.ch/
- threatcrowd – https://www.threatcrowd.org/
- twitter – https://twitter.com/
- urlhaus – https://urlhaus.abuse.ch/
- urlscan – https://urlscan.io/
Usage
Feed Overview – Dashboard
Three of the dashboards below use lookup tables to store the data feed from the sources. This dasboard shows the current stats compared to the previous day.
The Round Table – Dashboard
- Switch to the The Round Table dashboard in the OSweep™ app.
- Add the list of IOCs to the “IOC (+)” textbox to know which source has the most information.
- Click “Submit”.
- After the panels have populated, click on one to be redirected to the corresponding dashboard to see the results.
Certificate Search – Dashboard
- Switch to the Certificate Search dashboard in the OSweep™ app.
- Add the list of IOCs to the “Domain, IP (+)” textbox.
- Select “Yes” or “No” from the “Wildcard” dropdown to search for subdomains.
- Click “Submit”.
Certificate Search – Adhoc
| crtsh <DOMAINS>
| fillnull value="-"
| search NOT "issuer ca id"="-"
| dedup "issuer ca id" "issuer name" "name value" "min cert id" "min entry timestamp" "not before" "not after"
| table "issuer ca id" "issuer name" "name value" "min cert id" "min entry timestamp" "not before" "not after"
| sort - "min cert id"
or to search for subdomains,
| crtsh subdomain <DOMAINS>
| fillnull value="-"
| search NOT "issuer ca id"="-"
| dedup "issuer ca id" "issuer name" "name value" "min cert id" "min entry timestamp" "not before" "not after"
| table "issuer ca id" "issuer name" "name value" "min cert id" "min entry timestamp" "not before" "not after"
| sort - "min cert id"
or to search for wildcard,
| crtsh wildcard <DOMAINS>
| fillnull value="-"
| search NOT "issuer ca id"="-"
| dedup "issuer ca id" "issuer name" "name value" "min cert id" "min entry timestamp" "not before" "not after"
| table "issuer ca id" "issuer name" "name value" "min cert id" "min entry timestamp" "not before" "not after"
| sort - "min cert id"
CyberCrime Tracker – Dashboard
- Switch to the CyberCrime Tracker dashboard in the OSweep™ app.
- Add the list of IOCs to the ‘Domain, IP (+)’ textbox.
- Select whether the results will be grouped and how from the dropdowns.
- Click ‘Submit’.
CyberCrime Tracker – Adhoc
| cybercrimeTracker <IOCs>
| fillnull value="-"
| search NOT date="-"
| dedup date url ip "vt latest scan" "vt ip info" type
| table date url ip "vt latest scan" "vt ip info" type
Cymon – Dashboard
- Switch to the Cymon dashboard in the OSweep™ app.
- Add the list of IOCs to the “Domain, IP, MD5, SHA256 (+)” textbox.
- Select whether the results will be grouped and how from the dropdowns.
- Click “Submit”.
Cymon – Adhoc
| cymon <IOCs>
| table "feed id" feed title description tags timestamp ip url hostname domain md5 sha1 sha256 ssdeep "reported by" country city lat lon
GreyNoise – Dashboard
- Manually download data feed (one-time only)
| greyNoise feed
- Switch to the GreyNoise dashboard in the OSweep™ app.
- Add the list of IOCs to the ‘Domain, IP, Scanner Name (+)’ textbox.
- Select whether the results will be grouped and how from the dropdowns.
- Click ‘Submit’.
GreyNoise – Adhoc
| greynoise <IOCs>
| fillnull value="-"
| search NOT "last updated"="-"
| dedup category confidence "last updated" name ip intention "first seen" datacenter tor "rdns parent" link org os asn rdns
| table category confidence "last updated" name ip intention "first seen" datacenter tor "rdns parent" link org os asn rdns
| sort - "Last Updated"
Phishing Catcher – Dashboard
- Switch to the Phishing Catcher dashboard in the OSweep™ app.
- Select whether you want to monitor the logs in realtime or add a list of domains.
- If Monitor Mode is “Yes”:
- Add a search string to the ‘Base Search’ textbox.
- Add the field name of the field containing the domain to the “Field Name” textbox.
- Select the time range to search.
- If Monitor Mode is “No”:
- Add the list of domains to the ‘Domain (+)’ textbox.
- Click ‘Submit’.
Phishing Catcher – Adhoc
| phishingCatcher <DOMAINS>
| table domain "threat level" score
Phishing Kit Tracker – Dashboard
- Manually download data feed (one-time only)
| phishingKitTracker feed
- Switch to the Phishing Kit Tracker dashboard in the OSweep™ app.
Ransomare Tracker – Dashboard
- Manually download data feed (one-time only)
| ransomwareTracker feed
- Switch to the Ransomare Tracker dashboard in the OSweep™ app.
- Add the list of IOCs to the ‘Domain, IP, Malware, Status, Threat, URL (+)’ textbox.
- Select whether the results will be grouped and how from the dropdowns.
- Click ‘Submit’.
Ransomare Tracker – Adhoc
| ransomwareTracker <DOMAINS>
| fillnull value="-"
| search NOT "firstseen (utc)"="-"
| dedup "firstseen (utc)" threat malware host "ip address(es)" url status registrar asn(s) country
| table "firstseen (utc)" threat malware host "ip address(es)" url status registrar asn(s) country
| sort "firstseen (utc)"
ThreatCrowd – Dashboard
- Switch to the ThreatCrowd dashboard in the OSweep™ app.
- Add the list of IOCs to the ‘IP, Domain, or Email (+)’ textbox.
- Select the IOC type.
- Click ‘Submit’.
Twitter – Dashboard
- Switch to the Twitter dashboard in the OSweep app.
- Add the list of IOCs to the “Search Term (+)” textbox.
- Click “Submit”.
Twitter – Adhoc
| twitter <IOCs>
| eval epoch=strptime(timestamp, "%+")
| fillnull value="-"
| search NOT timestamp="-"
| dedup timestamp tweet url
| sort - epoch
| table timestamp tweet url hashtags "search term"
URLhaus – Dashboard
- Manually download data feed (one-time only)
| urlhaus feed
- Switch to the URLhaus dashboard in the OSweep™ app.
- Add the list of IOCs to the ‘Domain, IP, MD5, SHA256, URL (+)’ textbox.
- Select whether the results will be grouped and how from the dropdowns.
- Click ‘Submit’.
URLhaus – Adhoc
| urlhaus <IOCs>
| fillnull value="-"
| search NOT "provided ioc"="-"
| dedup id dateadded url payload "url status" threat tags "urlhaus link"
| table id dateadded url payload "url status" threat tags "urlhaus link"
urlscan.io – Dashboard
- Switch to the urlscan.io dashboard in the OSweep™ app.
- Add the list of IOCs to the ‘Domain, IP, SHA256 (+)’ textbox.
- Select whether the results will be grouped and how from the dropdowns.
- Click ‘Submit’.
urlscan.io – Adhoc
| urlscan <IOCs>
| fillnull value="-"
| search NOT url="-"
| dedup url domain ip ptr server city country asn asnname filename filesize mimetype sha256
| table url domain ip ptr server city country asn asnname filename filesize mimetype sha256
| sort sha256
Destroy
To remove the project completely, run the following commands:
rm -rf /opt/splunk/etc/apps/osweep
Things to know
All commands accept input from the pipeline. Either use the fields
or table
command to select one field containing the values that the command accepts and pipe it to the command with the first argument being the field name.
<search>
| fields <FIELD NAME>
| <OSWEEP COMMAND> <FIELD NAME>
ex. The following will allow a user to find other URLs analyzed by URLhaus that are hosting the same Emotet malware as ahsweater[d]com and group it by the payload:
| urlhaus ahsweater.com
| fields payload
| urlhaus payload
| stats values(url) AS url BY payload
You can also pipe the results of one command into a totally different command to correlate data.
Dashboards Coming Soon
- Alienvault
- Censys
- Hybrid-Analysis
- Malshare
- PulseDive
Please fork, create merge requests, and help make this better.