diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..944843c --- /dev/null +++ b/docs/index.html @@ -0,0 +1,434 @@ + + + + + + + + +Home. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+
+ +

Travis-CI Build Status

+

gdns : Tools to work with the Google DNS over HTTPS API

+

Traditional DNS queries and responses are sent over UDP or TCP without encryption. This is vulnerable to eavesdropping and spoofing (including DNS-based Internet filtering). Responses from recursive resolvers to clients are the most vulnerable to undesired or malicious changes, while communications between recursive resolvers and authoritative nameservers often incorporate additional protection.

+

To address this problem, Google Public DNS offers DNS resolution over an encrypted HTTPS connection. DNS-over-HTTPS greatly enhances privacy and security between a client and a recursive resolver, and complements DNSSEC to provide end-to-end authenticated DNS lookups.

+

More info at https://developers.google.com/speed/public-dns/docs/dns-over-https.

+

The following functions are implemented:

+
    +
  • +bulk_query: Vectorized query, returning only answers in a data frame
    • +
  • +has_spf: Test for whether a DNS TXT record is an SPF record
    • +
  • +is_hard_fail: SPF “all” type test
    • +
  • +is_soft_fail: SPF “all” type test
    • +
  • +passes_all: SPF “all” type test
    • +
  • +query: Perform DNS over HTTPS queries using Google
    • +
  • +spf_exists: SPF field extraction functions
    • +
  • +spf_includes: SPF field extraction functions
    • +
  • +spf_ipv4s: SPF field extraction functions
    • +
  • +spf_ipv6s: SPF field extraction functions
    • +
  • +spf_ptrs: SPF field extraction functions
    • +
  • +split_spf: Split out all SPF records in a domain’s TXT record
    • +
+

Installation

+
devtools::install_github("hrbrmstr/gdns")
+

Usage

+
library(gdns)
+
+# current verison
+packageVersion("gdns")
+#> [1] '0.2.0.9000'
+
+query("rud.is")
+#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>      name type
+#> 1 rud.is.    1
+#> 
+#> $Answer
+#>      name type  TTL            data
+#> 1 rud.is.    1 3599 104.236.112.222
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+#> 
+#> $Comment
+#> [1] "Response from dns.mwebdns.net.(84.246.124.75)"
+
+query("example.com", "255") # "ANY" query
+#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] TRUE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>           name type
+#> 1 example.com.  255
+#> 
+#> $Answer
+#>            name type   TTL
+#> 1  example.com.    6  3599
+#> 2  example.com.   46 21599
+#> 3  example.com.   46 21599
+#> 4  example.com.   46  3599
+#> 5  example.com.   46    59
+#> 6  example.com.   46 21599
+#> 7  example.com.   46  3599
+#> 8  example.com.   46  3599
+#> 9  example.com.   46  3599
+#> 10 example.com.   47  3599
+#> 11 example.com.    2 21599
+#> 12 example.com.    2 21599
+#> 13 example.com.   28 21599
+#> 14 example.com.    1 21599
+#> 15 example.com.   16    59
+#> 16 example.com.   16    59
+#> 17 example.com.   48  3599
+#> 18 example.com.   48  3599
+#> 19 example.com.   48  3599
+#>                                                                                                                                                                                                                                                                                                                                                                                                                 data
+#> 1                                                                                                                                                                                                                                                                                                                                            sns.dns.icann.org. noc.dns.icann.org. 2015082662 7200 3600 1209600 3600
+#> 2                                                                                                                                                                               a 8 2 86400 1476095331 1474297785 1704 example.com. OnhJa3/aHkvePBvBME3nlZrkU/rdenyaquFgSYI/wKPq2/ZJVZGhv0TVBMJ5l6GZujqnyBfq9cvvb88//koi17oNjR5JEv2cv4rLT5pud3VhQdVrHD7fU8BV/YnCpP3ikXJMgjf6sAhgL7FZKLtpv7cFXnqznfRCTZ3HKkpBtAB0ZZw=
+#> 3                                                                                                                                                                              ns 8 2 86400 1476218628 1474362585 1704 example.com. dxPw4KtqLRMR/P1MB7umTClO/Tgf5X2ukJApKd133OMPhsy7c2N3QIxW4TLxZnCezUewDE1D86HBnGi1kGw4pN4W83lI37L6pTjIkDUtrc1acISOwg9Q9JM74On9/qKTGpTi7aSGVA5t4biLKqPm00a1Yu/VNPOxeLQPyYNjUYspNZ8=
+#> 4                                                                                                                                                                              soa 8 2 3600 1476508736 1474722585 1704 example.com. rHojLwiWn5xVU8noy1se7gRjiNI6GJdDcxwO1GU1qUs3Un4y7LyENjrK8qOv2z6EhblBOhPnrgnNMzEPPH3w+5azpU6xAH+jJHO4tExj4Pc3zzQ1sfFx1k8xWPfJjiWnUtUsk19y8vVqHvLXltvVItXlCClzljA0XyNUi1fvYjHbQxI=
+#> 5                                                                                                                                                                                txt 8 2 60 1476051975 1474218584 1704 example.com. FBZiE56Ux4VY5AMVtgitLIBWi+UteNSFh4BWwJksVRRt/7OoH7iD6h4UDqP8rNbk9qvXmRo4Ce2vROCbNkdTy/IDEoKo+Urfm69TuI2UTbl/nnQ2UtfMIEC83yywYRWdra5BPkt67SQhHSc4N7QHblABFbm2jPuu2+uOqaRCpfeoWYo=
+#> 6                                                                                                                                                                            aaaa 8 2 86400 1475967038 1474146584 1704 example.com. ZQgPaEBxSxHCPhOES76xksqOVYSRtNIieIwTwIo4Oceq0NGzjOyI+8wrgs79QHqs4e5SRe67hVX2rSaJ9Q167+TuQz57ZtyqeOZ+x+cgULyT1Q+8N0ZJlHpZS4i2VfR1xT+quG+0m9wtye8wA3Hl2mWPyTjtsH7mjoS7/U/ZQMJwi44=
+#> 7                                                                                                                                                                             nsec 8 2 3600 1475694918 1473887384 1704 example.com. XTCfotH8+cSDgNrFnCNWt4lx64yTnVzwOMZsFgynNSGS5LzY0VfRl7UvTH2WDVzdsIHgKpPBOUwv/DvjNhAMzUgHFlaK/A+U1aFa16/YQkqkIqqfnCA4EgBdhIK4FM3dSIVcpaj3PhGFKvMG4RBvoMAWLRXE3gKf3306CJzX1sfKdsA=
+#> 8  dnskey 8 2 3600 1476561735 1474722585 31406 example.com. Oup7snCR/5iUmTuGyHfCfFCisTeqaJ8RHD6aE9wZQR2CCkKZHXO9dzfUL1gA6T35p4T0XeM+TMlv1uZhX157RnanPwyZluancmm5cNz5ub0vG7G/O4DxnSoLmATYoBJ7Ub9Ul4iWFUE7nvyJ23X2MhX6XTiplXYPnztiem6rJLV84JiemoKtvapWchRhFi4w4Y+BdjHfY7IRERjQYNhVuaus5+EeppIoot9srsj2suXePGC7dE0R8z9K/BTYvQi76kBlJzzF9fNNy5JvyZPEUpXATuRD7KfxBsWHaFajOnYOb1eDAL/C0H3hhjVBov2Pexp7YDIsJzIa2g8850LruQ==
+#> 9  dnskey 8 2 3600 1476561735 1474722585 45620 example.com. f+aO6V+QKA4XgTC0Vqow59jBP/NlX6f7EEbaoXts0lp7Vaj/DBrhnS/sT4BbJb3VK1MvuPmNre5t0eyOeNCjbjrwIM2uf41GFuBI0AFxQx7o2PIdf1vrXsDnUGsZrMkYMv4gr802S7MXsvMdMN5cM0AA5Zol888sLP1yrHIcfNxG8hoUn3dS0L6nd/OxkL70+NjHBTjBQLqkLsK92ryJ0CWrzcJElszBRqfQfYGV/sJ84Ko4tjnBqRuki/rmTW5KQYdE7NI+MvERtGnep7RHb02Luk7BFPPD3uh353EYSAOVHrMH4fte6mJGcj3vxErfSWakRUXQpovLNcqYZNxoGQ==
+#> 10                                                                                                                                                                                                                                                                                                                                                              www.example.com. A NS SOA TXT AAAA RRSIG NSEC DNSKEY
+#> 11                                                                                                                                                                                                                                                                                                                                                                                               a.iana-servers.net.
+#> 12                                                                                                                                                                                                                                                                                                                                                                                               b.iana-servers.net.
+#> 13                                                                                                                                                                                                                                                                                                                                                                                2606:2800:220:1:248:1893:25c8:1946
+#> 14                                                                                                                                                                                                                                                                                                                                                                                                     93.184.216.34
+#> 15                                                                                                                                                                                                                                                                                                                                                                                                     "v=spf1 -all"
+#> 16                                                                                                                                                                                                                                                                                                                                                             "$Id: example.com 4415 2015-08-24 20:12:23Z davids $"
+#> 17                                                                                                                                                                                                                      256 3 8 AwEAAa3d68DfyIs03nGYpi3a9YX+f/wln3g6dhWWzjUUqp6CGXuaOdEHfS8zI/5JdGKi8Xoc4YmjPGfiCJIkCiQnMKn/QFygpZs41ANLdPp2jJlJhFA6IHE/xxTCxJfNhsdEAOGlMORN9Zu1XLUBo/IuCDUvUzZPgalivd/m9L+Jr4kxbg3v
+#> 18                                              257 3 8 AwEAAZ0aqu1rJ6orJynrRfNpPmayJZoAx9Ic2/Rl9VQWLMHyjxxem3VUSoNUIFXERQbj0A9Ogp0zDM9YIccKLRd6LmWiDCt7UJQxVdD+heb5Ec4qlqGmyX9MDabkvX2NvMwsUecbYBq8oXeTT9LRmCUt9KUt/WOi6DKECxoG/bWTykrXyBR8elD+SQY43OAVjlWrVltHxgp4/rhBCvRbmdflunaPIgu27eE2U4myDSLT8a4A0rB5uHG4PkOa9dIRs9y00M2mWf4lyPee7vi5few2dbayHXmieGcaAHrx76NGAABeY393xjlmDNcUkF1gpNWUla4fWZbbaYQzA93mLdrng+M=
+#> 19                                              257 3 8 AwEAAbOFAxl+Lkt0UMglZizKEC1AxUu8zlj65KYatR5wBWMrh18TYzK/ig6Y1t5YTWCO68bynorpNu9fqNFALX7bVl9/gybA0v0EhF+dgXmoUfRX7ksMGgBvtfa2/Y9a3klXNLqkTszIQ4PEMVCjtryl19Be9/PkFeC9ITjgMRQsQhmB39eyMYnal+f3bUxKk4fq7cuEU0dbRpue4H/N6jPucXWOwiMAkTJhghqgy+o9FfIp+tR/emKao94/wpVXDcPf5B18j7xz2SvTTxiuqCzCMtsxnikZHcoh1j4g+Y1B8zIMIvrEM+pZGhh/Yuf4RwCBgaYCi9hpiMWVvS4WBzx0/lU=
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+#> 
+#> $Comment
+#> [1] "Response from 199.43.135.53"
+
+query("microsoft.com", "MX")
+#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>             name type
+#> 1 microsoft.com.   15
+#> 
+#> $Answer
+#>             name type  TTL                                          data
+#> 1 microsoft.com.   15 1509 10 microsoft-com.mail.protection.outlook.com.
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+
+query("google-public-dns-a.google.com", "TXT")
+#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>                              name type
+#> 1 google-public-dns-a.google.com.   16
+#> 
+#> $Answer
+#>                              name type   TTL                    data
+#> 1 google-public-dns-a.google.com.   16 21599 "http://xkcd.com/1361/"
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+#> 
+#> $Comment
+#> [1] "Response from 216.239.36.10"
+
+query("apple.com")
+#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>         name type
+#> 1 apple.com.    1
+#> 
+#> $Answer
+#>         name type  TTL          data
+#> 1 apple.com.    1 3413 17.172.224.47
+#> 2 apple.com.    1 3413  17.178.96.59
+#> 3 apple.com.    1 3413 17.142.160.59
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+
+query("17.142.160.59", "PTR")
+#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>                          name type
+#> 1 59.160.142.17.in-addr.arpa.   12
+#> 
+#> $Answer
+#>                           name type  TTL                           data
+#> 1  59.160.142.17.in-addr.arpa.   12 3025                 apples-msk.ru.
+#> 2  59.160.142.17.in-addr.arpa.   12 3025                     icloud.se.
+#> 3  59.160.142.17.in-addr.arpa.   12 3025                     icloud.es.
+#> 4  59.160.142.17.in-addr.arpa.   12 3025                     icloud.om.
+#> 5  59.160.142.17.in-addr.arpa.   12 3025                   icloudo.com.
+#> 6  59.160.142.17.in-addr.arpa.   12 3025                     icloud.ch.
+#> 7  59.160.142.17.in-addr.arpa.   12 3025                     icloud.fr.
+#> 8  59.160.142.17.in-addr.arpa.   12 3025                   icloude.com.
+#> 9  59.160.142.17.in-addr.arpa.   12 3025          camelspaceeffect.com.
+#> 10 59.160.142.17.in-addr.arpa.   12 3025                 camelphat.com.
+#> 11 59.160.142.17.in-addr.arpa.   12 3025              alchemysynth.com.
+#> 12 59.160.142.17.in-addr.arpa.   12 3025                    openni.org.
+#> 13 59.160.142.17.in-addr.arpa.   12 3025                      swell.am.
+#> 14 59.160.142.17.in-addr.arpa.   12 3025                  appleweb.net.
+#> 15 59.160.142.17.in-addr.arpa.   12 3025                     apple.com.
+#> 16 59.160.142.17.in-addr.arpa.   12 3025        pv-apple-com.apple.com.
+#> 17 59.160.142.17.in-addr.arpa.   12 3025                ripmixburn.com.
+#> 18 59.160.142.17.in-addr.arpa.   12 3025                   yessql.info.
+#> 19 59.160.142.17.in-addr.arpa.   12 3025               webobjects.info.
+#> 20 59.160.142.17.in-addr.arpa.   12 3025                     ubnw.info.
+#> 21 59.160.142.17.in-addr.arpa.   12 3025                 skyvines.info.
+#> 22 59.160.142.17.in-addr.arpa.   12 3025            shopdifferent.info.
+#> 23 59.160.142.17.in-addr.arpa.   12 3025                 sherlock.info.
+#> 24 59.160.142.17.in-addr.arpa.   12 3025              quicktimetv.info.
+#> 25 59.160.142.17.in-addr.arpa.   12 3025            quicktimelive.info.
+#> 26 59.160.142.17.in-addr.arpa.   12 3025                 powermac.info.
+#> 27 59.160.142.17.in-addr.arpa.   12 3025                powerbook.info.
+#> 28 59.160.142.17.in-addr.arpa.   12 3025                   macosx.info.
+#> 29 59.160.142.17.in-addr.arpa.   12 3025               appleshare.info.
+#> 30 59.160.142.17.in-addr.arpa.   12 3025              applescript.info.
+#> 31 59.160.142.17.in-addr.arpa.   12 3025         applepaysupplies.info.
+#> 32 59.160.142.17.in-addr.arpa.   12 3025 applepaymerchantsupplies.info.
+#> 33 59.160.142.17.in-addr.arpa.   12 3025                 applepay.info.
+#> 34 59.160.142.17.in-addr.arpa.   12 3025             applemasters.info.
+#> 35 59.160.142.17.in-addr.arpa.   12 3025                appleexpo.info.
+#> 36 59.160.142.17.in-addr.arpa.   12 3025         applecomputerinc.info.
+#> 37 59.160.142.17.in-addr.arpa.   12 3025              applecentre.info.
+#> 38 59.160.142.17.in-addr.arpa.   12 3025                 airtunes.info.
+#> 39 59.160.142.17.in-addr.arpa.   12 3025                      apple.by.
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+
+hosts <- c("rud.is", "dds.ec", "r-project.org", "rstudio.com", "apple.com")
+gdns::bulk_query(hosts)
+#>             name type  TTL            data
+#> 1        rud.is.    1 3598 104.236.112.222
+#> 2        dds.ec.    1  299   162.243.111.4
+#> 3 r-project.org.    1 3072   137.208.57.37
+#> 4   rstudio.com.    1 3599    45.79.156.36
+#> 5     apple.com.    1 3415   17.172.224.47
+#> 6     apple.com.    1 3415    17.178.96.59
+#> 7     apple.com.    1 3415   17.142.160.59
+

Test Results

+
library(gdns)
+library(testthat)
+
+date()
+#> [1] "Thu Sep 29 09:44:11 2016"
+
+test_dir("tests/")
+#> testthat results ========================================================================================================
+#> OK: 2 SKIPPED: 0 FAILED: 0
+#> 
+#> DONE ===================================================================================================================
+

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.

+ +
+
+ + +
+ + + diff --git a/docs/news/index.html b/docs/news/index.html new file mode 100644 index 0000000..2cdb36f --- /dev/null +++ b/docs/news/index.html @@ -0,0 +1,97 @@ + + + + + + + + +All news. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+
+
+

gdns 0.2.0

+
  • CRAN release
    • +
  • Added a NEWS.md file to track changes to the package.
    • +
+
+ + + +
+ + +
+ + + diff --git a/docs/pkgdown.css b/docs/pkgdown.css new file mode 100644 index 0000000..2edd275 --- /dev/null +++ b/docs/pkgdown.css @@ -0,0 +1,59 @@ +body { + position: relative; +} + +.icon img { + float: right; + border: 1px solid #ccc; +} +.index .internal {display: none;} +ul.index li {margin-bottom: 0.5em; clear: both;} + +footer { + margin-top: 45px; + padding: 35px 0 36px; + border-top: 1px solid #e5e5e5; +} +footer p { + margin-bottom: 0; + color: #555; +} + +/* Fixes for fixed navbar --------------------------*/ + +body { + position: relative; + padding-top: 60px; +} + +.section h1, .section h2, .section h3, .section h4 { + padding-top: 60px; + margin-top: -60px; +} + +/* Table of contents --------------------------*/ + +#tocnav h2 { + margin-top: 0; + font-size: 1.5em; +} + + +/* Syntax highlighting ---------------------------------------------------- */ + +.fl,.number {color:rgb(21,20,181);} +.fu,.functioncall {color:#264D66 ;} +.ch,.st,.string {color:#375D81 ;} +.kw,.keyword {font-weight:bolder ;color:black;} +.argument {color:#264D66 ;} +.co,.comment {color: #333;} +.formalargs {color: #264D66;} +.eqformalargs {color:#264D66;} +.slot {font-style:italic;} +.symbol {color:black ;} +.prompt {color:black ;} + +pre img { + background-color: #fff; + display: block; +} diff --git a/docs/pkgdown.js b/docs/pkgdown.js new file mode 100644 index 0000000..ded9e7d --- /dev/null +++ b/docs/pkgdown.js @@ -0,0 +1,13 @@ +$(function() { + + $('#tocnav').affix({ + offset: { + top: $('#tocnav').offset().top - 80 + } + }); + $('body').scrollspy({ + target: '#tocnav', + offset: 80 + }); + +}); diff --git a/docs/reference/bulk_query.html b/docs/reference/bulk_query.html new file mode 100644 index 0000000..469eaf1 --- /dev/null +++ b/docs/reference/bulk_query.html @@ -0,0 +1,145 @@ + + + + + + + + +bulk_query. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+

Vectorized query, returning only answers in a data frame

+
+ +
+
+ +

Vectorized query, returning only answers in a data frame

+ + + 
bulk_query(entities, type = 1, edns_client_subnet = "0.0.0.0/0")
+ +

Arguments

+
+
entities
+
character vector of entities to query
+
type
+
RR type can be represented as a number in [1, 65535] or canonical +string (A, aaaa, etc). More information on RR types can be +found http://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4.
+
edns_client_subnet
+
The edns0-client-subnet option. Format is an IP +address with a subnet mask. Examples: 1.2.3.4/24, +2001:700:300::/48. +If you are using DNS-over-HTTPS because of privacy concerns, and do +not want any part of your IP address to be sent to authoritative +nameservers for geographic location accuracy, use +edns_client_subnet=0.0.0.0/0. Google Public DNS normally sends +approximate network information (usually replacing the last part of +your IPv4 address with zeroes). 0.0.0.0/0 is the default.
+
+ +
+

Value

+ +

data.frame of only answers (use query() for detailed responses)

+
+ +
+

Note

+ +

this is a fairly naive function. It expects Answer to be one of the + return value list slots. The intent for it was to make it easier + to do bulk forward queries. It will get smarter in future versions.

+
+ +
+

References

+ +

https://developers.google.com/speed/public-dns/docs/dns-over-https

+
+ +

Examples

+ 
hosts <- c("rud.is", "dds.ec", "r-project.org", "rstudio.com", "apple.com")
+gdns::bulk_query(hosts)
#>             name type  TTL            data
+#> 1        rud.is.    1 3599 104.236.112.222
+#> 2        dds.ec.    1  299   162.243.111.4
+#> 3 r-project.org.    1 7199   137.208.57.37
+#> 4   rstudio.com.    1 3599    45.79.156.36
+#> 5     apple.com.    1 1006   17.172.224.47
+#> 6     apple.com.    1 1006    17.178.96.59
+#> 7     apple.com.    1 1006   17.142.160.59
+#>
+
+
+
+
+ + +
+ + + diff --git a/docs/reference/gdns.html b/docs/reference/gdns.html new file mode 100644 index 0000000..be2ae25 --- /dev/null +++ b/docs/reference/gdns.html @@ -0,0 +1,111 @@ + + + + + + + + +gdns. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+

Tools to Work with Google DNS Over HTTPS API

+
+ +
+
+ +

Traditional DNS queries and responses are sent over UDP or TCP without +encryption. This is vulnerable to eavesdropping and spoofing (including +DNS-based Internet filtering). Responses from recursive resolvers to clients +are the most vulnerable to undesired or malicious changes, while +communications between recursive resolvers and authoritative nameservers +often incorporate additional protection.

+ +

To address this problem, Google Public DNS offers DNS resolution over an +encrypted HTTPS connection. DNS-over-HTTPS greatly enhances privacy and +security between a client and a recursive resolver, and complements DNSSEC +to provide end-to-end authenticated DNS lookups.

+ +

Support for reverse lookups is also provided.

+ +

See https://developers.google.com/speed/public-dns/docs/dns-over-https +for more information.

+ + +
+
+

Author

+ +Bob Rudis (bob@rud.is) + +
+
+ + +
+ + + diff --git a/docs/reference/has_spf.html b/docs/reference/has_spf.html new file mode 100644 index 0000000..a75203b --- /dev/null +++ b/docs/reference/has_spf.html @@ -0,0 +1,99 @@ + + + + + + + + +has_spf. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+

Test for whether a DNS TXT record is an SPF record

+
+ +
+
+ +

Test for whether a DNS TXT record is an SPF record

+ + + 
has_spf(spf_rec)
+ +

Arguments

+
+
spf_rec
+
a character vector of DNS TXT records
+
+
+
+
+
+ + +
+ + + diff --git a/docs/reference/index.html b/docs/reference/index.html new file mode 100644 index 0000000..7d19f56 --- /dev/null +++ b/docs/reference/index.html @@ -0,0 +1,107 @@ + + + + + + + + +Function reference. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+

Function reference version 0.2.0

+
+ +
+
+
+

All functions

+

+ +
+
bulk_query
+
Vectorized query, returning only answers in a data frame
+
gdns
gdns-package
+
Tools to Work with Google DNS Over HTTPS API
+
has_spf
+
Test for whether a DNS TXT record is an SPF record
+
is_hard_fail
is_soft_fail
passes_all
+
SPF "all" type test
+
query
+
Perform DNS over HTTPS queries using Google
+
spf_exists
spf_includes
spf_ipv4s
spf_ipv6s
spf_ptrs
+
SPF field extraction functions
+
split_spf
+
Split out all SPF records in a domain's TXT record
+
+
+
+
+ + +
+ + + diff --git a/docs/reference/is_soft_fail.html b/docs/reference/is_soft_fail.html new file mode 100644 index 0000000..7ed2db5 --- /dev/null +++ b/docs/reference/is_soft_fail.html @@ -0,0 +1,103 @@ + + + + + + + + +is_soft_fail. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+

SPF "all" type test

+
+ +
+
+ +

SPF "all" type test

+ + + 
is_soft_fail(spf_rec)
+
+is_hard_fail(spf_rec)
+
+passes_all(spf_rec)
+ +

Arguments

+
+
spf_rec
+
a character vector of DNS TXT records
+
+
+
+
+
+ + +
+ + + diff --git a/docs/reference/query.html b/docs/reference/query.html new file mode 100644 index 0000000..8ba4c28 --- /dev/null +++ b/docs/reference/query.html @@ -0,0 +1,430 @@ + + + + + + + + +query. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+

Perform DNS over HTTPS queries using Google

+
+ +
+
+ +

Traditional DNS queries and responses are sent over UDP or TCP without +encryption. This is vulnerable to eavesdropping and spoofing (including +DNS-based Internet filtering). Responses from recursive resolvers to clients +are the most vulnerable to undesired or malicious changes, while +communications between recursive resolvers and authoritative nameservers +often incorporate additional protection.

+ +

To address this problem, Google Public DNS offers DNS resolution over an +encrypted HTTPS connection. DNS-over-HTTPS greatly enhances privacy and +security between a client and a recursive resolver, and complements DNSSEC +to provide end-to-end authenticated DNS lookups.

+ + + 
query(name, type = "1", edns_client_subnet = "0.0.0.0/0")
+ +

Arguments

+
+
name
+
item to lookup. Valid characters are numbers, letters, hyphen, and dot. Length +must be between 1 and 255. Names with escaped or non-ASCII characters +are not supported. Internationalized domain names must use the +punycode format (e.g. "xn--qxam"). + If an IPv4 string is input, it will be transformed into +a proper format for reverse lookups.
+
type
+
RR type can be represented as a number in [1, 65535] or canonical +string (A, aaaa, etc). More information on RR types can be +found http://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-4. +You can use 255 for an ANY query.
+
edns_client_subnet
+
The edns0-client-subnet option. Format is an IP +address with a subnet mask. Examples: 1.2.3.4/24, +2001:700:300::/48. +If you are using DNS-over-HTTPS because of privacy concerns, and do +not want any part of your IP address to be sent to authoritative +nameservers for geographic location accuracy, use +edns_client_subnet=0.0.0.0/0. Google Public DNS normally sends +approximate network information (usually replacing the last part of +your IPv4 address with zeroes). 0.0.0.0/0 is the default.
+
+ +
+

Value

+ +

a list with the query result or NULL if an error occurred

+
+ +
+

Details

+ +

To perform vectorized queries with only answers (and no metadata) use +bulk_query()).

+
+ +
+

References

+ +

https://developers.google.com/speed/public-dns/docs/dns-over-https

+
+ +

Examples

+ 
query("rud.is")
#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>      name type
+#> 1 rud.is.    1
+#> 
+#> $Answer
+#>      name type  TTL            data
+#> 1 rud.is.    1 3599 104.236.112.222
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+#> 
+#> $Comment
+#> [1] "Response from dns.mwebdns.eu.(84.246.125.230)"
+#> 
+#> 
query("example.com", "255") # ANY query
#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] TRUE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>           name type
+#> 1 example.com.  255
+#> 
+#> $Answer
+#>            name type   TTL
+#> 1  example.com.    6  3599
+#> 2  example.com.   46 21599
+#> 3  example.com.   46 21599
+#> 4  example.com.   46  3599
+#> 5  example.com.   46    59
+#> 6  example.com.   46 21599
+#> 7  example.com.   46  3599
+#> 8  example.com.   46  3599
+#> 9  example.com.   46  3599
+#> 10 example.com.   47  3599
+#> 11 example.com.    2 21599
+#> 12 example.com.    2 21599
+#> 13 example.com.   28 21599
+#> 14 example.com.    1 21599
+#> 15 example.com.   16    59
+#> 16 example.com.   16    59
+#> 17 example.com.   48  3599
+#> 18 example.com.   48  3599
+#> 19 example.com.   48  3599
+#>                                                                                                                                                                                                                                                                                                                                                                                                                 data
+#> 1                                                                                                                                                                                                                                                                                                                                            sns.dns.icann.org. noc.dns.icann.org. 2015082669 7200 3600 1209600 3600
+#> 2                                                                                                                                                                               a 8 2 86400 1477364031 1475579385 1704 example.com. auGIKxU2oVxE9YE2ca9Xv5yuA2bP8uwIXW3t/d/wxGn6gnzuyVPefMHu5jT0z2ldwsqiB0+VGZpVguUeY7M22PCR0YwMGjB64/VQjsZQxAhaleVOLCRR2fya4EtOYvPRoWielQfDaS+4SBenCv0+nN8Gb3PMSsEe0ICjDSrzFRC0V7U=
+#> 3                                                                                                                                                                              ns 8 2 86400 1477484364 1475701785 1704 example.com. bY3Q/b0KCwv+fkMGpKABu3oT3y+u2xcCoykkPDJrkVGRM16Z4WojbemTYFR++pbsbuVHptz6uUtX3m94kbyvmaLvXTxy1bwY0b8F/0Rz9Se9jy5mIUiatTHftqlz434PC+UnQKNiWZBYsgQJegTJZJLlJ7/KaiIzjrhltRFWwqsOaUA=
+#> 4                                                                                                                                                                              soa 8 2 3600 1477543924 1475701785 1704 example.com. kWe1dnPv94cNlWhysZSKC3WC4/YlSTkG6/NZtFxxQcwPGlS7x+z4tRnNodhfLCpYw8D4loan0ybfWuRK/tzKminJsdt3lLqJxlXvcIzmEkI17xKUpcnD1jA0mhCfTptzLj4oCw4hhkC/d8JuD5jVmTskoiav36SV+cW1KngAY/UtPfw=
+#> 5                                                                                                                                                                                txt 8 2 60 1477325190 1475536185 1704 example.com. ZaMZnuA5mh+GSbmL3nJxDbVZEdAu0BC1I71FgOPojAgRT5i2pn4+obRCd+aUw3c/grt1xzciBdhyw9jMvzcyEwcxk2WDS+REkEwzBn1YKodoo1YCjcXVUZscugSXc+hq+eFaTcRlW/siqWq+cy77VVsjdKJTAJrcK12abkjOnRrqfww=
+#> 6                                                                                                                                                                            aaaa 8 2 86400 1477264070 1475449785 1704 example.com. M0ggDOmzYveQUd145aePLv19PwzYed7bDNsU74quoitB1nEZ8/r7ROdsT1m7VXi/BBimUVtezXBeVTc3/+2rEvhNsmX1WRrHN7seHzAiEt27TNogwn3e40YGCrwVIy+ypLRfZTi+Xlv/Ykd0H4Uvp0tW+69eel8MOlYRqSO5DMizMTc=
+#> 7                                                                                                                                                                             nsec 8 2 3600 1476958241 1475176185 1704 example.com. WnXb1Y/Qkn5CmiRir6a0KssPjiPbEq7Tko0rWsQQyFFPrT+JB/6YUKStJY5K+GN+M2tWGW3jrOSbTVei0GLxjE/3BBLoYtLqLURjEk3Ki3n5zP5c9FMyQPf3fCC0ac/kSxw5V3nTs3eSnu8p/quseV8BqkU/hYgm1qsvQOyXVUSFync=
+#> 8  dnskey 8 2 3600 1476561735 1474722585 31406 example.com. Oup7snCR/5iUmTuGyHfCfFCisTeqaJ8RHD6aE9wZQR2CCkKZHXO9dzfUL1gA6T35p4T0XeM+TMlv1uZhX157RnanPwyZluancmm5cNz5ub0vG7G/O4DxnSoLmATYoBJ7Ub9Ul4iWFUE7nvyJ23X2MhX6XTiplXYPnztiem6rJLV84JiemoKtvapWchRhFi4w4Y+BdjHfY7IRERjQYNhVuaus5+EeppIoot9srsj2suXePGC7dE0R8z9K/BTYvQi76kBlJzzF9fNNy5JvyZPEUpXATuRD7KfxBsWHaFajOnYOb1eDAL/C0H3hhjVBov2Pexp7YDIsJzIa2g8850LruQ==
+#> 9  dnskey 8 2 3600 1476561735 1474722585 45620 example.com. f+aO6V+QKA4XgTC0Vqow59jBP/NlX6f7EEbaoXts0lp7Vaj/DBrhnS/sT4BbJb3VK1MvuPmNre5t0eyOeNCjbjrwIM2uf41GFuBI0AFxQx7o2PIdf1vrXsDnUGsZrMkYMv4gr802S7MXsvMdMN5cM0AA5Zol888sLP1yrHIcfNxG8hoUn3dS0L6nd/OxkL70+NjHBTjBQLqkLsK92ryJ0CWrzcJElszBRqfQfYGV/sJ84Ko4tjnBqRuki/rmTW5KQYdE7NI+MvERtGnep7RHb02Luk7BFPPD3uh353EYSAOVHrMH4fte6mJGcj3vxErfSWakRUXQpovLNcqYZNxoGQ==
+#> 10                                                                                                                                                                                                                                                                                                                                                              www.example.com. A NS SOA TXT AAAA RRSIG NSEC DNSKEY
+#> 11                                                                                                                                                                                                                                                                                                                                                                                               a.iana-servers.net.
+#> 12                                                                                                                                                                                                                                                                                                                                                                                               b.iana-servers.net.
+#> 13                                                                                                                                                                                                                                                                                                                                                                                2606:2800:220:1:248:1893:25c8:1946
+#> 14                                                                                                                                                                                                                                                                                                                                                                                                     93.184.216.34
+#> 15                                                                                                                                                                                                                                                                                                                                                                                                     "v=spf1 -all"
+#> 16                                                                                                                                                                                                                                                                                                                                                             "$Id: example.com 4415 2015-08-24 20:12:23Z davids $"
+#> 17                                                                                                                                                                                                                      256 3 8 AwEAAa3d68DfyIs03nGYpi3a9YX+f/wln3g6dhWWzjUUqp6CGXuaOdEHfS8zI/5JdGKi8Xoc4YmjPGfiCJIkCiQnMKn/QFygpZs41ANLdPp2jJlJhFA6IHE/xxTCxJfNhsdEAOGlMORN9Zu1XLUBo/IuCDUvUzZPgalivd/m9L+Jr4kxbg3v
+#> 18                                              257 3 8 AwEAAZ0aqu1rJ6orJynrRfNpPmayJZoAx9Ic2/Rl9VQWLMHyjxxem3VUSoNUIFXERQbj0A9Ogp0zDM9YIccKLRd6LmWiDCt7UJQxVdD+heb5Ec4qlqGmyX9MDabkvX2NvMwsUecbYBq8oXeTT9LRmCUt9KUt/WOi6DKECxoG/bWTykrXyBR8elD+SQY43OAVjlWrVltHxgp4/rhBCvRbmdflunaPIgu27eE2U4myDSLT8a4A0rB5uHG4PkOa9dIRs9y00M2mWf4lyPee7vi5few2dbayHXmieGcaAHrx76NGAABeY393xjlmDNcUkF1gpNWUla4fWZbbaYQzA93mLdrng+M=
+#> 19                                              257 3 8 AwEAAbOFAxl+Lkt0UMglZizKEC1AxUu8zlj65KYatR5wBWMrh18TYzK/ig6Y1t5YTWCO68bynorpNu9fqNFALX7bVl9/gybA0v0EhF+dgXmoUfRX7ksMGgBvtfa2/Y9a3klXNLqkTszIQ4PEMVCjtryl19Be9/PkFeC9ITjgMRQsQhmB39eyMYnal+f3bUxKk4fq7cuEU0dbRpue4H/N6jPucXWOwiMAkTJhghqgy+o9FfIp+tR/emKao94/wpVXDcPf5B18j7xz2SvTTxiuqCzCMtsxnikZHcoh1j4g+Y1B8zIMIvrEM+pZGhh/Yuf4RwCBgaYCi9hpiMWVvS4WBzx0/lU=
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+#> 
+#> $Comment
+#> [1] "Response from 199.43.135.53"
+#> 
+#> 
query("microsoft.com", "MX")
#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>             name type
+#> 1 microsoft.com.   15
+#> 
+#> $Answer
+#>             name type TTL                                          data
+#> 1 microsoft.com.   15  74 10 microsoft-com.mail.protection.outlook.com.
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+#> 
+#> 
query("google-public-dns-a.google.com", "TXT")
#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>                              name type
+#> 1 google-public-dns-a.google.com.   16
+#> 
+#> $Answer
+#>                              name type   TTL                    data
+#> 1 google-public-dns-a.google.com.   16 21599 "http://xkcd.com/1361/"
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+#> 
+#> $Comment
+#> [1] "Response from 216.239.38.10"
+#> 
+#> 
query("apple.com")
#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>         name type
+#> 1 apple.com.    1
+#> 
+#> $Answer
+#>         name type  TTL          data
+#> 1 apple.com.    1 1002 17.172.224.47
+#> 2 apple.com.    1 1002  17.178.96.59
+#> 3 apple.com.    1 1002 17.142.160.59
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+#> 
+#> 
query("17.142.160.59", "PTR")
#> $Status
+#> [1] 0
+#> 
+#> $TC
+#> [1] FALSE
+#> 
+#> $RD
+#> [1] TRUE
+#> 
+#> $RA
+#> [1] TRUE
+#> 
+#> $AD
+#> [1] FALSE
+#> 
+#> $CD
+#> [1] FALSE
+#> 
+#> $Question
+#>                          name type
+#> 1 59.160.142.17.in-addr.arpa.   12
+#> 
+#> $Answer
+#>                           name type  TTL                           data
+#> 1  59.160.142.17.in-addr.arpa.   12 2587                     icloud.se.
+#> 2  59.160.142.17.in-addr.arpa.   12 2587                     icloud.es.
+#> 3  59.160.142.17.in-addr.arpa.   12 2587                     icloud.om.
+#> 4  59.160.142.17.in-addr.arpa.   12 2587                   icloudo.com.
+#> 5  59.160.142.17.in-addr.arpa.   12 2587                     icloud.ch.
+#> 6  59.160.142.17.in-addr.arpa.   12 2587                     icloud.fr.
+#> 7  59.160.142.17.in-addr.arpa.   12 2587                   icloude.com.
+#> 8  59.160.142.17.in-addr.arpa.   12 2587          camelspaceeffect.com.
+#> 9  59.160.142.17.in-addr.arpa.   12 2587                 camelphat.com.
+#> 10 59.160.142.17.in-addr.arpa.   12 2587              alchemysynth.com.
+#> 11 59.160.142.17.in-addr.arpa.   12 2587                    openni.org.
+#> 12 59.160.142.17.in-addr.arpa.   12 2587                      swell.am.
+#> 13 59.160.142.17.in-addr.arpa.   12 2587                  appleweb.net.
+#> 14 59.160.142.17.in-addr.arpa.   12 2587                     apple.com.
+#> 15 59.160.142.17.in-addr.arpa.   12 2587        pv-apple-com.apple.com.
+#> 16 59.160.142.17.in-addr.arpa.   12 2587                ripmixburn.com.
+#> 17 59.160.142.17.in-addr.arpa.   12 2587                   yessql.info.
+#> 18 59.160.142.17.in-addr.arpa.   12 2587               webobjects.info.
+#> 19 59.160.142.17.in-addr.arpa.   12 2587                     ubnw.info.
+#> 20 59.160.142.17.in-addr.arpa.   12 2587                 skyvines.info.
+#> 21 59.160.142.17.in-addr.arpa.   12 2587            shopdifferent.info.
+#> 22 59.160.142.17.in-addr.arpa.   12 2587                 sherlock.info.
+#> 23 59.160.142.17.in-addr.arpa.   12 2587              quicktimetv.info.
+#> 24 59.160.142.17.in-addr.arpa.   12 2587            quicktimelive.info.
+#> 25 59.160.142.17.in-addr.arpa.   12 2587                 powermac.info.
+#> 26 59.160.142.17.in-addr.arpa.   12 2587                powerbook.info.
+#> 27 59.160.142.17.in-addr.arpa.   12 2587                   macosx.info.
+#> 28 59.160.142.17.in-addr.arpa.   12 2587               appleshare.info.
+#> 29 59.160.142.17.in-addr.arpa.   12 2587              applescript.info.
+#> 30 59.160.142.17.in-addr.arpa.   12 2587         applepaysupplies.info.
+#> 31 59.160.142.17.in-addr.arpa.   12 2587 applepaymerchantsupplies.info.
+#> 32 59.160.142.17.in-addr.arpa.   12 2587                 applepay.info.
+#> 33 59.160.142.17.in-addr.arpa.   12 2587             applemasters.info.
+#> 34 59.160.142.17.in-addr.arpa.   12 2587                appleexpo.info.
+#> 35 59.160.142.17.in-addr.arpa.   12 2587         applecomputerinc.info.
+#> 36 59.160.142.17.in-addr.arpa.   12 2587              applecentre.info.
+#> 37 59.160.142.17.in-addr.arpa.   12 2587                 airtunes.info.
+#> 38 59.160.142.17.in-addr.arpa.   12 2587                      apple.by.
+#> 39 59.160.142.17.in-addr.arpa.   12 2587                 apples-msk.ru.
+#> 
+#> $Additional
+#> list()
+#> 
+#> $edns_client_subnet
+#> [1] "0.0.0.0/0"
+#> 
+#>
+
+
+
+
+ + +
+ + + diff --git a/docs/reference/spf_ipv4s.html b/docs/reference/spf_ipv4s.html new file mode 100644 index 0000000..4d2ee70 --- /dev/null +++ b/docs/reference/spf_ipv4s.html @@ -0,0 +1,107 @@ + + + + + + + + +spf_ipv4s. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+

SPF field extraction functions

+
+ +
+
+ +

Various helper functions to extract SPF record components.

+ + + 
spf_ipv4s(spf_rec)
+
+spf_ipv6s(spf_rec)
+
+spf_includes(spf_rec)
+
+spf_ptrs(spf_rec)
+
+spf_exists(spf_rec)
+ +

Arguments

+
+
spf_rec
+
a character vector of DNS TXT records
+
+
+
+
+
+ + +
+ + + diff --git a/docs/reference/split_spf.html b/docs/reference/split_spf.html new file mode 100644 index 0000000..24eddd2 --- /dev/null +++ b/docs/reference/split_spf.html @@ -0,0 +1,102 @@ + + + + + + + + +split_spf. gdns + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + +
+ +
+

Split out all SPF records in a domain's TXT record

+
+ +
+
+ +

Given a vector of TXT records, this function will return a list of vectors +of all the SPF records for each. If the given TXT record is not an SPF +record, NULL is returned (which makes it easy to skip with purrr +functions).

+ + + 
split_spf(spf_rec)
+ +

Arguments

+
+
spf_rec
+
a character vector of DNS TXT records
+
+
+
+
+
+ + +
+ + +