Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/securityclippy/greynoise
Unofficial greynoise.io go client. WIP.
https://github.com/securityclippy/greynoise
Last synced: about 1 month ago
JSON representation
Unofficial greynoise.io go client. WIP.
- Host: GitHub
- URL: https://github.com/securityclippy/greynoise
- Owner: securityclippy
- License: gpl-3.0
- Created: 2018-06-25T05:38:14.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-09-13T21:22:01.000Z (over 6 years ago)
- Last Synced: 2024-06-20T03:26:07.050Z (6 months ago)
- Language: Go
- Size: 21.5 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ip-search-engines - GreyNoise
README
# Unofficial Greynoise.io go client
This is a basic go client for the greynoise v2 api. Most endpoints are functional,
but several are still to be implemented on they greynoise platform.
to get started:
```bash
go get -u github.com/securityclippy/greynoise
```
`main.go`
holds some basic examples of the endpoints and their associated functions
### basic usage:
```
package main
import (
"github.com/securityclippy/greynoise/client"
"github.com/securityclippy/greynoise/conf"
)
func main() {
config, err := conf.ReadConfig("config.json")
if err != nil {
logger.Fatal(err)
}
greyNoise := client.NewClient(config)
// call endpoint call
resp, err := greyNoise.MetaPing()
if err != nil {
log.Fatal(err)
}
// parse response body from *http.response returned by endpoints
body, err := greyNoise.ParseResponse(resp)
// print out response body
log.Info(string(body))
```
### endpoint implementation Status
#### NOTE: as noted by greynoise.io...
Many endpoints may be subject to change, not working fully or not yet implemented.
Endpoints are a best-effort right now, but work unless noted. Some are currently not
responding within a 5 minute timeout, but may work in future.
- [x] /v2/meta/ping
- [x] /v2/research/time_series/scan/{protoco}/{port} __NOTE: currently not responding__
- [ ] /v2/research/time_series/http/path - __(Greynoise - Not Yet Implemented)__
- [ ] /v2/research/time_series/http/useragent - __(Greynoise - Not Yet Implemented)__
- [x] /v2/research/tag/list
- [x] /v2/research/tag/combination
- [x] /v2/research/tag/single
- [x] /v2/research/ip/{ip}
- [x] /v2/research/raw/scan/{protocol}/{port} - __(Greynoise - Not Yet Implemented)__
- [x] /v2/research/raw/ip/{ip} - __(Greynoise - Not Yet Implemented)__
- [ ] /v2/research/raw/http/path __(Greynoise - Not Yet Implemented)__
- [ ] /v2/research/raw/http/useragent __(Greynoise - Not Yet Implemented)__
- [x] /v2/research/stats/top/scan
- [x] /v2/research/stats/top/http/path
- [x] /v2/research/stats/top/http/useragent
- [x] /v2/research/stats/top/org
- [x] /v2/research/stats/top/asn
- [x] /v2/research/stats/top/rdns
- [x] /v2/research/search/org __NOTE: currently not responding__
- [ ] /v2/research/search/org/historical
- [x] /v2/research/actors __NOTE: currently not responding__
- [x] /v2/infections/cidr/{block}/{bits}
- [x] /v2/infections/asn/{asn} __NOTE: currently not responding__
- [x] /v2/infections/search/org __NOTE: currently not responding__
- [x] /v2/research/scanners/cidr/{block}/{bits}
- [x] /v2/research/scanners/asn/{asn} __NOTE: currently not responding__
- [x] /v2/research/ja3/fingerprint/{fingerprint}
- [x] /v2/research/ja3/ip/{ip}
- [x] /v2/enterprise/noise/quick/{ip}
- [x] /v2/enterprise/noise/multi/quick
TODO:
- [ ] Unit Tests
- [ ] update not-responding endpoints
- [ ] add data types for endpoints