Query 'Team Cymru' 'IP' Address, Autonomous System Number ('ASN'), Border Gateway Protocol ('BGP'), Bogon and 'Malware' Hash Data Services

A toolkit for querying 'Team Cymru' < http://team-cymru.org> 'IP' address, Autonomous System Number ('ASN'), Border Gateway Protocol ('BGP'), Bogon and 'Malware' Hash Data Services.

cymruservices is an R package that provides interfaces to various Team Cymru Services including:

• The Bogon Reference
• The IP to ASN Mapping Project
• The Malware Hash Registry

The following functions are implemented:

• bulk_origin: Retrieves BGP Origin ASN info for a list of IPv4 addresses

• bulk_origin_asn: Retrieves BGP Origin ASN info for a list of ASN ids

• bulk_peer: Retrieves BGP Peer ASN info for a list of IPv4 addresses

• ipv4_bogons: Retrieve list of IPv4 "full bogons" from Team Cymru webservice

• ipv6_bogons: Retrieve list of IPv6 "full bogons" from Team Cymru webservice

• malware_hash: Retrieves malware hash metadata from the Malware Hash Registry

• Version 0.2.0 timeout parameter added to whois-based functions

• Version 0.1.0 is on CRAN

• Version 0.1.0.9999 released

Installation

devtools::install_github("hrbrmstr/cymruservices")
# OR
install.packages("cymruservices")

Usage

library(cymruservices)
 
# current verison
packageVersion("cymruservices")
#> [1] '0.2.0'

Test Results

library(cymruservices)
library(testthat)
 
date()
 
# only using `force=TRUE` to ensure output for the example
# see the help for each function to see why this is a bad
# idea to run force all the time
head(ipv4_bogons(force=TRUE))
 
head(ipv6_bogons(force=TRUE))
 
bulk_origin(c("68.22.187.5", "207.229.165.18", "198.6.1.65"))
 
bulk_peer(c("68.22.187.5", "207.229.165.18", "198.6.1.65"))
 
bulk_origin_asn(c(22822, 1273, 2381, 2603, 2914, 3257, 3356, 11164,
                  174, 286, 1299, 2914, 3257, 3356, 3549, 22822))
 
malware_hash(c("1250ac278944a0737707cf40a0fbecd4b5a17c9d",
              "7697561ccbbdd1661c25c86762117613",
              "cbed16069043a0bf3c92fff9a99cccdc",
              "e6dc4f4d5061299bc5e76f5cd8d16610",
              "e1112134b6dcc8bed54e0e34d8ac272795e73d74"))
 
test_dir("tests/")

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.