SARA - Shepp Examples

1. Prerequisites

It is expected that the ISP is registered on the test environment and has knowledge on the shepp client application, provided by Lacnic, or any other client that is compatible with the protocol extensions used by Lacnic, specified on the drafts available with the software library.

Also, the ISP must first be registered with Lacnic in order to get access to the test server and have an IP range allocated for testing.

The document LACNIC EPP Policy and Restrictions for ISPs should be read before using this EPP client.

2. Command Sequence

The following command should be executed successfully so that the ISP can become accredited by Lacnic to use the EPP infrastructure. All the examples use the shepp client application, which can be downloaded along with the libepp_nicbr library.

2.1. Basic Commands

2.1.1. Connect

The transport protocol for the connection is TCP over TLS, as described in [RFC 4934].


<br /> <br /> shepp> server shepp> connect

2.1.2. Login

Execute the login command, also changing the provided password to a another one chosen by the user.


shepp> user 001 shepp> pw abcdef shepp> newpw 123456 shepp> login

2.1.3. Hello

Execute the hello command. Example:

shepp> hello

2.1.4. Logout

Log out from the server. Example:

shepp> logout

2.1.5. Connect

Connect to the server again:

shepp> connect

2.1.6. Login

Log back into the server:

shepp> user 001 shepp> pw 123456 shepp> login

2.2. Contact Commands

The contact-related commands discussed in this section are specified by the EPP Contact extension, which can be found at [RFC 4933].

2.2.1. Create

Create a new contact:

shepp> contact create JOHNDOE -postalInfo loc -name "John Doe" -street1 "Main Street" -street2 "100" -street3 "13th floor" -city "Sao Paulo" -state "SP" -pc "04578-000" -cc BR -voice 55.111234-1234 -email

2.2.2. Info

Get info on the contact just created, using the handle returned from the previous command:

shepp> contact info JOD1

2.2.3. Update

Use the contact update command to update the following attributes on the newly created contact:

  • Address
  • Telephone number
  • Email address

shepp> contact update JOD1 -postalInfo loc -street1 "New Street" -street2 "123" -city "Rio de Janeiro" -state "RJ" -pc "12345-000" -cc BR -voice 55.1122223333 -email

2.2.4. Info

Get the new, updated info on the contact:

shepp> contact info JOD1

2.3. Organization Commands

The organization commands used in this section are partly specified in the EPP Contact extension, describe in [RFC 4933]. The other part is described in the Organization extension made by, which can be found at [I-D.neves-epp-brorg].

2.3.1. Create

Create a new organization on the system, having the user created in the previous section as this organization's contact.

shepp> brorg create DUMMY -postalInfo loc -name "My new organization" -street1 "Main Street" -street2 "1234" -street3 "13th floor" -city "Sao Paulo" -state "SP" -pc "12345-000" -cc BR -voice 55.111234-1234 -email -contact admin=JOD1

2.3.2. Info

Get the info on the newly created organization, using the organization ID that is returned on the creation command:

shepp> brorg info BR-MNOR-LACNIC

2.3.3. Update

Use the brorg update command to change the following attributes on the newly created organization:

  • Address
  • Telephone number
  • Email address

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

2.3.4. Info

Get the updated info on the organization:

shepp> brorg info BR-MNOR-LACNIC

2.4. IP Range Commands

2.4.1. Check

Use the ipnetwork check command to check the availability of a certain IP range. For the range to be available, it must inside the IP range that was allocated to the ISP for testing purposes.

shepp> ipnetwork check v4=

2.4.2. Create

Create a new assignment of an IP range to the organization created previously with the ipnetwork create command

shepp> ipnetwork create v4= -o BR-MNOR-LACNIC

2.4.3. Info

Get the information on the IP range just created using the ipnetwork info command

shepp> ipnetwork info v4=

2.4.4. Update

Before doing changes in the IP range, with the ipnetwork update command, create another organization that will receive the range:

shepp> brorg create DUMMY -postalInfo loc -name "Another organization" -street1 "Main Street" -street2 "1234" -city "Sao Paulo" -state "SP" -pc "12345-000" -cc BR -voice 55.111234-1234 -email -contact admin=JOD1

Then, use the ipnetwork update command to assign the IP range to this last organization:

shepp> ipnetwork update b_127291-LACNIC -o BR-ANOR-LACNIC

2.4.5. Info

Run the info command once again to see the changes in the IP range

shepp> ipnetwork info v4=

2.4.6. Delete

Finally, remove the IP range with the ipnetwork delete command:

shepp> ipnetwork delete -roid b_127291-LACNIC The value of the parameter roid can be found in the ipnetwork info command, where 'b' is of block and the number is the ID in LACNIC's system

2.5. ASN Commands

ISP can't check, create or delete ASNs.

2.5.3. Info

Get the information on any ASN using the asn info command

shepp> asn info 1234

2.5.4. Update

Use the asn update command to update the AS owned by the ISP. It is not allowed to change the ASN organization.

shepp> asn update 123 -add-contact routing=JOD1 -add-contact security=OPL1 -rem-contact routing=JOD2 -rem-contact security=OPL2

2.5.5. Info

Use asn info command to check the last changes made by the asn update command