Description ↑

The rkerberos library provides a Ruby interface for Kerberos.

Requirements ↑

Kerberos 1.7.0 or later, including admin header and library files.

OSX ↑

krb5 must be installed from source before installing the rkerberos gem: <code> wget web.mit.edu/kerberos/dist/krb5/1.10/krb5-1.10.2-signed.tar tar -xf krb5-1.10.2-signed.tar tar -xf krb5-1.10.2-signed.tar.gz cd krb5-1.10.2 ./configure make make install </code> latest release is here: web.mit.edu/kerberos/dist/index.html

Synopsis ↑

require 'rkerberos'

  # Get the default realm name
  krb5 = Kerberos::Krb5.new
  puts krb5.default_realm
  krb5.close

  # Get the default keytab name
  keytab = Kerberos::Krb5::Keytab.new
  puts keytab.default_name
  keytab.close

  # Set the password for a given principal
  kadm5 = Kerberos::Kadm5.new(:principal => 'foo/admin', :password => 'xxxx')
  kadm5.set_password('someuser', 'abc123')
  kadm5.close

  # Using the block form
  Kerberos::Kadm5.new(:principal => 'foo/admin', :password => 'xxxx') do |kadm5|
    p kadm5.get_principal('someuser')
    kadm5.set_password('someuser', 'abc123')
  end

Notes ↑

The rkerberos library is a repackaging of my custom branch of the krb5_auth library. Eventually the gem djberg96-krb5_auth will be removed from the gem index.

MIT vs Heimdal ↑

This code was written for the MIT Kerberos library. It has not been tested with the Heimdal Kerberos library.

TODO ↑

Authors ↑

License ↑

rkerberos is distributed under the Artistic 2.0 license.