Class: R509::CRL::Administrator

Inherits:

Object

• Object
• R509::CRL::Administrator

show all

Includes:

IOHelpers

Defined in:

lib/r509/crl.rb

Overview

Instance Attribute Summary (collapse)

• - (Object) crl readonly

  Returns the value of attribute crl.

• - (Object) crl_list_file readonly

  Returns the value of attribute crl_list_file.

• - (Object) crl_number readonly

  Returns the value of attribute crl_number.

• - (Object) crl_number_file readonly

  Returns the value of attribute crl_number_file.

• - (Object) validity_hours readonly

  Returns the value of attribute validity_hours.

Instance Method Summary (collapse)

• - (String) generate_crl

  Generate the CRL.

• - (Administrator) initialize(config) constructor

  A new instance of Administrator.

• - (Object) revoke_cert(serial, reason = nil, revoke_time = Time.now.to_i, generate_and_save = true)

  Adds a certificate to the revocation list.

• - (Boolean) revoked?(serial)

  Indicates whether the serial number has been revoked, or not.

• - (Array) revoked_cert(serial)

  Serial, reason, revoke_time tuple.

• - (Array<Array>) revoked_certs

  Returns an array of serial, reason, revoke_time tuples.

• - (Object) save_crl_list(filename_or_io = @crl_list_file)

  Saves the CRL list to a filename or IO.

• - (Object) save_crl_number(filename_or_io = @crl_number_file)

  Save the CRL number to a filename or IO.

• - (Object) unrevoke_cert(serial)

  Remove serial from revocation list.

Methods included from IOHelpers

#read_data, read_data, #write_data, write_data

141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

# File 'lib/r509/crl.rb', line 141

def initialize(config)
  @config = config

  unless @config.kind_of?(R509::Config::CAConfig)
    raise R509Error, "config must be a kind of R509::Config::CAConfig"
  end

  @validity_hours = @config.crl_validity_hours
  @start_skew_seconds = @config.crl_start_skew_seconds
  @crl = nil

  @crl_number_file = @config.crl_number_file
  if not @crl_number_file.nil?
    @crl_number = read_data(@crl_number_file).to_i
  else
    @crl_number = 0
  end


  @crl_list_file = @config.crl_list_file
  load_crl_list(@crl_list_file)
end

138
139
140

# File 'lib/r509/crl.rb', line 138

def crl
  @crl
end

138
139
140

# File 'lib/r509/crl.rb', line 138

def crl_list_file
  @crl_list_file
end

138
139
140

# File 'lib/r509/crl.rb', line 138

def crl_number
  @crl_number
end

138
139
140

# File 'lib/r509/crl.rb', line 138

def crl_number_file
  @crl_number_file
end

138
139
140

# File 'lib/r509/crl.rb', line 138

def validity_hours
  @validity_hours
end

230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266

# File 'lib/r509/crl.rb', line 230

def generate_crl
  crl = OpenSSL::X509::CRL.new
  crl.version = 1
  now = Time.at Time.now.to_i
  crl.last_update = now-@start_skew_seconds
  crl.next_update = now+@validity_hours*3600
  crl.issuer = @config.ca_cert.subject.name

  self.revoked_certs.each do |serial, reason, revoke_time|
    revoked = OpenSSL::X509::Revoked.new
    revoked.serial = OpenSSL::BN.new serial.to_s
    revoked.time = Time.at(revoke_time)
    if not reason.nil?
      enum = OpenSSL::ASN1::Enumerated(reason) #see reason codes below
      ext = OpenSSL::X509::Extension.new("CRLReason", enum)
      revoked.add_extension(ext)
    end
    #now add it to the crl
    crl.add_revoked(revoked)
  end

  ef = OpenSSL::X509::ExtensionFactory.new
  ef.issuer_certificate = @config.ca_cert.cert
  ef.crl = crl
  #grab crl number from file, increment, write back
  crl_number = increment_crl_number
  crlnum = OpenSSL::ASN1::Integer(crl_number)
  crl.add_extension(OpenSSL::X509::Extension.new("crlNumber", crlnum))
  extensions = []
  extensions << ["authorityKeyIdentifier", "keyid:always,issuer:always", false]
  extensions.each{|oid, value, critical|
    crl.add_extension(ef.create_extension(oid, value, critical))
  }
  crl.sign(@config.ca_cert.key.key, OpenSSL::Digest::SHA1.new)
  @crl = R509::CRL::SignedList.new crl
  @crl.to_pem
end

unspecified       (0),
keyCompromise       (1),
cACompromise        (2),
affiliationChanged    (3),
superseded        (4),
cessationOfOperation    (5),
certificateHold     (6),
removeFromCRL       (8),
privilegeWithdrawn    (9),
aACompromise       (10) }

197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215

# File 'lib/r509/crl.rb', line 197

def revoke_cert(serial,reason=nil, revoke_time=Time.now.to_i, generate_and_save=true)
  if not reason.to_i.between?(0,10)
    reason = 0
  end
  serial = serial.to_i
  if not reason.nil?
    reason = reason.to_i
  end
  revoke_time = revoke_time.to_i
  if revoked?(serial)
    raise R509::R509Error, "Cannot revoke a previously revoked certificate"
  end
  @revoked_certs[serial] = {:reason => reason, :revoke_time => revoke_time}
  if generate_and_save
    generate_crl
    save_crl_list
  end
  nil
end

168
169
170

# File 'lib/r509/crl.rb', line 168

def revoked?(serial)
  @revoked_certs.has_key?(serial)
end

173
174
175

# File 'lib/r509/crl.rb', line 173

def revoked_cert(serial)
  @revoked_certs[serial]
end

270
271
272
273
274
275
276

# File 'lib/r509/crl.rb', line 270

def revoked_certs
  ret = []
  @revoked_certs.keys.sort.each do |serial|
    ret << [serial, @revoked_certs[serial][:reason], @revoked_certs[serial][:revoke_time]]
  end
  ret
end

285
286
287
288
289
290
291
292
293
294

# File 'lib/r509/crl.rb', line 285

def save_crl_list(filename_or_io = @crl_list_file)
  return nil if filename_or_io.nil?

  data = []
  self.revoked_certs.each do |serial, reason, revoke_time|
    data << [serial, revoke_time, reason].join(',')
  end
  write_data(filename_or_io, data.join("\n"))
  nil
end

303
304
305
306
307
308
309

# File 'lib/r509/crl.rb', line 303

def save_crl_number(filename_or_io = @crl_number_file)
  return nil if filename_or_io.nil?
  # No valid filename or IO was specified, so bail.

  write_data(filename_or_io, self.crl_number.to_s)
  nil
end

220
221
222
223
224
225

# File 'lib/r509/crl.rb', line 220

def unrevoke_cert(serial)
  @revoked_certs.delete(serial)
  generate_crl
  save_crl_list
  nil
end