A ruby library for creating tickets for the Apache mod_auth_pubtkt module
Ruby
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
examples
lib
spec
.gitignore
README.md
Rakefile
mod-auth-pubtkt-rb.gemspec

README.md

mod_auth_pubtkt.rb

Here is a simple module for generating correctly signed tickets for use with the mod_auth_pubtkt Apache module, pretty basic stuff but usefully abstracts the OpenSSL complications.

For more info on mod_auth_pubtkt see: https://neon1.net/mod_auth_pubtkt

Install

sudo gem install mod-auth-pubtkt-rb

Usage

Generate a public / private key pair

Taken from: https://neon1.net/mod_auth_pubtkt/install.html

DSA

# openssl dsaparam -out dsaparam.pem 1024
# openssl gendsa -out privkey.pem dsaparam.pem
# openssl dsa -in privkey.pem -out pubkey.pem -pubout

The dsaparam.pem file is not needed anymore after key generation and can safely be deleted.

RSA

# openssl genrsa -out privkey.pem 1024
# openssl rsa -in privkey.pem -out pubkey.pem -pubout

Use it in your code

require 'mod_auth_pubtkt'

# This will generate the ticket, see ./lib/mod_auth_pubtkt for available options
tkt = ModAuthPubTkt.create_ticket 12345, Time.now + 3600, "/my/privkey.pem", "DSA"

# Now you can use the ticket as a cookie value in your web app!

License

(GPLv3)

Copyright (C) 2010 Matt Haynes

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <www.gnu.org/licenses/>