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].
Example:
<br /> <br /> shepp> server beta.lacnic.net:7000 shepp> connect
2.1.2. Login
Execute the login command, also changing the provided password to a another one chosen by the user.
Example:
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 email@lacnic.net
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 newemail@lacnic.net
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 Registro.br, 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 email@lacnic.net -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 newmail@lacnic.net
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=190.62.0.0-190.62.0.255
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=190.62.0.0-190.62.0.255 -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=190.62.0.0-190.62.0.255
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 email@lacnic.net -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=190.62.0.0-190.62.0.255
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