NICBR-EPP-2006-1 Registro.br August 2010 Procedimento de Homologacao de Provedores de Servicos EPP no Registro.br Abstract Este documento descreve o Procedimento Tecnico de Homologacao de Provedores de Servicos de Provisionamento de Nomes de Dominios .br via protocolo EPP pelo Registro.br. Registro.br [Page 1] Proc. de Homologacao EPP August 2010 Table of Contents 1. Introducao . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Sequencia de Comandos . . . . . . . . . . . . . . . . . . . . 3 2.1. Comandos Basicos . . . . . . . . . . . . . . . . . . . . . 3 2.1.1. Connect . . . . . . . . . . . . . . . . . . . . . . . 3 2.1.2. Login com mudanca de senha. . . . . . . . . . . . . . 3 2.1.3. Hello . . . . . . . . . . . . . . . . . . . . . . . . 4 2.1.4. Logout . . . . . . . . . . . . . . . . . . . . . . . . 4 2.1.5. Connect . . . . . . . . . . . . . . . . . . . . . . . 4 2.1.6. Login com a nova senha . . . . . . . . . . . . . . . . 4 2.2. Comandos de Contato . . . . . . . . . . . . . . . . . . . 4 2.2.1. Create . . . . . . . . . . . . . . . . . . . . . . . . 4 2.2.2. Info . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2.3. Update . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3. Comandos de Organizacao . . . . . . . . . . . . . . . . . 5 2.3.1. Check . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3.2. Create . . . . . . . . . . . . . . . . . . . . . . . . 6 2.3.3. Info . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.4. Comandos de Dominio . . . . . . . . . . . . . . . . . . . 6 2.4.1. Domain Check . . . . . . . . . . . . . . . . . . . . . 6 2.4.2. Domain Create . . . . . . . . . . . . . . . . . . . . 6 2.4.3. Ticket Info . . . . . . . . . . . . . . . . . . . . . 7 2.4.4. Ticket Update . . . . . . . . . . . . . . . . . . . . 7 2.5. Domain Create (dominio 2) . . . . . . . . . . . . . . . . 8 2.6. Servico de Mensageria (Poll) . . . . . . . . . . . . . . . 8 2.6.1. Poll Request . . . . . . . . . . . . . . . . . . . . . 9 2.6.2. Poll Acknowledge . . . . . . . . . . . . . . . . . . . 9 2.7. Comandos apos a criacao do dominio . . . . . . . . . . . . 9 2.7.1. Organization Update . . . . . . . . . . . . . . . . . 9 2.7.2. Organization Info . . . . . . . . . . . . . . . . . . 9 2.7.3. Domain Info . . . . . . . . . . . . . . . . . . . . . 10 2.7.4. Domain Renew . . . . . . . . . . . . . . . . . . . . . 10 2.7.5. Domain Update - Contatos . . . . . . . . . . . . . . . 10 2.7.6. Domain Update - Habilitar Renovacao Automatica . . . . 10 2.7.7. Domain Update - Desabilitar Renovacao Automatica . . . 11 2.7.8. Domain Delete . . . . . . . . . . . . . . . . . . . . 11 3. Aprovacao . . . . . . . . . . . . . . . . . . . . . . . . . . 11 4. Normative References . . . . . . . . . . . . . . . . . . . . . 11 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 12 Registro.br [Page 2] Proc. de Homologacao EPP August 2010 1. Introducao O Procedimento de Homologacao e o mecanismo atraves do qual o Registro.br pode confirmar que o provedor candidato possui uma total compreensao do protocolo EPP e do sistema de registro de dominios brasileiro. Sua sequencia de comandos abrange um universo que julgamos minimamente suficiente para cobrir todas as operacoes mais importantes que o provedor pode realizar junto ao Registro.br. Antes de iniciar o Procedimento de Homologacao o provedor deve estar devidamente cadastrado para acessar o servidor beta.registro.br. Os comandos devem ser executados na ordem apresentada e todos devem ser completados com sucesso. Os exemplos exibidos utilizam o cliente 'shepp', disbonibilizado livremente pelo Registro.br junto com a [libepp-nicbr]. O seu uso nao e obrigatorio, basta que os comandos em XML sejam enviados para o nosso servidor beta.registro.br:700 seguindo as definicoes especificadas nos drafts e RFCs que definem o protocolo EPP e suas extensoes para o modelo BR. 2. Sequencia de Comandos 2.1. Comandos Basicos 2.1.1. Connect Conectar-se ao servidor de testes usando o protocolo de transporte TCP sobre TLS como especificado em [RFC4934]. Exemplo: shepp> server beta.registro.br:700 shepp> connect 2.1.2. Login com mudanca de senha. Executar o comando EPP Login mudando a senha. Exemplo: shepp> user 001 shepp> pw abcdef shepp> newpw 123456 shepp> login Registro.br [Page 3] Proc. de Homologacao EPP August 2010 2.1.3. Hello Executar o comando EPP Hello. Exemplo: shepp> hello 2.1.4. Logout Executar o comando EPP Logout. Exemplo: shepp> logout 2.1.5. Connect Conectar-se ao servidor de testes novamente. Exemplo: shepp> connect 2.1.6. Login com a nova senha Executar o comando EPP Login com a nova senha. Exemplo: shepp> user 001 shepp> pw 123456 shepp> login 2.2. Comandos de Contato Os comandos desta secao estao especificados no Mapping de Contato EPP em [RFC4933]. 2.2.1. Create Executar o comando EPP Contact Create para criar um novo contato. Exemplo: shepp> contact create dummy -postalInfo loc -name "John Foo" -street1 "Rua Foo" -street2 "555" -street3 "AP11" -city "Sao Paulo" -state "SP" -pc "00000-000" -cc "BR" Registro.br [Page 4] Proc. de Homologacao EPP August 2010 -voice 55.1155555555 -email usuario@provedor 2.2.2. Info Executar o comando EPP Contact Info para buscar informacoes do contato criado informando o ID retornado pelo servidor. Verificar o campo "contact:id" na resposta do comando anterior. Exemplo: shepp> contact info 2.2.3. Update Executar o comando EPP Contact Update para atualizar os dados do contato recem-criado. A atualizacao deve alterar os seguintes atributos: - Endereco - Telefone - E-mail Exemplo: shepp> contact update -postalInfo loc -street1 "Rua Bar" -street2 "666" -street3 "CJ00" -voice 55.1198765432 -email other@provedor 2.3. Comandos de Organizacao Os comandos desta secao estao especificados em parte no Mapping de Contato em [RFC4933]. A outra parte faz parte da extensao do Mapping de Contato para Organizacao feita pelo Registro.br especificada em [I-D.neves-epp-brorg]. 2.3.1. Check Executar o comando EPP Contact Check extendido para Organizacao para checar a disponibilidade de provisionamento de uma determinada organizacao. Um documento deve ser especificado (CPF ou CNPJ). Exemplo: shepp> brorg check Registro.br [Page 5] Proc. de Homologacao EPP August 2010 2.3.2. Create Executar o comando EPP Contact Create extendido para Organizacao para criar a nova organizacao ou entidade como e chamada no sistema do Registro.br. Detalhe: o contato da entidade deve ser o usuario cadastrado na secao 2.2.1. Exemplo: shepp> brorg create -postalInfo loc -name "Minha Empresa" -street1 "Rua Foobar" -street2 "123" -street3 "CJ11" -city "Sao Paulo" -state "SP" -pc "00000-000" -cc BR -voice 55.55554321:2222 -email usuario@organizacao -contact admin= 2.3.3. Info Executar o comando EPP Contact Info extendido para Organizacao para buscar informacoes da organizacao criada no passo anterior. Exemplo: shepp> brorg info 2.4. Comandos de Dominio Os comandos desta secao estao especificados em parte no Mapping de Dominios [RFC4931]. A outra parte faz parte da extensao do Mapping de Nomes de Dominios feita pelo Registro.br especificada em [I-D.neves-epp-brdomain]. 2.4.1. Domain Check Executar o comando EPP Domain Check como especificado no Mapping de Dominio para checar a disponibilidade de provisionamento de um determinado nome de dominio. Exemplo: shepp> domain check 2.4.2. Domain Create Executar o comando EPP Domain Create extendido para dominios .BR. O dominio deve ser criado sem contatos e com 3 servidores DNS da seguinte forma: Registro.br [Page 6] Proc. de Homologacao EPP August 2010 - Primeiro servidor sem glue record - Segundo servidor com glue record IPv4 - Terceiro servidor com glue record IPv4 e IPv6 Os campos de endereco IPv4 e IPv6 sempre devem ser preenchidos nos casos em que o dominio do servidor DNS seja igual ou esteja contido no que esta sendo delegado. Nestes casos, o endereco IPv4 e obrigatorio e o IPv6 opcional. O campo endereco IPv6 deve ser preenchido caso o servidor possua conectividade neste protocolo. Exemplo: No caso do dominio XYZ.COM.BR delegado para os servidores FOO.XYZ.COM.BR, NS1.BAR.XYZ.COM.BR e NS1.KZX.COM.BR, para os dois primeiros servidores, o preenchimento do campo endereco IPv4 e obrigatorio e o campo endereco IPv6 opcional. Ja para o terceiro servidor, nao e necessario preencher os campos IPv4 e IPv6 e caso sejam informados, os mesmos serao descartados. Nesse passo nao e importante que os servidores DNS tenham autoridade sobre o dominio. Exemplo: shepp> domain create -ns -ns .,v4: -ns .,v4:,v6: -o 2.4.3. Ticket Info O comando anterior, se executado com sucesso, retornara um numero de ticket no campo 'brdomain:ticketNumber'. Executar o comando EPP Domain Info extendido para Ticket para buscar informacoes sobre este ticket. Exemplo: shepp> domain info -t 2.4.4. Ticket Update Executar o comando EPP Domain Update extendido para Ticket para fazer as alteracoes necessarias para resolver todas as pendencias DNS. Ao menos dois servidores de nomes devem ser fornecidos e TODOS os servidores fornecidos devem responder com autoridade sobre o dominio caso contrario o ticket sera cancelado assim que o prazo para resolver as pendencias expirar. Registro.br [Page 7] Proc. de Homologacao EPP August 2010 Exemplo: shepp> domain update -t -rem-ns . -rem-ns . -add-ns Neste momento, uma vez resolvidas todas as pendencias do ticket criado, e necessario aguardar para que o mesmo seja processado (ate 15 minutos). 2.5. Domain Create (dominio 2) Execute mais um comando Domain Create para um segundo dominio. Certifique-se via o comando Domain Check de que este nome de dominio esteja disponivel e informe ja neste momento servidores DNS que estejam respondendo com autoridade para o dominio em questao. Exemplo: shepp> domain create -ns -ns -o Neste momento, uma vez criado o ticket sem pendencias, e necessario aguardar para que o mesmo seja processado e convertido em dominio (ate 15 minutos). 2.6. Servico de Mensageria (Poll) O sistema mensageria EPP e utilizado pelo Registro.br para enviar mensagens referentes ao servico EPP ao provedor. Avisos sobre o credito do provedor ou sobre o cadastro e inativacao de tickets, por exemplo, sao exemplos de mensagens enviadas via Poll. Este sistema funciona como uma lista FIFO (first-in-first-out). Quando e executado um comando 'req' a primeira mensagem da fila (a mais antiga) e exibida. Para que a proxima mensagem da fila seja exibida, e necessario confirmar a leitura da mensagem atual enviando um comando 'ack' especificando o id da mensagem lida. A partir dai, uma nova chamada do comando 'req' mostrara a mensagem seguinte. Os comandos 'poll op="ack"' e 'poll op="req"' devem ser executados tantas vezes quanto for necessario ate zerar a fila de mensagens. Informacoes completas sobre todas as respostas do poll podem ser encontradas no documento [BR-policy-restrictions-espec]. Registro.br [Page 8] Proc. de Homologacao EPP August 2010 2.6.1. Poll Request Executar o comando EPP Poll Request para requisitar a primeira mensagem EPP da fila. Devera receber como resposta a notificacao de criacao da organizacao. Esse comando nao foi extendido e deve ser usado como especificado em [RFC4930]. Exemplo: shepp> poll req 2.6.2. Poll Acknowledge Executar o comando EPP Poll Acknowledge para confirmar a remocao da ultima mensagem EPP lida. Para tal e necessario informar o atributo 'id' dentro de 'msgQ' da mensagem recebida na resposta ao comando anterior. Exemplo: shepp> poll ack 2.7. Comandos apos a criacao do dominio 2.7.1. Organization Update Uma vez cadastrado o primeiro dominio para uma determinada entidade, ja sera possivel alterar os dados da mesma. Executar o comando EPP Contact Update extendido para Organizacao para atualizar os seguintes atributos: - Endereco - Telefone Exemplo: shepp> brorg update -postalInfo loc -street1 "Rua Barfoo" -street2 "321" -street3 "7-AND" -voice 55.1198761234 2.7.2. Organization Info Executar o comando EPP Contact Info para buscar as informacoes atualizadas da organizacao. Exemplo: Registro.br [Page 9] Proc. de Homologacao EPP August 2010 shepp> brorg info 2.7.3. Domain Info Executar o comando EPP Domain Info para checar os dados do dominio recem-criado. Exemplo: shepp> domain info 2.7.4. Domain Renew Executar o comando EPP Domain Renew para renovar o dominio por um ano a partir da data de expiracao 'domain:exDate' obtida na resposta do comando anterior. Exemplo: shepp> domain renew -expdate 2.7.5. Domain Update - Contatos Criar um novo contato e executar o comando EPP Domain Update para atualizar o contato de cobranca do dominio recem-criado. Exemplo: shepp> contact create dummy -postalInfo loc -name "Foo John" -street1 "Rua Bar" -street2 "123" -street3 "AP44" -city "Sao Paulo" -state "SP" -pc "00000-000" -cc "BR" -voice 55.1155555555 -email usuario@provedor shepp> domain update -rem-contact billing= -add-contact billing= 2.7.6. Domain Update - Habilitar Renovacao Automatica Executar o comando EPP Domain Update para habilitar a renovacao automatica do dominio. Com esta opcao habilitada o dominio sera renovado quando chegar o prazo de expiracao e o valor da manutencao sera debitado automaticamente. Exemplo: shepp> domain update -auto-renew on Registro.br [Page 10] Proc. de Homologacao EPP August 2010 2.7.7. Domain Update - Desabilitar Renovacao Automatica Executar o comando EPP Domain Update para desabilitar a renovacao automatica do dominio. Com esta opcao desabilitada, caso o provedor nao envie um comando EPP Domain Renew ate a data de expiracao do dominio, o mesmo sera congelado e em seguida removido. Exemplo: shepp> domain update -auto-renew off 2.7.8. Domain Delete Executar o comando EPP Domain Delete para excluir o segundo dominio criado anteriormente. Exemplo: shepp> domain delete No servidor em producao, e permitido o envio do comando domain:delete para uma porcentagem dos dominios registrados pelo provedor via EPP sem onus (ate 3% dos dominios registrados nos ultimos 5 dias). 3. Aprovacao O servidor EPP de testes ira logar TODOS os comandos executados pelo cliente para certificar que o teste foi completo. Para comprovar que efetuou a sequencia de comandos com sucesso o provedor de servicos devera avisar por e-mail data e hora de inicio e termino do teste, bem como o endereco IP utilizado na conexao. A analise sera feita offline e o Provedor de Servicos sera informado sobre o resultado pelo email de contato cadastrado junto ao Registro.br. 4. Normative References [RFC4930] Hollenbeck, S., "Extensible Provisioning Protocol (EPP)", RFC 4930, May 2007. [RFC4931] Hollenbeck, S., "Extensible Provisioning Protocol (EPP) Domain Name Mapping", RFC 4931, May 2007. [RFC4933] Hollenbeck, S., "Extensible Provisioning Protocol (EPP) Registro.br [Page 11] Proc. de Homologacao EPP August 2010 Contact Mapping", RFC 4933, May 2007. [RFC4934] Hollenbeck, S., "Extensible Provisioning Protocol (EPP) Transport Over TCP", RFC 4934, May 2007. [I-D.neves-epp-brdomain] Neves, F. and H. Kobayashi, "BR Domain Mapping for the Extensible Provisioning Protocol (EPP)", draft-neves-epp-brdomain-04 (work in progress), August 2010, . [I-D.neves-epp-brorg] Neves, F. and H. Kobayashi, "BR Organization Mapping for the Extensible Provisioning Protocol (EPP)", draft-neves-epp-brorg-05 (work in progress), August 2010, . [BR-policy-restrictions-espec] "Politica e restricoes do servico EPP no Registro.BR - especificacoes tecnicas", . [libepp-nicbr] "libepp-nicbr: Biblioteca para cliente EPP do NIC.br", August 2010, . Author's Address NIC.br / Registro.br Av. das Nacoes Unidas, 11541, 7 Sao Paulo, SP 04578-000 BR Phone: +55 11 5509 3511 Email: epp-suporte@registro.br URI: http://registro.br/ Registro.br [Page 12]