mirror of
https://github.com/openrdap/rdap.git
synced 2026-09-05 10:08:35 -07:00
RDAP command line client
https://www.openrdap.org
- Go 98.8%
- Roff 1.2%
b4d5927b29* fix: use cached bootstrap registry files instead of downloading Lookup() only parsed a cached Service Registry file into memory when the cache reported ShouldReload, a state only DiskCache returns. Two bugs followed from that: A caller-populated cache was ignored. MemoryCache reports Good straight after Save(), so a registry embedded with //go:embed left registries[type] nil and triggered a download that also overwrote the embedded copy. An expired file was never refreshed. Once parsed, registries[type] was non-nil and Expired was ignored, so a long lived Client served the same file forever, contrary to the documented 24 hour refresh. Load from the cache whenever nothing is parsed yet and the cached copy is usable, force a download once it expires, and fall back to the expired copy if that download fails. Registry files change rarely, so a stale copy beats a failed lookup, and this makes the "returned even if its State() is Expired" contract of both caches reachable. Fixes #54 * chore: bump go directive and update dependencies * ci: test against Go 1.26 only, matching the go.mod floor * test: assert download counts in bootstrap cache tests Both tests only checked the answer, so they passed for the wrong reasons. TestLookupUsesPrePopulatedCache would stay green if Lookup downloaded anyway, because the 404 hits the expired-copy fallback and keeps the already-loaded registry. TestLookupFallsBackToExpiredCache would stay green if the refresh attempt were skipped entirely. Assert a httpmock call delta of 0 and 1 respectively. |
||
|---|---|---|
| .github/workflows | ||
| bootstrap | ||
| cmd/rdap | ||
| sandbox | ||
| test | ||
| testdata/cli | ||
| .gitignore | ||
| .golangci.yml | ||
| autnum.go | ||
| cli.go | ||
| cli_test.go | ||
| client.go | ||
| client_error.go | ||
| client_test.go | ||
| common.go | ||
| decode_data.go | ||
| decoder.go | ||
| decoder_test.go | ||
| doc.go | ||
| domain.go | ||
| entity.go | ||
| error.go | ||
| example_test.go | ||
| go.mod | ||
| go.sum | ||
| help.go | ||
| ipnetwork.go | ||
| LICENSE | ||
| nameserver.go | ||
| print.go | ||
| print_test.go | ||
| rdap.1 | ||
| README.md | ||
| request.go | ||
| request_test.go | ||
| response.go | ||
| search_results.go | ||
| vcard.go | ||
| vcard_test.go | ||
OpenRDAP is a command line RDAP client implementation in Go.
https://www.openrdap.org - homepage
https://www.openrdap.org/demo - live demo
Features
- Command line RDAP client
- Output formats: text, JSON, WHOIS style
- Query types supported:
- ip
- domain
- autnum
- nameserver
- entity
- help
- url
- domain-search
- domain-search-by-nameserver
- domain-search-by-nameserver-ip
- nameserver-search
- nameserver-search-by-ip
- entity-search
- entity-search-by-handle
- Automatic server detection for ip/domain/autnum/entities
- Object tags support
- Bootstrap cache (optional, uses $XDG_CACHE_HOME/openrdap by default, falling back to ~/.cache/openrdap)
- X.509 client authentication
Installation
This program uses Go. The Go compiler is available from https://golang.org/.
To install:
go install github.com/openrdap/rdap/cmd/rdap@master
This will install the "rdap" binary in your $GOPATH/go/bin directory. Try running:
~/go/bin/rdap google.com
Usage
| Query type | Usage |
|---|---|
| Domain (.com) | rdap -v example.com |
| IPv4 Address | rdap -v 192.0.2.0 |
| IPv6 Address | rdap -v 2001:db8:: |
| Autonomous System (ASN) | rdap -v AS15169 |
| Entity (with object tag) | rdap -v OPS4-RIPE |
Advanced usage (server must be specified using -s; not all servers support all query types)
| Query type | Usage |
|---|---|
| Nameserver | rdap -v -t nameserver -s https://rdap.verisign.com/com/v1 ns1.google.com |
| Help | rdap -v -t help -s https://rdap.verisign.com/com/v1 |
| Domain Search | rdap -v -t domain-search -s $SERVER_URL example*.gtld |
| Domain Search (by NS) | rdap -v -t domain-search-by-nameserver -s $SERVER_URL ns1.example.gtld |
| Domain Search (by NS IP) | rdap -v -t domain-search-by-nameserver-ip -s $SERVER_URL 192.0.2.0 |
| Nameserver Search | rdap -v -t nameserver-search -s $SERVER_URL ns1.example.gtld |
| Nameserver Search (by IP) | rdap -v -t nameserver-search-by-ip -s $SERVER_URL 192.0.2.0 |
| Entity Search | rdap -v -t entity-search -s $SERVER_URL ENTITY-TAG |
| Entity Search (by handle) | rdap -v -t entity-search-by-handle -s $SERVER_URL ENTITY-TAG |
See https://www.openrdap.org/docs.
Example output
Click the examples to see the output:
rdap example.com
Domain Name: EXAMPLE.COM
Handle: 2336799_DOMAIN_COM-VRSN
Status: client delete prohibited
Status: client transfer prohibited
Status: client update prohibited
Conformance: rdap_level_0
Conformance: icann_rdap_technical_implementation_guide_0
Conformance: icann_rdap_response_profile_0
Notice:
Title: Terms of Use
Description: Service subject to Terms of Use.
Link: https://www.verisign.com/domain-names/registration-data-access-protocol/terms-service/index.xhtml
Notice:
Title: Status Codes
Description: For more information on domain status codes, please visit https://icann.org/epp
Link: https://icann.org/epp
Notice:
Title: RDDS Inaccuracy Complaint Form
Description: URL of the ICANN RDDS Inaccuracy Complaint Form: https://icann.org/wicf
Link: https://icann.org/wicf
Link: https://rdap.verisign.com/com/v1/domain/EXAMPLE.COM
Event:
Action: registration
Date: 1995-08-14T04:00:00Z
Event:
Action: expiration
Date: 2023-08-13T04:00:00Z
Event:
Action: last changed
Date: 2023-05-12T15:13:35Z
Event:
Action: last update of RDAP database
Date: 2023-05-16T20:36:06Z
Secure DNS:
Delegation Signed: true
DSData:
Key Tag: 370
Algorithm: 13
Digest: BE74359954660069D5C63D200C39F5603827D7DD02B56F120EE9F3A86764247C
DigestType: 2
Entity:
Handle: 376
Public ID:
Type: IANA Registrar ID
Identifier: 376
Role: registrar
vCard version: 4.0
vCard fn: RESERVED-Internet Assigned Numbers Authority
Entity:
Role: abuse
vCard version: 4.0
Nameserver:
Nameserver: A.IANA-SERVERS.NET
Nameserver:
Nameserver: B.IANA-SERVERS.NET
rdap 8.8.8.8
Handle: NET-8-8-8-0-1
Start Address: 8.8.8.0
End Address: 8.8.8.255
IP Version: v4
Name: LVLT-GOGL-8-8-8
Type: ALLOCATION
ParentHandle: NET-8-0-0-0-1
Status: active
Port43: whois.arin.net
Notice:
Title: Terms of Service
Description: By using the ARIN RDAP/Whois service, you are agreeing to the RDAP/Whois Terms of Use
Link: https://www.arin.net/resources/registry/whois/tou/
Notice:
Title: Whois Inaccuracy Reporting
Description: If you see inaccuracies in the results, please visit:
Link: https://www.arin.net/resources/registry/whois/inaccuracy_reporting/
Notice:
Title: Copyright Notice
Description: Copyright 1997-2023, American Registry for Internet Numbers, Ltd.
Entity:
Handle: GOGL
Port43: whois.arin.net
Remark:
Title: Registration Comments
Description: Please note that the recommended way to file abuse complaints are located in the following links.
Description: To report abuse and illegal activity: https://www.google.com/contact/
Description: For legal requests: http://support.google.com/legal
Description: Regards,
Description: The Google Team
Link: https://rdap.arin.net/registry/entity/GOGL
Link: https://whois.arin.net/rest/org/GOGL
Event:
Action: last changed
Date: 2019-10-31T15:45:45-04:00
Event:
Action: registration
Date: 2000-03-30T00:00:00-05:00
Role: registrant
vCard version: 4.0
vCard fn: Google LLC
vCard kind: org
Entity:
Handle: ABUSE5250-ARIN
Status: validated
Port43: whois.arin.net
Remark:
Title: Registration Comments
Description: Please note that the recommended way to file abuse complaints are located in the following links.
Description: To report abuse and illegal activity: https://www.google.com/contact/
Description: For legal requests: http://support.google.com/legal
Description: Regards,
Description: The Google Team
Link: https://rdap.arin.net/registry/entity/ABUSE5250-ARIN
Link: https://whois.arin.net/rest/poc/ABUSE5250-ARIN
Event:
Action: last changed
Date: 2022-10-24T08:43:11-04:00
Event:
Action: registration
Date: 2015-11-06T15:36:35-05:00
Role: abuse
vCard version: 4.0
vCard fn: Abuse
vCard org: Abuse
vCard kind: group
vCard email: network-abuse@google.com
vCard tel: +1-650-253-0000
Entity:
Handle: ZG39-ARIN
Status: validated
Port43: whois.arin.net
Link: https://rdap.arin.net/registry/entity/ZG39-ARIN
Link: https://whois.arin.net/rest/poc/ZG39-ARIN
Event:
Action: last changed
Date: 2022-11-10T07:12:44-05:00
Event:
Action: registration
Date: 2000-11-30T13:54:08-05:00
Role: technical
Role: administrative
vCard version: 4.0
vCard fn: Google LLC
vCard org: Google LLC
vCard kind: group
vCard email: arin-contact@google.com
vCard tel: +1-650-253-0000
Link: https://rdap.arin.net/registry/ip/8.8.8.0
Link: https://whois.arin.net/rest/net/NET-8-8-8-0-1
Link: https://rdap.arin.net/registry/ip/8.0.0.0/9
Event:
Action: last changed
Date: 2014-03-14T16:52:05-04:00
Event:
Action: registration
Date: 2014-03-14T16:52:05-04:00
cidr0_cidrs:
v4prefix: 8.8.8.0
length: 24
rdap --json AS15169
{
"rdapConformance": [
"nro_rdap_profile_0",
"rdap_level_0",
"nro_rdap_profile_asn_flat_0"
],
"notices": [
{
"title": "Terms of Service",
"description": [
"By using the ARIN RDAP/Whois service, you are agreeing to the RDAP/Whois Terms of Use"
],
"links": [
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "terms-of-service",
"type": "text/html",
"href": "https://www.arin.net/resources/registry/whois/tou/"
}
]
},
{
"title": "Whois Inaccuracy Reporting",
"description": [
"If you see inaccuracies in the results, please visit: "
],
"links": [
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "inaccuracy-report",
"type": "text/html",
"href": "https://www.arin.net/resources/registry/whois/inaccuracy_reporting/"
}
]
},
{
"title": "Copyright Notice",
"description": [
"Copyright 1997-2023, American Registry for Internet Numbers, Ltd."
]
}
],
"handle": "AS15169",
"startAutnum": 15169,
"endAutnum": 15169,
"name": "GOOGLE",
"events": [
{
"eventAction": "last changed",
"eventDate": "2012-02-24T09:44:34-05:00"
},
{
"eventAction": "registration",
"eventDate": "2000-03-30T00:00:00-05:00"
}
],
"links": [
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "self",
"type": "application/rdap+json",
"href": "https://rdap.arin.net/registry/autnum/15169"
},
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "alternate",
"type": "application/xml",
"href": "https://whois.arin.net/rest/asn/AS15169"
}
],
"entities": [
{
"handle": "GOGL",
"vcardArray": [
"vcard",
[
[
"version",
{},
"text",
"4.0"
],
[
"fn",
{},
"text",
"Google LLC"
],
[
"adr",
{
"label": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States"
},
"text",
[
"",
"",
"",
"",
"",
"",
""
]
],
[
"kind",
{},
"text",
"org"
]
]
],
"roles": [
"registrant"
],
"remarks": [
{
"title": "Registration Comments",
"description": [
"Please note that the recommended way to file abuse complaints are located in the following links. ",
"",
"To report abuse and illegal activity: https://www.google.com/contact/",
"",
"For legal requests: http://support.google.com/legal ",
"",
"Regards, ",
"The Google Team"
]
}
],
"links": [
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "self",
"type": "application/rdap+json",
"href": "https://rdap.arin.net/registry/entity/GOGL"
},
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "alternate",
"type": "application/xml",
"href": "https://whois.arin.net/rest/org/GOGL"
}
],
"events": [
{
"eventAction": "last changed",
"eventDate": "2019-10-31T15:45:45-04:00"
},
{
"eventAction": "registration",
"eventDate": "2000-03-30T00:00:00-05:00"
}
],
"entities": [
{
"handle": "ABUSE5250-ARIN",
"vcardArray": [
"vcard",
[
[
"version",
{},
"text",
"4.0"
],
[
"adr",
{
"label": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States"
},
"text",
[
"",
"",
"",
"",
"",
"",
""
]
],
[
"fn",
{},
"text",
"Abuse"
],
[
"org",
{},
"text",
"Abuse"
],
[
"kind",
{},
"text",
"group"
],
[
"email",
{},
"text",
"network-abuse@google.com"
],
[
"tel",
{
"type": [
"work",
"voice"
]
},
"text",
"+1-650-253-0000"
]
]
],
"roles": [
"abuse"
],
"remarks": [
{
"title": "Registration Comments",
"description": [
"Please note that the recommended way to file abuse complaints are located in the following links.",
"",
"To report abuse and illegal activity: https://www.google.com/contact/",
"",
"For legal requests: http://support.google.com/legal ",
"",
"Regards,",
"The Google Team"
]
}
],
"links": [
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "self",
"type": "application/rdap+json",
"href": "https://rdap.arin.net/registry/entity/ABUSE5250-ARIN"
},
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "alternate",
"type": "application/xml",
"href": "https://whois.arin.net/rest/poc/ABUSE5250-ARIN"
}
],
"events": [
{
"eventAction": "last changed",
"eventDate": "2022-10-24T08:43:11-04:00"
},
{
"eventAction": "registration",
"eventDate": "2015-11-06T15:36:35-05:00"
}
],
"status": [
"validated"
],
"port43": "whois.arin.net",
"objectClassName": "entity"
},
{
"handle": "ZG39-ARIN",
"vcardArray": [
"vcard",
[
[
"version",
{},
"text",
"4.0"
],
[
"adr",
{
"label": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States"
},
"text",
[
"",
"",
"",
"",
"",
"",
""
]
],
[
"fn",
{},
"text",
"Google LLC"
],
[
"org",
{},
"text",
"Google LLC"
],
[
"kind",
{},
"text",
"group"
],
[
"email",
{},
"text",
"arin-contact@google.com"
],
[
"tel",
{
"type": [
"work",
"voice"
]
},
"text",
"+1-650-253-0000"
]
]
],
"roles": [
"technical",
"administrative"
],
"links": [
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "self",
"type": "application/rdap+json",
"href": "https://rdap.arin.net/registry/entity/ZG39-ARIN"
},
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "alternate",
"type": "application/xml",
"href": "https://whois.arin.net/rest/poc/ZG39-ARIN"
}
],
"events": [
{
"eventAction": "last changed",
"eventDate": "2022-11-10T07:12:44-05:00"
},
{
"eventAction": "registration",
"eventDate": "2000-11-30T13:54:08-05:00"
}
],
"status": [
"validated"
],
"port43": "whois.arin.net",
"objectClassName": "entity"
}
],
"port43": "whois.arin.net",
"objectClassName": "entity"
},
{
"handle": "ZG39-ARIN",
"vcardArray": [
"vcard",
[
[
"version",
{},
"text",
"4.0"
],
[
"adr",
{
"label": "1600 Amphitheatre Parkway\nMountain View\nCA\n94043\nUnited States"
},
"text",
[
"",
"",
"",
"",
"",
"",
""
]
],
[
"fn",
{},
"text",
"Google LLC"
],
[
"org",
{},
"text",
"Google LLC"
],
[
"kind",
{},
"text",
"group"
],
[
"email",
{},
"text",
"arin-contact@google.com"
],
[
"tel",
{
"type": [
"work",
"voice"
]
},
"text",
"+1-650-253-0000"
]
]
],
"roles": [
"technical"
],
"links": [
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "self",
"type": "application/rdap+json",
"href": "https://rdap.arin.net/registry/entity/ZG39-ARIN"
},
{
"value": "https://rdap.arin.net/registry/autnum/15169",
"rel": "alternate",
"type": "application/xml",
"href": "https://whois.arin.net/rest/poc/ZG39-ARIN"
}
],
"events": [
{
"eventAction": "last changed",
"eventDate": "2022-11-10T07:12:44-05:00"
},
{
"eventAction": "registration",
"eventDate": "2000-11-30T13:54:08-05:00"
}
],
"status": [
"validated"
],
"port43": "whois.arin.net",
"objectClassName": "entity"
}
],
"port43": "whois.arin.net",
"status": [
"active"
],
"objectClassName": "autnum"
}
Go docs
Uses
Go 1.20+
Links
-
Wikipedia - Registration Data Access Protocol
-
ICANN - RDAP
-
https://data.iana.org/rdap/ - Official IANA bootstrap information
-
RFC 7480 HTTP Usage in the Registration Data Access Protocol (RDAP)
-
RFC 7481 Security Services for the Registration Data Access Protocol (RDAP)
-
RFC 7482 Registration Data Access Protocol (RDAP) Query Format
-
RFC 7483 JSON Responses for the Registration Data Access Protocol (RDAP)
-
RFC 7484 Finding the Authoritative Registration Data (RDAP) Service
-
RFC 8521 Registration Data Access Protocol (RDAP) Object Tagging