| Net-DRI documentation | Contained in the Net-DRI distribution. |
Net::DRI::Protocol::EPP::Extensions::EURid::Domain - EURid EPP Domain extension commands for Net::DRI
Please see the README file for details.
For now, support questions should be sent to:
<netdri@dotandco.com>
Please also see the SUPPORT file in the distribution.
<http://www.dotandco.com/services/software/Net-DRI/>
Patrick Mevzek, <netdri@dotandco.com>
Copyright (c) 2005-2010 Patrick Mevzek <netdri@dotandco.com>. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
See the LICENSE file that comes with this distribution for more details.
| Net-DRI documentation | Contained in the Net-DRI distribution. |
## Domain Registry Interface, EURid Domain EPP extension commands ## (based on EURid registration_guidelines_v1_0E-epp.pdf) ## ## Copyright (c) 2005-2010 Patrick Mevzek <netdri@dotandco.com>. All rights reserved. ## ## This file is part of Net::DRI ## ## Net::DRI is free software; you can redistribute it and/or modify ## it under the terms of the GNU General Public License as published by ## the Free Software Foundation; either version 2 of the License, or ## (at your option) any later version. ## ## See the LICENSE file that comes with this distribution for more details. # # # #################################################################################################### package Net::DRI::Protocol::EPP::Extensions::EURid::Domain; use strict; use warnings; use Net::DRI::Util; use Net::DRI::Exception; use Net::DRI::Protocol::EPP::Util; our $VERSION=do { my @r=(q$Revision: 1.15 $=~/\d+/g); sprintf("%d".".%02d" x $#r, @r); };
#################################################################################################### sub register_commands { my ($class,$version)=@_; my %tmp=( create => [ \&create, undef ], update => [ \&update, undef ], info => [ \&info, \&info_parse ], check => [ \&check, \&check_parse ], delete => [ \&delete, undef ], transfer_request => [ \&transfer_request, undef ], transfer_cancel => [ \&transfer_cancel, undef ], undelete => [ \&undelete, undef ], transferq_request => [ \&transferq_request, undef ], transferq_cancel => [ \&transferq_cancel, undef ], trade_request => [ \&trade_request, undef ], trade_cancel => [ \&trade_cancel, undef ], reactivate => [ \&reactivate, undef ], check_contact_for_transfer => [ \&checkcontact, \&checkcontact_parse ], remind => [ \&remind, undef ], ); return { 'domain' => \%tmp }; } #################################################################################################### sub build_command_extension { my ($mes,$epp,$tag)=@_; return $mes->command_extension_register($tag,sprintf('xmlns:eurid="%s" xsi:schemaLocation="%s %s"',$mes->nsattrs('eurid'))); } sub create { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); return unless Net::DRI::Util::has_key($rd,'nsgroup'); my @n=add_nsgroup($rd->{nsgroup}); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:create',['eurid:domain',@n]]); } sub update { my ($epp,$domain,$todo)=@_; my $mes=$epp->message(); if (grep { ! /^(?:add|del)$/ } $todo->types('nsgroup')) { Net::DRI::Exception->die(0,'protocol/EPP',11,'Only nsgroup add/del available for domain'); } my $nsgadd=$todo->add('nsgroup'); my $nsgdel=$todo->del('nsgroup'); return unless ($nsgadd || $nsgdel); my @n; push @n,['eurid:add',add_nsgroup($nsgadd)] if $nsgadd; push @n,['eurid:rem',add_nsgroup($nsgdel)] if $nsgdel; my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:update',['eurid:domain',@n]]); } sub info { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:info',['eurid:domain',{version=>'2.0'}]]); } sub info_parse { my ($po,$otype,$oaction,$oname,$rinfo)=@_; my $mes=$po->message(); return unless $mes->is_success(); my $infdata=$mes->get_extension('eurid','ext'); return unless defined $infdata; my $ns=$mes->ns('eurid'); $infdata=Net::DRI::Util::xml_traverse($infdata,$ns,'infData','domain'); return unless defined $infdata; my @c; foreach my $el ($infdata->getChildrenByTagNameNS($ns,'nsgroup')) { push @c,$po->create_local_object('hosts')->name($el->textContent()); } $rinfo->{domain}->{$oname}->{nsgroup}=\@c; my $cs=$rinfo->{domain}->{$oname}->{status}; foreach my $s (qw/onhold quarantined/) ## onhold here has nothing to do with EPP client|serverHold, unfortunately { my @s=$infdata->getChildrenByTagNameNS($ns,$s); next unless @s; $cs->add($s) if Net::DRI::Util::xml_parse_boolean($s[0]->textContent()); ## should we also remove 'ok' status then ? } foreach my $d (qw/availableDate deletionDate/) { my @d=$infdata->getChildrenByTagNameNS($ns,$d); next unless @d; $rinfo->{domain}->{$oname}->{$d}=$po->parse_iso8601($d[0]->textContent()); } my $pt=$infdata->getChildrenByTagNameNS($ns,'pendingTransaction'); if ($pt->size()) { $pt=$pt->shift(); my %p; foreach my $t (qw/trade transfer transferq/) { my $r=$pt->getChildrenByTagNameNS($ns,$t); next unless $r->size(); $p{type}=$t; $cs->add(($t eq 'trade')? 'pendingUpdate' : 'pendingTransfer'); foreach my $el (Net::DRI::Util::xml_list_children($r->get_node(1))) { my ($name,$c)=@$el; if ($name eq 'domain') { my $cs2=$po->create_local_object('contactset'); foreach my $sel (Net::DRI::Util::xml_list_children($c)) { my ($name2,$cc)=@$sel; if ($name2=~m/^(registrant|tech|billing)$/) { $cs2->set($po->create_local_object('contact')->srid($cc->textContent()),$name2); } elsif ($name2=~m/^(trDate)$/) { $p{$1}=$po->parse_iso8601($cc->textContent()); } } $p{contact}=$cs2; } elsif ($name=~m/^(initiationDate|unscreenedFax)$/) { $p{$1}=$po->parse_iso8601($c->textContent()); } elsif ($name=~m/^(status|replySeller|replyBuyer|replyOwner)$/) { $p{$1}=$c->textContent(); } } last; } $rinfo->{domain}->{$oname}->{pending_transaction}=\%p; } } sub check { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:check',['eurid:domain',{version=>'2.0'}]]); } sub check_parse { my ($po,$otype,$oaction,$oname,$rinfo)=@_; my $mes=$po->message(); return unless $mes->is_success(); my $chkdata=$mes->get_extension('eurid','ext'); return unless defined $chkdata; my $ns=$mes->ns('eurid'); $chkdata=Net::DRI::Util::xml_traverse($chkdata,$ns,'chkData','domain'); return unless defined $chkdata; foreach my $cd ($chkdata->getChildrenByTagNameNS($ns,'cd')) { my $domain; foreach my $el (Net::DRI::Util::xml_list_children($cd)) { my ($n,$c)=@$el; if ($n eq 'name') { $domain=lc($c->textContent()); $rinfo->{domain}->{$domain}->{action}='check'; foreach my $ef (qw/accepted expired initial rejected/) ## only for domain applications { next unless $c->hasAttribute($ef); $rinfo->{domain}->{$domain}->{'application_'.$ef}=Net::DRI::Util::xml_parse_boolean($c->getAttribute($ef)); } } elsif ($n eq 'availableDate') { $rinfo->{domain}->{$domain}->{availableDate}=$po->parse_iso8601($c->textContent()); } } } } sub delete { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); return unless (exists $rd->{deleteDate} && $rd->{deleteDate}); Net::DRI::Util::check_isa($rd->{deleteDate},'DateTime'); my $eid=build_command_extension($mes,$epp,'eurid:ext'); my @n=(['eurid:deleteDate',$rd->{deleteDate}->set_time_zone('UTC')->strftime('%Y-%m-%dT%T.%NZ')]); push @n,['eurid:overwriteDeleteDate','true'] if Net::DRI::Util::has_key($rd,'overwrite') && $rd->{overwrite}; $mes->command_extension($eid,['eurid:delete',['eurid:domain',@n]]); } sub transfer_request { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); my @n=(['eurid:domain',add_transfer($epp,$mes,$domain,$rd)]); push @n,['eurid:ownerAuthCode',$rd->{owner_auth_code}] if (Net::DRI::Util::has_key($rd,'owner_auth_code') && $rd->{owner_auth_code}=~m/^\d{15}$/); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:transfer',@n]); } sub transfer_cancel { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); Net::DRI::Exception::usererr_insufficient_parameters('reason is mandatory for transfer_cancel') unless (Net::DRI::Util::has_key($rd,'reason') && $rd->{reason}); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:cancel',['eurid:reason',$rd->{reason}]]); } sub add_transfer { my ($epp,$mes,$domain,$rd)=@_; Net::DRI::Exception::usererr_insufficient_parameters('registrant and billing are mandatory') unless (Net::DRI::Util::has_contact($rd) && $rd->{contact}->has_type('registrant') && $rd->{contact}->has_type('billing')); my $cs=$rd->{contact}; my @n; my $creg=$cs->get('registrant'); Net::DRI::Exception::usererr_invalid_parameters('registrant must be a contact object or the string #AUTO#') unless (Net::DRI::Util::isa_contact($creg,'Net::DRI::Data::Contact::EURid') || (!ref($creg) && (uc($creg) eq '#AUTO#'))); push @n,['eurid:registrant',ref($creg)? $creg->srid() : '#AUTO#' ]; if (exists($rd->{trDate})) { Net::DRI::Util::check_isa($rd->{trDate},'DateTime'); push @n,['eurid:trDate',$rd->{trDate}->set_time_zone('UTC')->strftime('%Y-%m-%dT%T.%NZ')]; } my $cbill=$cs->get('billing'); Net::DRI::Exception::usererr_invalid_parameters('billing must be a contact object') unless Net::DRI::Util::isa_contact($cbill,'Net::DRI::Data::Contact::EURid'); push @n,['eurid:billing',$cbill->srid()]; push @n,add_contact('tech',$cs,9) if $cs->has_type('tech'); push @n,add_contact('onsite',$cs,5) if $cs->has_type('onsite'); if (Net::DRI::Util::has_ns($rd)) { my $n=Net::DRI::Protocol::EPP::Util::build_ns($epp,$rd->{ns},$domain,'eurid'); my @ns=$mes->nsattrs('domain'); push @$n,{'xmlns:domain'=>shift(@ns),'xsi:schemaLocation'=>sprintf('%s %s',@ns)}; push @n,$n; } push @n,add_nsgroup($rd->{nsgroup}) if Net::DRI::Util::has_key($rd,'nsgroup'); return @n; } sub add_nsgroup { my ($nsg)=@_; return unless (defined($nsg) && $nsg); my @a=grep { defined($_) && $_ && !ref($_) && Net::DRI::Util::xml_is_normalizedstring($_,1,100) } map { Net::DRI::Util::isa_nsgroup($_)? $_->name() : $_ } (ref($nsg) eq 'ARRAY')? @$nsg : ($nsg); return map { ['eurid:nsgroup',$_] } grep {defined} @a[0..8]; } sub add_contact { my ($type,$cs,$max)=@_; $max--; my @r=grep { Net::DRI::Util::isa_contact($_,'Net::DRI::Data::Contact::EURid') } ($cs->get($type)); return map { ['eurid:'.$type,$_->srid()] } grep {defined} @r[0..$max]; } sub undelete { my ($epp,$domain)=@_; my $mes=$epp->message(); my @d=Net::DRI::Protocol::EPP::Util::domain_build_command($mes,'undelete',$domain); $mes->command_body(\@d); } sub transferq_request { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); my @d=Net::DRI::Protocol::EPP::Util::domain_build_command($mes,['transferq',{'op'=>'request'}],$domain); push @d,Net::DRI::Protocol::EPP::Util::build_period($rd->{duration}) if Net::DRI::Util::has_duration($rd); $mes->command_body(\@d); my @n=add_transfer($epp,$mes,$domain,$rd); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:transferq',['eurid:domain',@n]]); } sub transferq_cancel { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); my @d=Net::DRI::Protocol::EPP::Util::domain_build_command($mes,['transferq',{'op'=>'cancel'}],$domain); $mes->command_body(\@d); Net::DRI::Exception::usererr_insufficient_parameters('reason is mandatory for transferq_cancel') unless (Net::DRI::Util::has_key($rd,'reason') && $rd->{reason}); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:cancel',['eurid:reason',$rd->{reason}]]); } sub trade_request { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); my @d=Net::DRI::Protocol::EPP::Util::domain_build_command($mes,['trade',{'op'=>'request'}],$domain); $mes->command_body(\@d); my @n=add_transfer($epp,$mes,$domain,$rd); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:trade',['eurid:domain',@n]]); } sub trade_cancel { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); my @d=Net::DRI::Protocol::EPP::Util::domain_build_command($mes,['trade',{'op'=>'cancel'}],$domain); $mes->command_body(\@d); Net::DRI::Exception::usererr_insufficient_parameters('reason is mandatory for trade_cancel') unless (Net::DRI::Util::has_key($rd,'reason') && $rd->{reason}); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:cancel',['eurid:reason',$rd->{reason}]]); } sub reactivate { my ($epp,$domain)=@_; my $mes=$epp->message(); my @d=Net::DRI::Protocol::EPP::Util::domain_build_command($mes,'reactivate',$domain); $mes->command_body(\@d); } sub checkcontact { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); Net::DRI::Exception->die(1,'protocol/EPP',2,'Domain name needed') unless defined($domain) && $domain; Net::DRI::Exception->die(1,'protocol/EPP',10,'Invalid domain name: '.$domain) unless Net::DRI::Util::is_hostname($domain); my @d=(['eurid:domainName',$domain]); Net::DRI::Exception::usererr_insufficient_parameters('registrant key is mandatory for check_contact_for_transfer') unless Net::DRI::Util::has_key($rd,'registrant'); Net::DRI::Exception::usererr_invalid_parameters('registrant must be a contact object') unless Net::DRI::Util::isa_contact($rd->{registrant},'Net::DRI::Data::Contact::EURid'); push @d,['eurid:registrant',$rd->{registrant}->srid()]; my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:command',['eurid:checkContactForTransfer',@d]]); } sub checkcontact_parse { my ($po,$otype,$oaction,$oname,$rinfo)=@_; my $mes=$po->message(); return unless $mes->is_success(); my $chkdata=$mes->get_extension('eurid','ext'); return unless defined $chkdata; my $ns=$mes->ns('eurid'); $chkdata=Net::DRI::Util::xml_traverse($chkdata,$ns,'response','checkContactForTransfer'); return unless defined $chkdata; my $p=Net::DRI::Util::xml_child_content($chkdata,$ns,'percentage'); $rinfo->{domain}->{$oname}->{'percentage'}=$p if defined $p; } sub remind { my ($epp,$domain,$rd)=@_; my $mes=$epp->message(); Net::DRI::Exception->die(1,'protocol/EPP',2,'Domain name needed') unless defined($domain) && $domain; Net::DRI::Exception->die(1,'protocol/EPP',10,'Invalid domain name: '.$domain) unless Net::DRI::Util::is_hostname($domain); Net::DRI::Exception::usererr_insufficient_parameters('destination is mandatory for trade_cancel') unless (Net::DRI::Util::has_key($rd,'destination') && length $rd->{destination}); Net::DRI::Exception::usererr_invalid_parameters('destination must be either owner or buyer') unless ($rd->{destination} eq 'owner' || $rd->{destination} eq 'buyer'); my $eid=build_command_extension($mes,$epp,'eurid:ext'); $mes->command_extension($eid,['eurid:command',['eurid:transferRemind',['eurid:domainname',$domain],['eurid:destination',$rd->{destination}]],['eurid:clTRID',$mes->cltrid()]]); } #################################################################################################### 1;