corineus 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4e3d562febe94252df9ff5252e1b3e3f2ae572c0
+  data.tar.gz: 104ee3be729b408bb407ac04ae2b3b7e2d2c840f
+SHA512:
+  metadata.gz: 3745fd763b803a0bc15df5c637b967341f6c9d4cb6d776c484967c64c933c841e784fa6018ca9725e2d04b10ed3461f5629ec7326db81e8a3fd647f0fc798f80
+  data.tar.gz: e569a9da19c4486604ac6b946a7d585c143ee0dba1c0207de8ba51c73bccad827ddefa73bae64ee06f217fc6a1e3e6972116df0c455b52762baf6aaed52d78d3

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.0.0
+before_install: gem install bundler -v 1.12.5

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in corineus.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 TODO: Write your name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,72 @@
+# 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
+
+```bash
+# 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](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/bin/corineus

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require "rubygems"
+$: << File.join(File.dirname(__FILE__), "..", "lib")
+require "corineus"
+CORINEUS.start(ARGV)
+

data/corineus.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'corineus/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "corineus"
+  spec.version       = Corineus::VERSION
+  spec.authors       = ["Richard Grainger"]
+  spec.email         = ["grainger@gmail.com"]
+
+  spec.summary       = "corineus - update DNS records on remote Windows " \
+    "servers from Linux"
+  spec.description   = "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."
+  spec.homepage      = "https://gitlab.com/harbottle/corineus"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "bin"
+  spec.executables   << "corineus"
+  spec.require_paths << "lib"
+
+  spec.add_dependency("colorize", ">=0.8.1")
+  spec.add_dependency("POpen4", ">=0.1.4")
+  spec.add_dependency("thor", ">=0.19.1")
+
+  spec.add_development_dependency "bundler", "~> 1.12"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+end

data/lib/corineus.rb

@@ -0,0 +1,130 @@
+require "corineus/version"
+require 'thor'
+require 'tempfile'
+require 'popen4'
+require 'colorize'
+
+class String
+  def unindent 
+    gsub(/^#{scan(/^\s*/).min_by{|l|l.length}}/, "")
+  end
+end
+
+class CORINEUS < Thor
+
+  class_option :verbose, :banner => 'Verbose output', :type => :boolean, :default  => false, :aliases  => '-v'
+
+  desc "add", "Add a DNS record"
+  long_desc <<-LONGDESC
+    `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
+  LONGDESC
+  option :name,     :banner => 'Record to be added',   :required => true,    :aliases  => '-n'
+  option :data,     :banner => 'Data for the record',  :required => true,    :aliases  => '-d'
+  option :type,     :banner => 'Type of record',       :default  => 'A',     :aliases  => '-t'
+  option :ttl,      :banner => 'Time To Live',         :default  => '86400', :aliases  => '-l'
+  option :server,   :banner => 'DNS server',           :required => true,    :aliases  => '-s'
+  option :realm,    :banner => 'Kerberos realm',       :required => true,    :aliases  => '-r'
+  option :kdc,      :banner => 'Kerberos KDC',         :required => true,    :aliases  => '-k'
+  option :user,     :banner => 'Authorized username',  :required => true,    :aliases  => '-u'
+  option :password, :banner => 'Authorized password ', :required => true,    :aliases  => '-p'
+  
+  def add()
+   update 'add'
+  end
+
+  desc "remove", "Remove a DNS record"
+  long_desc <<-LONGDESC
+    `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
+  LONGDESC
+  option :name, :banner   => 'Record to be removed', :required => true, :aliases  => '-n'
+  option :server, :banner   => 'DNS server', :required => true, :aliases  => '-s'
+  option :realm, :banner   => 'Kerberos realm', :required => true, :aliases  => '-r'
+  option :kdc, :banner   => 'Kerberos KDC', :required => true, :aliases  => '-k'
+  option :user, :banner   => 'Authorized username', :required => true, :aliases  => '-u'
+  option :password, :banner   => 'Authorized password ', :required => true, :aliases  => '-p'
+
+  def remove()
+    update 'delete'
+  end
+
+  no_commands do
+    def update(action='add')
+
+      k_conf = <<-KRBCONF.unindent
+      [realms]
+      #{options[:realm]} = {
+      kdc = #{options[:kdc]}
+      default_domain = #{options[:realm]}
+      }
+      KRBCONF
+
+      ns_input = <<-NSINPUT.unindent
+      server #{options[:server]}
+      update #{action} #{options[:name]} #{options[:ttl]} #{options[:type]} #{options[:data]}
+      send
+      quit
+      NSINPUT
+
+      pad_length = 50
+      k_file = Tempfile.new('krb5')
+      k_file.write(k_conf)
+      k_file.rewind
+
+      commands = {
+        "Kerberos" => {
+          :desc    => 'Get Kerberos ticket',
+          :command => "env KRB5_CONFIG=#{k_file.path} kinit #{options[:user]}@#{options[:realm]}",
+          :input   => "#{options[:password]}",
+          :exit    => 1,
+          :clue    => 'Do you have the kinit command installed and in your PATH?'
+        },
+        "nsupdate" => {
+          :desc    => "#{action.capitalize} DNS record",
+          :command => "env KRB5_CONFIG=#{k_file.path} nsupdate -g",
+          :input   => ns_input,
+          :exit    => 2,
+          :clue    => 'Do you have the nsupdate command installed and in your PATH?'
+        }
+      }
+      commands.each do |task, details|
+        outputs = ''
+        errors =  ''
+        print "#{details[:desc]}...".ljust(pad_length, padstr='.') if options[:verbose]
+        command_status = POpen4::popen4(details[:command]) do |stdout, stderr, stdin|
+          stdin.puts details[:input]
+          stdout.each do |line|
+            outputs << "#{line.strip}\n"
+          end
+          stderr.each do |line|
+            errors << "#{line.strip}\n"
+          end
+        end
+        if command_status.exitstatus == 0
+          print "Success.\n".green if options[:verbose]
+        else
+          if options[:verbose]
+            print "Failure:\n".red
+            print "#{outputs.strip}\n".red
+            print "#{errors.strip}\n".red
+            print "#{details[:clue]}\n".light_blue
+          end
+          exit details[:exit]
+        end
+      end
+
+      k_file.close
+      k_file.unlink
+    end
+  end
+
+end
+

data/lib/corineus/version.rb

@@ -0,0 +1,3 @@
+module Corineus
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: corineus
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Richard Grainger
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+- !ruby/object:Gem::Dependency
+  name: POpen4
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.4
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: 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.
+email:
+- grainger@gmail.com
+executables:
+- corineus
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/corineus
+- corineus.gemspec
+- lib/corineus.rb
+- lib/corineus/version.rb
+homepage: https://gitlab.com/harbottle/corineus
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: corineus - update DNS records on remote Windows servers from Linux
+test_files: []