Detects Fraud in Online Surveys by Tracing, Scoring, and Visualizing IP Addresses

Takes an array of IPs and the keys for the services the user wishes to use (IP Hub, IP Intel, and Proxycheck), and passes these to all respective APIs. Returns a dataframe with the IP addresses (used for merging), country, ISP, labels for non-US IP Addresses, VPS use, and recommendations for blocking. The package also provides optional visualization tools for checking the distributions. Additional functions are provided to call each discrete API endpoint. The package and methods are detailed in the recent paper Waggoner, Kennedy, and Clifford (2019) .


Takes an array of IPs and the keys for the services the user wishes to use (IP Hub, IP Intel, and Proxycheck), and passes these to all respective APIs. Returns a dataframe with the IP addresses (used for merging), country, ISP, labels for non-US IP Addresses, VPS use, and recommendations for blocking. Users also have the option to visualize the distributions.

Especially important in this is the variable "block", which gives a score indicating whether the IP address is likely from a server farm and should be excluded from the data. It is codes 0 if the IP is residential/unclassified (i.e. safe IP), 1 if the IP is non-residential IP (hostping provider, proxy, etc. - should likely be excluded), and 2 for non-residential and residential IPs (more stringent, may flag innocent respondents).

Note: rIP requires users to have active (free) accounts and/or valid keys at iphub, ipintel, and/or proxycheck.

See some related working papers here and here.

Installation

Users can install either the stable version released on CRAN:

install.packages("rIP")
library(rIP)

Or the dev version directly from the MAHD lab GitHub repo (https://github.com/MAHDLab/rIP):

library(devtools)
install_github(MAHDLab/rIP)
library(rIP)

Usage

# Load the library
library(rIP)
 
# Store personal keys for IP service pings (here we include only "ipHub" as an example)
ip_hub_key <- "MzI2MTpkOVpld3pZTVg1VmdTV3ZPenpzMmhodkJmdEpIMkRMZQ=="
ipsample <- data.frame(rbind(c(1, "129.7.105.146"), c(2, "128.239.134.248")))
names(ipsample) <- c("number", "IPAddress")
 
# Call the function
getIPinfo(ipsample, "IPAddress", iphub_key = ip_hub_key)

Acknowledgements

We thank Tyler Burleigh for his help on this tool. His method for incorporating this information into Qualtrics surveys can be found here.

News

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("rIP")

1.2.0 by Ryan Kennedy, 4 months ago


http://joss.theoj.org/papers/10.21105/joss.01285


Report a bug at https://github.com/MAHDLab/rIP/issues


Browse source code at https://github.com/cran/rIP


Authors: Ryan Kennedy [aut, cre] , Philip Waggoner [aut] , Scott Clifford [ctb] , Bob Rudis [ctb]


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports httr, utils, iptools, dplyr, graphics, amerika, jsonlite

Suggests testthat


See at CRAN