go-rriclient

DENIC RRI Client

This application is a client for the RRI with an interactive CLI developed by DENIC eG, to send requests and info commands to and receive responses from the DENIC registry server.

Installation

The DENIC RRI client is developed in GO and can be installed and built from the repository:

go install github.com/DENICeG/go-rriclient@latest

Connections and Credentials

The RRI address is defined by host:port. There are three ways to setup a connection to an RRI server:

1. Server address only

This command opens an unauthenticated RRI session:

go-rriclient localhost:51131

You have to type in login {username} to get access to the RRI server. This will trigger a prompt for your password.

1. Server address and credentials

You can log in directly with username and password added in the command line:

go-rriclient localhost:51131 -u {username} -p {password}

1. Set up Environment Files

If you have access to one or more RRI environments with different sets of server addresses and credential information, you can store this access information in an easy-to-use picklist with alias names. You add entries to the picklist with:

go-rriclient -e {alias name}

The DENIC RRI client will ask you for host, port, username and password that you would like to store with the alias. The information is stored in an environment file in ~/.rri-client.

When you type in:

go-rriclient

the DENIC RRI client will start with the picklist.

DENIC RRI Client Modes

You can interact with the DENIC RRI client in two modes. All modes can be combined with any of the previously described connection types. See sections CLI Arguments, RRI Commands and RRI Request Examples for a detailed explanation of CLI arguments and RRI commands/parameters.

1. File Source Mode

This mode will execute all RRI commands and arguments contained in the file you have specified (example.txt). Commands are separated by a line starting with a dash. When using an unauthenticated session, the file must also contain a login command to open an authenticated session.

go-rriclient localhost:51131 -f example.txt
go-rriclient localhost:51131 -u (username) -p (password) -f example.txt
go-rriclient -e {alias name} -f example.txt
go-rriclient -f example.txt

1. Interactive Mode

This mode will open a bash-like interactive CLI with command completion for convenient RRI access.

go-rriclient localhost:51131
go-rriclient localhost:51131 -u (username) -p (password)
go-rriclient -e {alias name}
go-rriclient

CLI Arguments

RRI Commands

You can use the following commands in file mode and interactive mode:

RRI Request Examples

Create Domain/Update Domain

The full create domain and update domain commands accept the following parameters:

create domain {domain} {holder} {general-request} {abuse-contact} {nserver-1} {nserver-2} ...

The parameters holder, general-request and abuse-contact are handles. You specify an arbitrary number of name servers at the end. An interactive prompt will be opened for all missing parameters.

Chprov

The chprov command is like the create domain command. It behaves exactly like the create domain command and accepts the following parameters:

chprov {domain} {secret} {holder} {general-request} {abuse-contact} {nserver-1} {nserver-2} ...

RRI Package

This repository also provides the Go package github.com/DENICeG/go-rriclient/pkg/rri that can be used as base for custom implementations. See github.com/DENICeG/go-rriclient/tree/master/pkg/rri for a detailed, technical explanation and usage examples.

Thanks

Thanks to sebidude for the protocol implementation.

Changelog

v1.17.0 (2023-08-03)

• removed all Verify-related fields and methods
• added support for QUEUE-READ and QUEUE-DELETE in pkg and cli
• added support for WARNING response

v1.16.0 (2023-07-31)

• added ContactTypeRequest