Corineus

Corineus is a wrapper for the kinit and nsupdate commands to allow easy authenticated updates of DNS records on a Microsoft Windows DNS server from Linux.

Installation

# Centos 7 dependencies for kinit and nsupdate commands. Not sure what packages
# these commands are in for Ubuntu and other distros:
sudo yum install krb5-workstation bind-utils

# Install the gem
gem install corineus

Usage

Add

  corineus add -d, --data=Data for the record -k, --kdc=Kerberos KDC -n, --name=Record to be added -p, --password=Authorized password  -r, --realm=Kerberos realm -s, --server=DNS server -u, --user=Authorized username

Options:
  -n, --name=Record to be added
  -d, --data=Data for the record
  -t, [--type=Type of record]
                                                  # Default: A
  -l, [--ttl=Time To Live]
                                                  # Default: 86400
  -s, --server=DNS server
  -r, --realm=Kerberos realm
  -k, --kdc=Kerberos KDC
  -u, --user=Authorized username
  -p, --password=Authorized password
  -v, [--verbose=Verbose output], [--no-verbose]

Description:
  `corineus add` will add a DNS record to a server, authenticating via Kerberos.

  > $ corineus add --name=www.mydomain.com --data=server1.mydomain.com --type=CNAME --server=dns1.mydomain.com --realm=MYDOMAIN.COM --kdc dc1.mydomain.com --user=admin --password=mypass

Remove

  corineus remove -k, --kdc=Kerberos KDC -n, --name=Record to be removed -p, --password=Authorized password  -r, --realm=Kerberos realm -s, --server=DNS server -u, --user=Authorized username

Options:
  -n, --name=Record to be removed
  -s, --server=DNS server
  -r, --realm=Kerberos realm
  -k, --kdc=Kerberos KDC
  -u, --user=Authorized username
  -p, --password=Authorized password
  -v, [--verbose=Verbose output], [--no-verbose]

Description:
  `corineus remove` will remove a DNS record from a server, authenticating via Kerberos.

  > $ corineus remove --name=www.mydomain.com --server=dns1.mydomain.com --realm=MYDOMAIN.COM --kdc dc1.mydomain.com --user=admin --password=mypass

Contributing

Bug reports and pull requests are welcome on GitLab at https://gitlab.com/harbottle/corineus.

License

The gem is available as open source under the terms of the MIT License.