Abstract

Este documento descreve o Procedimento Técnico de Homologação de Provedores de Serviços de Provisionamento de Nomes de Domínios .br via protocolo EPP pelo Registro .br.

Table of Contents

1.  Pré-requisitos
2.  Sequência de Comandos
    2.1.  Comandos Básicos
        2.1.1.  Connect
        2.1.2.  Login
        2.1.3.  Hello
        2.1.4.  Logout
        2.1.5.  Connect
        2.1.6.  Login
    2.2.  Comandos de Contato
        2.2.1.  Create
        2.2.2.  Info
        2.2.3.  Update
    2.3.  Comandos de Organização
        2.3.1.  Check
        2.3.2.  Create
        2.3.3.  Info
    2.4.  Comandos de Domínio
        2.4.1.  Domain Check
        2.4.2.  Domain Create
        2.4.3.  Ticket Info
        2.4.4.  Ticket Update
        2.4.5.  Poll Request
        2.4.6.  Poll Acknowledge
        2.4.7.  Organization Update
        2.4.8.  Organization Info
        2.4.9.  Poll Request
        2.4.10.  Poll Acknowledge
        2.4.11.  Domain Info
        2.4.12.  Domain Renew
        2.4.13.  Contact Create
        2.4.14.  Domain Update - Contatos
        2.4.15.  Domain Update - Servidores de Nomes
        2.4.16.  Domain Info
        2.4.17.  Domain Update - Habilitar Renovação Automática
        2.4.18.  Domain Update - Desabilitar Renovação Automática
3.  Aprovação
4.  Normative References
§  Author's Address

1. Pré-requisitos

O Provedor de Serviços deve ter sido cadastrado para acessar o piloto. Além disso, é necessário ter domínio sobre o cliente shepp disponibilizado pelo Registro .br ou outro cliente EPP capaz de processar as extensões do Registro .br especificadas nos drafts e disponibilizadas junto com a biblioteca.

2. Sequência de Comandos

A seguir será apresentada a sequência de comandos a ser executada a fim de obter a homologação do Registro .br para se tornar Provedor de Serviços EPP. Todos os exemplos usam o cliente shepp disponível para download junto com a biblioteca libepp-nicbr.

2.1. Comandos Básicos

2.1.1. Connect

Conectar-se ao servidor de testes a partir do endereço IP fornecido no cadastramento do Provedor de Serviços, usando o protocolo de transporte TCP sobre TLS como especificado em [4] (Hollenbeck, S., “Extensible Provisioning Protocol (EPP) Transport Over TCP,” May 2007.). Exemplo:

shepp> server beta.registro.br:700

shepp> connect

2.1.2. Login

Executar o comando EPP Login mudando a senha e escolhendo idioma português. Exemplo:

shepp> user 001

shepp> pw abcdef

shepp> newpw 123456

shepp> lang pt

shepp> login

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

Executar o comando EPP Login com a nova senha e escolhendo idioma inglês. Exemplo:

shepp> user 001

shepp> pw 123456

shepp> lang en

shepp> login

2.2. Comandos de Contato

Os comandos desta seção estão especificados no Mapping de Contato EPP em [3] (Hollenbeck, S., “Extensible Provisioning Protocol (EPP) Contact Mapping,” May 2007.).

2.2.1. Create

Executar o comando EPP Contact Create para criar um novo contato. Exemplo:

contact create JOAO -postalInfo loc

-name "João dos Santos Silva"

-street1 "Rua Pio XI" -street2 "1.500" -street3 "3.Andar"

-city "São Paulo" -state "SP" -pc "05468-901" -cc BR

-voice 55.113838-4000 -email epp-piloto@registro.br

2.2.2. Info

Executar o comando EPP Contact Info para buscar informações do contato criado no passo anterior usando os dados obtidos na resposta do comando anterior. Exemplo:

shepp> contact info JDSSI

2.2.3. Update

Executar o comando EPP Contact Update para atualizar os dados do contato recém-criado. A atualização deve alterar os seguintes atributos:

-

Endereço

-

Telefone

-

Email

Exemplo:

shepp> contact update JDSSI -postalInfo loc

-street1 "Av. Nacoes Unidas" -street2 "11541"

-street3 "7 andar" -city "Sao Paulo" -state "SP"

-pc "04578-000" -cc BR -voice 55.1155093500

-email epp-suporte@registro.br

2.3. Comandos de Organização

Os comandos desta seção estão especificados em parte no Mapping de Contato em [3] (Hollenbeck, S., “Extensible Provisioning Protocol (EPP) Contact Mapping,” May 2007.). A outra parte faz parte da extensão do Mapping de Contato para Organização feita pelo Registro .br especificada em [6] (Neves, F. and H. Kobayashi, “BR Organization Mapping for the Extensible Provisioning Protocol (EPP),” August 2006.).

2.3.1. Check

Executar o comando EPP Contact Check extendido para Organização para checar a disponibilidade de provisionamento de uma determinada organização. Exemplo:

shepp> brorg check 005.506.560/0001-36

2.3.2. Create

Executar o comando EPP Contact Create extendido para Organização para criar a nova organização ou entidade como é chamada no sistema do Registro .br. Detalhe: o contato da entidade deve ser o usuário cadastrado na seção 2.2.1. Exemplo:

shepp> brorg create 005.506.560/0001-36 -postalInfo loc

-name "Núcleo de Informação e Coordenação do Ponto BR"

-street1 "Av. Nações Unidas" -street2 "11541"

-street3 "7 andar" -city "Sao Paulo" -state "SP"

-pc "04578-000" -cc BR -voice 55.1155093500:3500

-email epp-piloto@registro.br -contact admin=JDSSI

2.3.3. Info

Executar o comando EPP Contact Info extendido para Organização para buscar informações da organização criada no passo anterior. Exemplo:

shepp> brorg info 005.506.560/0001-36

2.4. Comandos de Domínio

Os comandos desta seção estão especificados em parte no Mapping de Domínios [2] (Hollenbeck, S., “Extensible Provisioning Protocol (EPP) Domain Name Mapping,” May 2007.). A outra parte faz parte da extensão do Mapping de Nomes de Domínios feita pelo Registro .br especificada em [5] (Neves, F. and H. Kobayashi, “BR Domain Mapping for the Extensible Provisioning Protocol (EPP),” August 2006.).

2.4.1. Domain Check

Executar o comando EPP Domain Check como especificado no Mapping de Domínio para checar a disponibilidade de provisionamento de um determinado nome de domínio. Exemplo:

shepp> domain check dns.br

2.4.2. Domain Create

Executar o comando EPP Domain Create extendido para domínios .BR. O domínio deve ser criado sem contatos e com cinco servidores DNS da seguinte forma:

-

Primeiro servidor com glue record v4 e v6

-

Segundo servidor com glue record v4

-

Terceiro servidor sem glue record

-

Quarto servidor com glue record v4

-

Quinto servidor com glue record v4 e v6

Nesse passo não é importante que os servidores DNS tenham autoridade sobre o domínio. Exemplo:

shepp> domain create dns.br

-ns a.dns.br,v4:200.160.0.10,v6:2001:12ff::10

-ns b.dns.br,v4:200.209.30.5

-ns c.nic.br

-ns d.dns.br,v4:204.152.184.70

-ns e.dns.br,v4:139.91.1.20,v6::139.91.1.20

-o 005.506.560/0001-36

2.4.3. Ticket Info

Executar o comando EPP Domain Info extendido para Ticket para buscar informações do ticket criado no passo anterior. Para executar este comando é preciso usar o número do ticket obtido na resposta do comando create. Exemplo:

shepp> domain info dns.br -t 2822346

2.4.4. Ticket Update

Executar o comando EPP Domain Update extendido para Ticket para fazer as alterações necessárias para resolver todas as pendências DNS. Ao menos dois servidores de nomes devem ser fornecidos e TODOS os servidores fornecidos devem responder com autoridade sobre o domínio caso contrário o ticket será cancelado assim que o prazo para resolver as pendências expirar. Exemplo:

shepp> domain update dns.br -t 2822346 -rem-ns c.dns.br

-rem-ns d.dns.br -add-ns f.dns.br

Pausa para o processamento offline do comando EPP Domain Create (15min)

2.4.5. Poll Request

Executar o comando EPP Poll Request para requisitar a primeira mensagem EPP da fila. Deverá receber como resposta a notificação de criação da organização. Esse comando não foi extendido e deve ser usado como especificado em [1] (Hollenbeck, S., “Extensible Provisioning Protocol (EPP),” May 2007.). Exemplo:

shepp> poll req

2.4.6. Poll Acknowledge

Executar o comando EPP Poll Acknowledge para confirmar a remoção da última mensagem EPP lida. Esse comando também não foi extendido e deve ser usado como especificado em [1] (Hollenbeck, S., “Extensible Provisioning Protocol (EPP),” May 2007.). Exemplo:

shepp> poll ack 1

2.4.7. Organization Update

Executar o comando EPP Contact Update extendido para Organização para atualizar os seguintes atributos:

-

Endereço

-

Telefone

-

Email

Exemplo:

shepp> brorg update 005.506.560/0001-36 -postalInfo loc

-name "NIC BR"

-street1 "Rua Pio XI" -street2 "1500"

-street3 "3 andar" -city "Sao Paulo" -state "SP"

-pc "05468-901" -cc BR -voice 55.113838-4000-4072

-email epp@registro.br

2.4.8. Organization Info

Executar o comando EPP Contact Info para buscar as informações atualizadas da organização. Exemplo:

shepp> brorg info 005.506.560/0001-36

2.4.9. Poll Request

Executar o comando EPP Poll Request novamente para requisitar a próxima mensagem EPP da fila de mensagens. Deverá receber como resposta a notificação de criação do domínio. Exemplo:

shepp> poll req

2.4.10. Poll Acknowledge

Executar o comando EPP Poll Acknowledge para confirmar a remoção da última mensagem EPP lida.

shepp> poll ack 2

2.4.11. Domain Info

Executar o comando EPP Domain Info para checar os dados do domínio recém-criado.

shepp> domain info dns.br

2.4.12. Domain Renew

Executar o comando EPP Domain Renew para renovar o domínio por um ano a partir da data de expiração obtida na resposta do comando anterior. Entretanto este domínio não possui pendências de pagamento em aberto por isso não será possível efetuar a renovação. Neste caso, uma mensagem de erro: "Nenhuma pendência de pagamento encontrada para este domínio" é a resposta esperada.

shepp> domain renew dns.br -expdate 2007-06-08T20:42:16.0Z

2.4.13. Contact Create

Executar o comando EPP Contact Create para criar três novos contatos para serem os contatos administrativo, técnico e cobrança do domínio recém-criado. Quando os contatos não são fornecidos durante a criação do domínio, todos os contatos do domínio passam a ser o contato da organização detentora do domínio.

2.4.14. Domain Update - Contatos

Executar o comando EPP Domain Update para atualizar os três contatos para serem os contatos administrativo, técnico e cobrança do domínio recém-criado.

shepp> domain update dns.br -rem-contact admin=JDSSI -add-contact admin=MICCA -rem-contact tech=JDSSI -add-contact tech=EDSZT -rem-contact billing=JDSSI -add-contact billing=CAMOR

2.4.15. Domain Update - Servidores de Nomes

Executar o comando EPP Domain Update para atualizar os servidores de nomes do domínio criado. Alterar pelo menos dois servidores de nomes.

shepp> domain update dns.br

-rem-ns b.dns.br -add-ns foo.eng.br

-rem-ns c.dns.br -add-ns fork.foo.eng.br

2.4.16. Domain Info

Executar o comando EPP Domain Info para verificar as alterações.

shepp> domain info dns.br

2.4.17. Domain Update - Habilitar Renovação Automática

Executar o comando EPP Domain Update para habilitar a renovação automática do domínio. Com esta opção habilitada o domínio será renovado quando chegar o prazo de expiração e o valor da manutenção será debitado automaticamente.

shepp> domain update dns.br -auto-renew on

2.4.18. Domain Update - Desabilitar Renovação Automática

Executar o comando EPP Domain Update para desabilitar a renovação automática do domínio. Com esta opção desabilitada o domínio será cancelado quando chegar o prazo de expiração se o provedor de serviços não enviar um comando EPP Domain Renew antes do prazo limite.

shepp> domain update dns.br -auto-renew off

3. Aprovação

O servidor EPP de testes irá logar TODOS os comandos executados pelo cliente para certificar que o teste foi completo.

Para comprovar que efetuou a sequência de comandos com sucesso o provedor de serviços deverá fornecer a data e hora de início e término do teste.

A análise será feita offline e o Provedor de Serviços será informado sobre o resultado pelo email de contato cadastrado junto ao Registro.br.

4. Normative References

Author's Address