README.md in trocla-0.2.0 vs README.md in trocla-0.2.1

- old
+ new

@@ -67,10 +67,11 @@ * length: int - Define any lenght that a newly created password should have. Default: 16 - or whatever you define in your global settings. * charset: (default|alphanumeric|shellsafe) - Which set of chars should be used for a random password? Default: default - or whatever you define in your global settings. * profiles: a profile name or an array of profiles matching a profile_name in your configuration. Learn more about profiles below. * random: boolean - Whether we allow creation of random passwords or we expect a password to be preset. Default: true - or whatever you define in your global settings. * expires: An integer indicating the amount of seconds a value (e.g. password) is available. After expiration a value will not be available anymore and trying to `get` this key will return no value (nil). Meaning that calling create after expiration, would create a new password automatically. There is more about expiration in the storage backends section. +* render: A hash providing flags for formats to render the output specifially. This is a global option, but support depends on a per format basis. Example: trocla create some_shellsafe_password plain 'charset: shellsafe' trocla create another_alphanumeric_20_char_password plain "charset: alphanumeric @@ -199,13 +200,20 @@ signable by the CA, as soon as we have one item in the list, only DNS entries matching this list are allowed. Be aware, that older openssl versions have a bug with [leading dots](https://rt.openssl.org/Ticket/Display.html?id=3562) for name constraints. So using them might not work everywhere as expected. +Output render options are: + + certonly If set to true the x509 format will return only the certificate + keyonly If set to true the x509 format will return only the private key + ## Installation -Simply build and install the gem. +* Debian has trocla within its sid-release: `apt-get install trocla` +* For RHEL/CentOS 7 there is a [copr reporisotry](https://copr.fedoraproject.org/coprs/duritong/trocla/). Follow the help there to integrate the repository and install trocla. +* Trocla is also distributed as gem: `gem install trocla` ## Configuration Trocla can be configured in /etc/troclarc.yaml and in ~/.troclarc.yaml. A sample configuration file can be found in `lib/trocla/default_config.yaml`. By default trocla configures moneta to store all data in /tmp/trocla.yaml @@ -297,9 +305,13 @@ :private_key: '/var/lib/puppet/ssl/private_keys/trocla.pem' :public_key: '/var/lib/puppet/ssl/public_keys/trocla.pem' ``` ## Update & Changes + +### to 0.2.1 + +1. New Feature: Introduce a way to render specific formats, mainly this allows you to control the output of a specific format. See the x509 format for more information. ### to 0.2.0 1. New feature profiles: Introduce profiles to make it easy to have a default set of properties. See the profiles section for more information. 1. New feature expiration: Make it possible that keys can have an expiration. See the expiration section for more information.