README.md 1.7 KB
Newer Older
Gavin Brown's avatar
Gavin Brown committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
# NAME

`rdap-conformance` - a script to validate the conformance of an RDAP server.

# DESCRIPTION

`rdap-conformance` provides a report of the conformance of an RDAP server to
the RDAP profile for generic top-level domains. It tests the responses from
an RDAP server against the requirements published by ICANN.

# USAGE

        rdap-conformance OPTIONS URL

# OPTIONS

- `--handle=HANDLE` - explicitly specify handle. If not provided, this is
Gavin Brown's avatar
updated  
Gavin Brown committed
18 19 20 21 22 23 24 25 26 27
derived from the last path segment of the URL.
- `--type=TYPE` - specify response type, must be one of `domain`,
`entity`, `nameserver`, or `help`. If not provided, this is
derived from the last-but-one path segment of the URL.
- `--nameserver=SERVE` - specify a nameserver to use. In order to perform
DNSSEC-related tests, the server SHOULD be a validating resolver.
- `--proxy=URL` - specify proxy to be used. If [LWP::Protocol::socks](https://metacpan.org/pod/LWP::Protocol::socks) is
installed you can use a SOCKS proxy by givin the URL the `socks://` scheme.
- `--debug` - enable debug mode (i.e. print HTTP and DNS requests and
responsees).
Gavin Brown's avatar
Gavin Brown committed
28 29
- `--disable-cache` - bypass [Net::RDAP](https://metacpan.org/pod/Net::RDAP)'s built-in cache and always
query the server directly.
Gavin Brown's avatar
updated  
Gavin Brown committed
30
- `--help` - show this help.
Gavin Brown's avatar
Gavin Brown committed
31

32 33 34 35 36
# DEPENDENCIES

This script needs `ssllabs-scan` to do TLS configuration checks, and `dnsviz`
to do DNSSEC validation. On MacOS, these can be installed using `homebrew`.

Gavin Brown's avatar
Gavin Brown committed
37 38 39 40 41 42 43 44 45
# COPYRIGHT

Copyright 2018 CentralNic Ltd. This program is free software, you can
use it and/or modify it under the same terms as Perl itself.

# SEE ALSO

- [https://www.icann.org/rdap](https://www.icann.org/rdap) - the RDAP information page on the ICANN website
- [Net::RDAP](https://metacpan.org/pod/Net::RDAP)