/ 
Net-RDAP-0.33
River stage one • 2 direct dependents • 2 total dependents
/ Net::RDAP::Registry

NAME

Net::RDAP::Registry - a module which provides an interface to the IANA RDAP registries.

SYNOPSIS

use Net::RDAP::Registry;
use Net::IP;
use Net::ASN;

$url = Net::RDAP::Registry->get_url(Net::DNS::Domain->new('example.com'));
$url = Net::RDAP::Registry->get_url(Net::IP->new('192.168.0.1'));
$url = Net::RDAP::Registry->get_url(Net::IP->new('2001:DB8::/32'));
$url = Net::RDAP::Registry->get_url(Net::ASN->new(65536));
$url = Net::RDAP::Registry->get_url('ABC123-TAG');

DESCRIPTION

RFC 7484 describes how RDAP clients can find the authoritative RDAP service for a given internet resource using one of several IANA registries.

This module provides an interface to these registries, and will return a URI object corresponding to the URL for a resource obtained from them.

Net::RDAP::Registry downloads the registry files from the IANA website and will maintain up-to-date copies of those files locally.

METHODS

$url = Net::RDAP::Registry->get_url($resource);

This method returns a URI object corresponding to the authoritative RDAP URL for the given resource. $resource may be one of the following:

  • a Net::IP object representing an IPv4 or IPv6 address or address range;

  • a Net::ASN object representing an Autonymous System;

  • a Net::DNS::Domain object representing a domain name.

  • a string containing a tagged entity handle

This method requires objects to be passed to ensure that the resource identifiers have been properly validated.

If no URL can be found in the IANA registry, then undef is returned.

COPYRIGHT

Copyright 2018-2023 CentralNic Ltd, 2024 Gavin Brown. For licensing information, please see the LICENSE file in the Net::RDAP distribution.