Class: Autosign::Validator::ValidatorBase

Inherits:
Object
  • Object
show all
Defined in:
lib/autosign/validator/validator_base.rb

Overview

Parent class for validation backends. Validator take the challenge_password and common name from a certificate signing request, and perform some action to determine whether the request is valid.

Validator also get the raw X509 CSR in case the extracted information is insufficient for future, more powerful validators.

All validators must inherit from this class, and must override several methods in order to function. At a minimum, the name and perform_validation methods must be implemented by child classes.

Direct Known Subclasses

JWT, Multiplexer, Passwordlist

Constant Summary collapse

NAME = 
'base'

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(config_file_settings = nil) ⇒ ValidatorBase 



23
24
25
26
27
28
29
30
31
 
# File 'lib/autosign/validator/validator_base.rb', line 23

def initialize(config_file_settings = nil)
  @config_file_settings = config_file_settings
  start_logging
  settings # just run to validate settings
  setup
  # call name to ensure that the class fails immediately if child classes
  # do not implement it.
  name
end

Instance Attribute Details

#config_file_settings ⇒ Object (readonly)

Returns the value of attribute config_file_settings.



21
22
23
 
# File 'lib/autosign/validator/validator_base.rb', line 21

def config_file_settings
  @config_file_settings
end

Instance Method Details

#name ⇒ String

You must set the NAME constant in the sublcass



35
36
37
 
# File 'lib/autosign/validator/validator_base.rb', line 35

def name
  self.class::NAME
end

#perform_validation(_challenge_password, _certname, _raw_csr) ⇒ True, False

define how a validator actually validates the request. This must be implemented by validators which inherit from the Autosign::Validator class.

Raises:

  • (NotImplementedError) 


47
48
49
50
51
52
 
# File 'lib/autosign/validator/validator_base.rb', line 47

def perform_validation(_challenge_password, _certname, _raw_csr)
  # override this after inheriting
  # should return true to indicate success validating
  # or false to indicate that the validator was unable to validate
  raise NotImplementedError
end

#validate(challenge_password, certname, raw_csr) ⇒ Object

wrapper method that wraps input validation and logging around the perform_validation method. Do not override or use this class in child classes. This is the class that gets called on validator objects.



57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/autosign/validator/validator_base.rb', line 57

def validate(challenge_password, certname, raw_csr)
  raise unless challenge_password.is_a?(String)
  raise unless certname.is_a?(String)
  
  case perform_validation(challenge_password, certname, raw_csr)
  when true
    @log.debug 'validated successfully'
    @log.info  "Validated '#{certname}' using '#{name}' validator"
    true
  when false
    @log.debug 'validation failed'
    @log.debug "Unable to validate '#{certname}' using '#{name}' validator"
    false
  else
    @log.error 'perform_validation returned a non-boolean result'
    raise 'perform_validation returned a non-boolean result'
  end
end