No commit activity in last 3 years
No release in over 3 years
Fluentd mixin module to provide certificate/key generation/handling
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.6
>= 0

Runtime

 Project Readme

Fluent::Mixin::Certificate

Fluent::Mixin::Certificate is a mixin-module, that provides certificate/private-key managements for Fluentd plugins.

This module provides:

  • configration parameters for SSL certificate/private-key generation
  • #certificate instance method to return cert and key values which specified by configuration parameters

Usage

To use this module in your fluentd plugin, just include this module.

module Fluent
  class YourAwesomeInput < Input
    Fluent::Plugin.register_input('your_awesome', self)
    #
    include Fluent::Mixin::Certificate
    ### this 'include' adds these config_param items below.
    # config_param :self_hostname, :string
    #
    # config_param :cert_auto_generate, :bool, :default => false
    # config_param :generate_private_key_length, :integer, :default => 2048
    #
    # config_param :generate_cert_country, :string, :default => 'US'
    # config_param :generate_cert_state, :string, :default => 'CA'
    # config_param :generate_cert_locality, :string, :default => 'Mountain View'
    # config_param :generate_cert_common_name, :string, :default => nil
    #
    # config_param :cert_file_path, :string, :default => nil
    # config_param :private_key_file, :string, :default => nil
    # config_param :private_key_passphrase, :string, :default => nil
  end
end

This module use self_host parameter to generate common name of certificates. This is a required configuration parameter.

Moreover, just one of cert_auto_generate yes or cert_file_path PATH must be specified.

AUTHOR / CONTRIBUTORS

LICENSE

  • Copyright: Copyright (c) 2014- tagomoris
  • License: Apache License, Version 2.0