Skip to content

oferreiro/RubyCA

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

115 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RubyCA

About

RubyCA is a simple certificate authority manager written in Ruby.

This is a fork from https://github.com/phillcampbell/RubyCA

It is designed for internal use as an alternative to using self signed certificates. Install and trust the root certificate in your clients and any certificates you create will just work, no more browser warnings.

Development

RubyCA is currently in development and not all features are implemented.

Currently, RubyCA will generate root and intermediate CA certificates. The web UI can be used to manage signing requests, certificates and revokations, as well as to download certificates and keys and serve the certificate revocation list.

In the future the web UI will support the Online Certificate Status Protocol (OCSP).

The currently isn't much error checking, this will be added in the future.

Pull requests welcome.

Usage

Clone and enter the repository

$ git clone https://github.com/oferreiro/RubyCA
$ cd RubyCA

Use bundle to install dependencies

$ bundle install

Create the ./config/rubyca.yml file and edit to suit your requirements

$ cp ./config/rubyca.yml.sample ./config/rubyca.yml
$ nano ./config/rubyca.yml

RubyCA must be started as root on the first run to be able generate the ca certificates

$ sudo ./RubyCA

Visit http://:/admin to manage certificates

Tips

To be able to be run RubyCA as daemon

Using Puma:

$ cp ./distrib/puma/puma-sample.rb ./config/puma.rb
nano ./config/puma.rb

RubyCA must be started with:

$ bundle exec puma -C ./config/puma.rb    

Using Thin:

Create the thin.yml file and edit to suit your requirements.

$ cp ./distrib/thin/thin.yml.sample ./config/thin.yml
$ nano ./config/thin.yml

Edit Gemfile to use thin server:

gem 'thin', '~> 1.7', '>= 1.7.2'
#gem 'puma', '~> 3.11'

Run bundle:

$ bundle

RubyCA must be started with:

$ bundle exec thin start -C ./config/thin.yml

Note: The first run still needs RubyCA run as root to be able generate the ca certificates.

$ sudo ./RubyCA

Or run in unsafe mode (-u|--unsafe) if you want keep current user privileges on root ca private key file.

$./RubyCA --unsafe

About

Certificate Authority manager in Ruby

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 53.9%
  • Ruby 29.2%
  • Haml 15.8%
  • Other 1.1%