LoCAl is a daemon which acts as a local Certificate Authority. It can have a self-signed certificate and can issue certificates.
Install the gem and add to the application's Gemfile by executing:
$ bundle add local
If bundler is not being used to manage dependencies, install the gem by executing:
$ gem install local
Run exe/local
to start the program.
The available ENV variables are:
Name | Type | Default value | Description |
---|---|---|---|
CONFIG_FILE | string (path) | The path of the config file. | |
LOG_FILE_PATH | string (path) | ./local.log |
The path of the log file. |
An example configuration file can be found in the repository.
This repository contains a .ruby_version
file for rbenv. To avoid errors due to a different Ruby version, I encourage you to use rbenv
and, if necessary, install the version defined in .ruby_version
.
After checking out the repo, run bin/setup
to install dependencies. Then, run rake test
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and the created tag, and push the .gem
file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/asperan/local.
These are the main sites where I got the knowledge:
- https://myhomelab.gr/linux/2019/12/13/local-ca-setup.html
- https://www.golinuxcloud.com/renew-self-signed-certificate-openssl/
- https://stackoverflow.com/questions/60644617/curl-says-requested-domain-name-does-not-match-the-servers-certificate-but-i
- https://stackoverflow.com/questions/6194236/openssl-certificate-version-3-with-subject-alternative-name
- https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
LoCAl is distributed under the terms of the GNU Affero General Public License v3.0.