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

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "README-"
)

cymruservices

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

Description

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
• flush: flush one or more API caches

Installation

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

options(width=120)

Usage

library(cymruservices)

# current verison
packageVersion("cymruservices")

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.

hrbrmstr/cymruservices documentation built on May 17, 2019, 4:56 p.m.