SARA - Ejemplos Shepp
SARA - Sistema de Administración de Recursos Automatizado
Ejemplos Shepp
1- Prerequisitos
El ISP debe estar registrado en el entorno de prueba y tener conocimientos sobre la aplicación cliente Shepp proporcionado por LACNIC o cualquier otro cliente que sea compatible con las extensiones del protocolo utilizado por LACNIC especificado en los proyectos disponibles en la biblioteca de software.
2- Secuencia de comandos
El siguiente comando debería ser ejecutado con éxito para que el ISP puede ser acreditado por LACNIC a utilizar la infraestructura del EPP. Todos los ejemplos utilizados por la aplicación cliente Shepp puede descargarse junto con la biblioteca libepp_nicbr. http://registro.br/epp/download-EN.html
2.1 Comandos básicos
2.1.1 - Conectar
El protocolo de transporte para la conexión es TCP sobre TLS como está descripto en el RFC 4934.
Ejemplo
shepp> server beta.lacnic.net:7000
shepp> connect
2.1.2 - Autenticación
Ejecute el comando login para autenticarse, también puede cambiar la clave que le fue asignado al momento de autenticarse, Ejemplo:
shepp> user 001
shepp> pw abcdef
shepp> newpw 123456
shepp> login
2.1.3 - Hello
Puede ejecutar el comando hello:
shepp> hello
2.1.4 - Logout
Para desconectarse del servidor utilice el siguiente comando:
shepp> logout
2.1.5 - Reconección
Para conectarse de vuelta al servidor utilice el siguiente comando:
shepp> connect
2.1.6 - Autenticación
Para volver a conectarse al servidor utilice el siguiente comando:
shepp> user 001
shepp> pw 123456
shepp> login
2.2- Comandos para puntos de contacto (userID)
Los comandos para puntos de contactos mencionados en esta sección están especificados en la extensión "EPP Contact" el cual puede encontrarse en el RFC 4933.
2.2.1 - Crear
Crear un nuevo contacto:
shepp> contact create JOHNDOE -postalInfo loc -name "John Doe" -street1 "Calle 1" -street2 "número 100" -street3 "Calle 2" -city "Sao Paulo" -state "SP" -pc "04578-000" -cc BR -voice 55.111234-1234 -email email@suorganizacion.com.
2.2.2 - Información
Para obtener información del contacto creado use el "handle" devuelto al momento de haber creado el userID:
shepp> contact info JOD1
2.2.3 - Actualización
Use el comando contact update para actualizar los siguientes atributos relacionados a los contactos:
- Dirección
- Número telefónico
- Correo electrónico
shepp> contact update JOD1 -postalInfo loc -street1 "Nueva calle" -street2 "número 123" -city "Rio de Janeiro" -state "RJ" -pc "12345-000" -cc BR -voice 55.1122223333 -email nuevocorreo@suorganizacion.com.
2.3 - Comando para Organizaciones (ownerID)
Los comandos utilizados en esta sección están especificados en la extensión "EPP Contact" el cual puede encontrarse en el RFC 4933.
2.3.1 - Crear
Crea una nueva Organización en el sistema, indicando un userID como contacto, creado en el paso anterior.
shepp> brorg create DUMMY -postalInfo loc -name "Nueva Organización" -street1 "Calle 1" -street2 "Número 1234" -street3 "Calle 2" -city "Sao Paulo" -state "SP" -pc "12345-000" -cc BR -voice 55.111234-1234 -email email@lacnic.net -contact admin=JOD1
2.3.2 - Información
Para obtener información del contacto creado use el "ownerID" devuelto al momento de haber creado la Organización:
shepp> brorg info BR-MNOR-LACNIC
2.3.3 - Actualización
Use el comando brorg update para actualizar los siguientes atributos relacionados a la Organización:
- Dirección
- Número telefónico
- Correo electrónico
shepp> brorg update BR-MNOR-LACNIC -postalInfo loc -street1 "New Street" -street2 "1000" -city "Rio de Janeiro" -state "RJ" -cc BR -voice 55.113333-4444 -email newmail@lacnic.net
2.4 - Comandos para Rangos de IP
2.4.1 - Verificación
Utiliza el comando ipnetwork check para verificar la disponibilidad de un rango IP. Para hacer efectiva el registro de un bloque su Organización debe poseer un rango de IP (de pruebas) asignado por Lacnic.
shepp>ipnetwork check v4=190.62.0.0-190.62.0.255
2.4.2 - Registrar
Registra una asignación de un bloque IP otorgado a una Organización el cual fue creado en el proceso anterior.
shepp> ipnetwork create c4=190.62.0.0-190.62.0.255 -o BR-MNOR-LACNIC
2.4.3 - Información
Para obtener información del registro creado utilice el siguiente comando:
shepp> ipnetwork info v4=190.62.0.0-190.62.0.255
2.4.4 - Actualización
Antes de realizar cambios sobre el registro de una asignación de IP, asegurese de haber creado una nueva Organización y un nuevo userID al cual será transferido el bloque IP.
shepp> ipnetwork update b_127291-LACNIC -o BR-ANOR-LACNIC
2.4.5 - Remoción
Para eliminar el registro de una asignación de bloque IP hecha a una Organización utilice el siguiente comando:
shepp> ipnetwork delete -roid b_127291-LACNIC
2.5 - Comandos de ASN
La Organización puede verificar y actualizar la información relacionada al ASN
2.5.1 - Info
Obten información sobre un ASN utilizando el comando asn info
shepp> asn info 1234
2.5.2 - Actualización
Use el comando asn update para actualizar o remover los contactos de un ASN
shepp> asn update 123 -add-contact routing=JOD1
-add-contact security=JOD2
-rem-contact routing=JOD1
-rem-contact security=JOD2