Module: Hyperkit::Client::Certificates

Included in:
Hyperkit::Client
Defined in:
lib/hyperkit/client/certificates.rb

Overview

Methods for the certificates API

Instance Method Summary collapse

Instance Method Details

#certificate(fingerprint) ⇒ Sawyer::Resource

Retrieve a trusted certificate from the server

Examples:

Retrieve a certificate

Hyperkit.certificate("c782c0f3530a04a5b2b78fc5292b7500aef1299370288b5eeb0450a6613a2c82") #=> {
  :certificate => "-----BEGIN CERTIFICATE-----\nMIIEW...ceyg04=\n-----END CERTIFICATE-----\n",
  :fingerprint => "c782c0f3530a04a5b2b78fc5292b7500aef1299370288b5eeb0450a6613a2c82",
  :type => "client"
}

Retrieve a certificate by specifying a prefix of its fingerprint

Hyperkit.certificate("c7") #=> {
  :certificate => "-----BEGIN CERTIFICATE-----\nMIIEW...ceyg04=\n-----END CERTIFICATE-----\n",
  :fingerprint => "c782c0f3530a04a5b2b78fc5292b7500aef1299370288b5eeb0450a6613a2c82",
  :type => "client"
}

65
66
67
# File 'lib/hyperkit/client/certificates.rb', line 65

def certificate(fingerprint)
  get(certificate_path(fingerprint)).
end

#certificatesArray<String>

List of trusted certificates on the server

Examples:

Get list of containers

Hyperkit.certificates #=> [
  "c782c0f3530a04a5b2b78fc5292b7500aef1299370288b5eeb0450a6613a2c82",
  "b7720e1eb839056158cf65d182865491a0403f766983b95f5098d05911bbff89"
]

23
24
25
26
# File 'lib/hyperkit/client/certificates.rb', line 23

def certificates
  response = get(certificates_path)
  response..map { |path| path.split('/').last }
end

#create_certificate(cert, options = {}) ⇒ Sawyer::Resource

Add a new trusted certificate to the server

Examples:

Add trusted certificate

Hyperkit.create_certificate(File.read("/tmp/cert.pem"))

Add trusted certificate via untrusted client connection

Hyperkit.create_certificate(File.read("/tmp/cert.pem"), password: "server-trust-password")

Options Hash (options):

  • :name (String)

    Optional name for the certificate. If not specified, the host in the TLS header for the request is used.

  • :password (String)

    The trust password for that server. Only required if untrusted.


41
42
43
44
45
# File 'lib/hyperkit/client/certificates.rb', line 41

def create_certificate(cert, options={})
  options = options.slice(:name, :password)
  options = options.merge(type: "client", certificate: Base64.strict_encode64(OpenSSL::X509::Certificate.new(cert).to_der))
  post(certificates_path, options).
end

#delete_certificate(fingerprint) ⇒ Sawyer::Resource

Delete a trusted certificate from the server

Examples:

Delete a certificate

Hyperkit.delete_certificate("c782c0f3530a04a5b2b78fc5292b7500aef1299370288b5eeb0450a6613a2c82")

Delete a certificate by specifying a prefix of its fingerprint

Hyperkit.delete_certificate("c7")

79
80
81
# File 'lib/hyperkit/client/certificates.rb', line 79

def delete_certificate(fingerprint)
  delete(certificate_path(fingerprint)).
end