The TrustDir
manages the trusted certificates for gem signature verification.
Default permissions for the trust directory and its contents
The directory where trusted certificates will be stored.
# File tmp/rubies/ruby-3.2.0/lib/rubygems/security/trust_dir.rb, line 24
def initialize(dir, permissions = DEFAULT_PERMISSIONS)
@dir = dir
@permissions = permissions
@digester = Gem::Security.create_digest
end
Creates a new TrustDir
using dir
where the directory and file permissions will be checked according to permissions
# File tmp/rubies/ruby-3.2.0/lib/rubygems/security/trust_dir.rb, line 34
def cert_path(certificate)
name_path certificate.subject
end
Returns the path to the trusted certificate
# File tmp/rubies/ruby-3.2.0/lib/rubygems/security/trust_dir.rb, line 41
def each_certificate
return enum_for __method__ unless block_given?
glob = File.join @dir, "*.pem"
Dir[glob].each do |certificate_file|
begin
certificate = load_certificate certificate_file
yield certificate, certificate_file
rescue OpenSSL::X509::CertificateError
next # HACK warn
end
end
end
Enumerates trusted certificates.
# File tmp/rubies/ruby-3.2.0/lib/rubygems/security/trust_dir.rb, line 61
def issuer_of(certificate)
path = name_path certificate.issuer
return unless File.exist? path
load_certificate path
end
Returns the issuer certificate of the given certificate
if it exists in the trust directory.
# File tmp/rubies/ruby-3.2.0/lib/rubygems/security/trust_dir.rb, line 81
def load_certificate(certificate_file)
pem = File.read certificate_file
OpenSSL::X509::Certificate.new pem
end
Loads the given certificate_file
# File tmp/rubies/ruby-3.2.0/lib/rubygems/security/trust_dir.rb, line 72
def name_path(name)
digest = @digester.hexdigest name.to_s
File.join @dir, "cert-#{digest}.pem"
end
Returns the path to the trusted certificate with the given ASN.1 name
# File tmp/rubies/ruby-3.2.0/lib/rubygems/security/trust_dir.rb, line 90
def trust_cert(certificate)
verify
destination = cert_path certificate
File.open destination, "wb", 0600 do |io|
io.write certificate.to_pem
io.chmod(@permissions[:trusted_cert])
end
end
Add a certificate to trusted certificate list.
# File tmp/rubies/ruby-3.2.0/lib/rubygems/security/trust_dir.rb, line 106
def verify
require "fileutils"
if File.exist? @dir
raise Gem::Security::Exception,
"trust directory #{@dir} is not a directory" unless
File.directory? @dir
FileUtils.chmod 0700, @dir
else
FileUtils.mkdir_p @dir, :mode => @permissions[:trust_dir]
end
end
Make sure the trust directory exists. If it does exist, make sure it’s actually a directory. If not, then create it with the appropriate permissions.