Module: Dnsimple::Client::Certificates

Included in:

CertificatesService

Defined in:

lib/dnsimple/client/certificates.rb

Instance Method Summary

• #all_certificates(account_id, domain_name, options = {}) ⇒ Dnsimple::CollectionResponse<Dnsimple::Struct::Certificate>

  List ALL the certificates for the domain in the account.

• #certificate(account_id, domain_id, certificate_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::Certificate>

  Get the details of a certificate.

• #certificate_private_key(account_id, domain_id, certificate_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::CertificateBundle>

  Get the PEM-encoded certificate private key.

• #certificates(account_id, domain_name, options = {}) ⇒ Dnsimple::PaginatedResponse<Dnsimple::Struct::Certificate> (also: #list_certificates)

  List the certificates for the domain in the account.

• #download_certificate(account_id, domain_id, certificate_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::CertificateBundle>

  Get the PEM-encoded certificate, along with the root certificate and intermediate chain.

• #issue_letsencrypt_certificate(account_id, domain_id, certificate_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::Certificate>

  Issue a pending Let’s Encrypt certificate order.

• #issue_letsencrypt_certificate_renewal(account_id, domain_id, certificate_id, certificate_renewal_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::Certificate>

  Issue a pending Let’s Encrypt certificate renewal order.

• #purchase_letsencrypt_certificate(account_id, domain_id, attributes = {}, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::CertificatPurchase>

  Purchase a Let’s Encrypt certificate.

• #purchase_letsencrypt_certificate_renewal(account_id, domain_id, certificate_id, attributes = {}, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::CertificateRenewal>

  Purchase a Let’s Encrypt certificate renewal.

Instance Method Details

#all_certificates(account_id, domain_name, options = {}) ⇒ Dnsimple::CollectionResponse<Dnsimple::Struct::Certificate>

List ALL the certificates for the domain in the account.

This method is similar to #certificates, but instead of returning the results of a specific page it iterates all the pages and returns the entire collection.

Please use this method carefully, as fetching the entire collection will increase the number of requests you send to the API server and you may eventually risk to hit the throttle limit.

Parameters:

• account_id (Integer) —

  the account ID

• domain_name (#to_s) —

  The domain ID or domain name

• options (Hash) (defaults to: {}) —

  the filtering and sorting option

Options Hash (options):

• :page (Integer) —

  current page (pagination)

• :per_page (Integer) —

  number of entries to return (pagination)

• :sort (String) —

  sorting policy

Returns:

• (Dnsimple::CollectionResponse<Dnsimple::Struct::Certificate>)

Raises:

• (Dnsimple::RequestError)

See Also:

• https://developer.dnsimple.com/v2/certificates/#listCertificates
• #certificates

# File 'lib/dnsimple/client/certificates.rb', line 55

def all_certificates(account_id, domain_name, options = {})
  paginate(:certificates, account_id, domain_name, options)
end

#certificate(account_id, domain_id, certificate_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::Certificate>

Get the details of a certificate.

Parameters:

• account_id (Integer) —

  the account ID

• domain_id (#to_s) —

  the domain ID or domain name

• certificate_id (Integer) —

  the certificate ID

• options (Hash) (defaults to: {})

Returns:

• (Dnsimple::Response<Dnsimple::Struct::Certificate>)

Raises:

• (Dnsimple::NotFoundError)
• (Dnsimple::RequestError)

See Also:

• https://developer.dnsimple.com/v2/certificates/#getCertificate

# File 'lib/dnsimple/client/certificates.rb', line 71

def certificate(account_id, domain_id, certificate_id, options = {})
  response = client.get(Client.versioned("/%s/domains/%s/certificates/%s" % [account_id, domain_id, certificate_id]), options)

  Dnsimple::Response.new(response, Struct::Certificate.new(response["data"]))
end

#certificate_private_key(account_id, domain_id, certificate_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::CertificateBundle>

Get the PEM-encoded certificate private key.

Parameters:

• account_id (Integer) —

  the account ID

• domain_id (#to_s) —

  the domain ID or domain name

• certificate_id (Integer) —

  the certificate ID

• options (Hash) (defaults to: {})

Returns:

• (Dnsimple::Response<Dnsimple::Struct::CertificateBundle>)

Raises:

• (Dnsimple::NotFoundError)
• (Dnsimple::RequestError)

See Also:

• https://developer.dnsimple.com/v2/certificates/#getCertificatePrivateKey

# File 'lib/dnsimple/client/certificates.rb', line 107

def certificate_private_key(account_id, domain_id, certificate_id, options = {})
  response = client.get(Client.versioned("/%s/domains/%s/certificates/%s/private_key" % [account_id, domain_id, certificate_id]), options)

  Dnsimple::Response.new(response, Struct::CertificateBundle.new(response["data"]))
end

#certificates(account_id, domain_name, options = {}) ⇒ Dnsimple::PaginatedResponse<Dnsimple::Struct::Certificate> Also known as: list_certificates

List the certificates for the domain in the account.

Examples:

List certificates in the first page

client.certificates.list(1010, "example.com")

List certificates, provide a specific page

client.certificates.list(1010, "example.com", page: 2)

List certificates, provide a sorting policy

client.certificates.list(1010, "example.com", sort: "email:asc")

Parameters:

• account_id (Integer) —

  the account ID

• domain_name (#to_s) —

  The domain ID or domain name

• options (Hash) (defaults to: {}) —

  the filtering and sorting options

Options Hash (options):

• :page (Integer) —

  current page (pagination)

• :per_page (Integer) —

  number of entries to return (pagination)

Returns:

• (Dnsimple::PaginatedResponse<Dnsimple::Struct::Certificate>)

Raises:

• (Dnsimple::RequestError)

See Also:

• https://developer.dnsimple.com/v2/certificates/#listCertificates
• #all_certificates

# File 'lib/dnsimple/client/certificates.rb', line 28

def certificates(account_id, domain_name, options = {})
  response = client.get(Client.versioned("/%s/domains/%s/certificates" % [account_id, domain_name]), Options::ListOptions.new(options))

  Dnsimple::PaginatedResponse.new(response, response["data"].map { |r| Struct::Certificate.new(r) })
end

#download_certificate(account_id, domain_id, certificate_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::CertificateBundle>

Get the PEM-encoded certificate, along with the root certificate and intermediate chain.

Parameters:

• account_id (Integer) —

  the account ID

• domain_id (#to_s) —

  the domain ID or domain name

• certificate_id (Integer) —

  the certificate ID

• options (Hash) (defaults to: {})

Returns:

• (Dnsimple::Response<Dnsimple::Struct::CertificateBundle>)

Raises:

• (Dnsimple::NotFoundError)
• (Dnsimple::RequestError)

See Also:

• https://developer.dnsimple.com/v2/certificates/#downloadCertificate

# File 'lib/dnsimple/client/certificates.rb', line 89

def download_certificate(account_id, domain_id, certificate_id, options = {})
  response = client.get(Client.versioned("/%s/domains/%s/certificates/%s/download" % [account_id, domain_id, certificate_id]), options)

  Dnsimple::Response.new(response, Struct::CertificateBundle.new(response["data"]))
end

#issue_letsencrypt_certificate(account_id, domain_id, certificate_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::Certificate>

Issue a pending Let’s Encrypt certificate order.

Note that the issuance process is async. A successful response means the issuance request has been successfully acknowledged and queued for processing.

Examples:

Basic usage

reponse     = client.certificates.issue_letsencrypt_certificate(1010, "example.com", 100)
certificate = response.data

certificate.state # => "requesting"

Parameters:

• account_id (Integer) —

  the account ID

• domain_id (#to_s) —

  the domain ID or domain name

• certificate_id (Integer) —

  the certificate ID returned by the purchase method

• options (Hash) (defaults to: {})

Returns:

• (Dnsimple::Response<Dnsimple::Struct::Certificate>)

Raises:

• (Dnsimple::NotFoundError)
• (Dnsimple::RequestError)

See Also:

• https://developer.dnsimple.com/v2/certificates/#issueLetsencryptCertificate

# File 'lib/dnsimple/client/certificates.rb', line 206

def issue_letsencrypt_certificate(account_id, domain_id, certificate_id, options = {})
  response = client.post(Client.versioned("/%s/domains/%s/certificates/letsencrypt/%s/issue" % [account_id, domain_id, certificate_id]), options)

  Dnsimple::Response.new(response, Struct::Certificate.new(response["data"]))
end

#issue_letsencrypt_certificate_renewal(account_id, domain_id, certificate_id, certificate_renewal_id, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::Certificate>

Issue a pending Let’s Encrypt certificate renewal order.

Note that the issuance process is async. A successful response means the issuance request has been successfully acknowledged and queued for processing.

Examples:

Basic usage

response    = client.certificates.issue_letsencrypt_certificate_renewal(1010, "example.com", 100, 999)
certificate = response.data

certificate.state # => "requesting"

Parameters:

• account_id (Integer) —

  the account ID

• domain_id (#to_s) —

  the domain ID or domain name

• certificate_id (Integer) —

  the certificate ID

• certificate_renewal_id (Integer) —

  the certificate renewal ID

• options (Hash) (defaults to: {})

Returns:

• (Dnsimple::Response<Dnsimple::Struct::Certificate>)

Raises:

• (Dnsimple::NotFoundError)
• (Dnsimple::RequestError)

See Also:

• https://developer.dnsimple.com/v2/certificates/#issueRenewalLetsencryptCertificate

# File 'lib/dnsimple/client/certificates.rb', line 281

def issue_letsencrypt_certificate_renewal(account_id, domain_id, certificate_id, certificate_renewal_id, options = {})
  response = client.post(Client.versioned("/%s/domains/%s/certificates/letsencrypt/%s/renewals/%s/issue" % [account_id, domain_id, certificate_id, certificate_renewal_id]), options)

  Dnsimple::Response.new(response, Struct::Certificate.new(response["data"]))
end

#purchase_letsencrypt_certificate(account_id, domain_id, attributes = {}, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::CertificatPurchase>

Purchase a Let’s Encrypt certificate.

This method creates a new certificate order. The certificate ID should be used to request the issuance of the certificate using #issue_letsencrypt_certificate.

Examples:

Basic usage

response    = client.certificates.purchase_letsencrypt_certificate(1010, "example.com")
certificate = response.data

certificate.id              # => 100
certificate.common_name     # => "www.example.com"
certificate.alternate_names # => []
certificate.auto_renew      # => false

Custom name

response    = client.certificates.purchase_letsencrypt_certificate(1010, "example.com", name: "docs")
certificate = response.data

certificate.id              # => 100
certificate.common_name     # => "docs.example.com"
certificate.alternate_names # => []
certificate.auto_renew      # => false

SAN names

response    = client.certificates.purchase_letsencrypt_certificate(1010, "example.com", alternate_names: ["api.example.com", "status.example.com"])
certificate = response.data

certificate.id              # => 100
certificate.common_name     # => "www.example.com"
certificate.alternate_names # => ["api.example.com", "status.example.com"]
certificate.auto_renew      # => false

Auto renew

response    = client.certificates.purchase_letsencrypt_certificate(1010, "example.com", auto_renew: true)
certificate = response.data

certificate.id              # => 100
certificate.common_name     # => "www.example.com"
certificate.alternate_names # => []
certificate.auto_renew      # => true

Signature Algorithm

response    = client.certificates.purchase_letsencrypt_certificate(1010, "example.com", signature_algorithm: "RSA")
certificate = response.data

certificate.id              # => 100
certificate.common_name     # => "www.example.com"
certificate.alternate_names # => []
certificate.auto_renew      # => false

Parameters:

• account_id (Integer) —

  the account ID

• domain_id (#to_s) —

  the domain ID or domain name

• attributes (Hash) (defaults to: {})
• options (Hash) (defaults to: {})

Options Hash (attributes):

• :name (String) —

  the certificate name (optional)

• :alternate_names (Array<String>) —

  the certificate alternate names (optional)

• :auto_renew (TrueClass, FalseClass) —

  enable certificate auto renew (optional)

• :signature_algorithm (String) —

  the signature algorithm used to sign the certificate (optional)

Returns:

• (Dnsimple::Response<Dnsimple::Struct::CertificatPurchase>)

Raises:

• (Dnsimple::NotFoundError)
• (Dnsimple::RequestError)

See Also:

• https://developer.dnsimple.com/v2/certificates/#purchaseLetsencryptCertificate

# File 'lib/dnsimple/client/certificates.rb', line 178

def purchase_letsencrypt_certificate(account_id, domain_id, attributes = {}, options = {})
  response = client.post(Client.versioned("/%s/domains/%s/certificates/letsencrypt" % [account_id, domain_id]), attributes, options)

  Dnsimple::Response.new(response, Struct::CertificatePurchase.new(response["data"]))
end

#purchase_letsencrypt_certificate_renewal(account_id, domain_id, certificate_id, attributes = {}, options = {}) ⇒ Dnsimple::Response<Dnsimple::Struct::CertificateRenewal>

Purchase a Let’s Encrypt certificate renewal.

Examples:

Basic usage

response            = client.certificates.purchase_letsencrypt_certificate_renewal(1010, "example.com", 200)
certificate_renewal = response.data

certificate_renewal.id                 # => 999
certificate_renewal.old_certificate_id # => 200
certificate_renewal.new_certificate_id # => 300

Auto renew

response            = client.certificates.purchase_letsencrypt_certificate_renewal(1010, "example.com", 200, auto_renew: true)
certificate_renewal = response.data

certificate_renewal.id                 # => 999
certificate_renewal.old_certificate_id # => 200
certificate_renewal.new_certificate_id # => 300

Signature Algorithm

response            = client.certificates.purchase_letsencrypt_certificate_renewal(1010, "example.com", 200, signature_algorithm: "RSA")
certificate_renewal = response.data

certificate_renewal.id                 # => 999
certificate_renewal.old_certificate_id # => 200
certificate_renewal.new_certificate_id # => 300

Parameters:

• account_id (Integer) —

  the account ID

• domain_id (#to_s) —

  the domain ID or domain name

• certificate_id (Integer) —

  the certificate ID

• attributes (Hash) (defaults to: {})
• options (Hash) (defaults to: {})

Options Hash (attributes):

• :auto_renew (TrueClass, FalseClass) —

  enable certificate auto renew (optional)

• :signature_algorithm (String) —

  the signature algorithm used to sign the certificate (optional)

Returns:

• (Dnsimple::Response<Dnsimple::Struct::CertificateRenewal>)

Raises:

• (Dnsimple::NotFoundError)
• (Dnsimple::RequestError)

See Also:

• https://developer.dnsimple.com/v2/certificates/#purchaseRenewalLetsencryptCertificate

# File 'lib/dnsimple/client/certificates.rb', line 252

def purchase_letsencrypt_certificate_renewal(account_id, domain_id, certificate_id, attributes = {}, options = {})
  response = client.post(Client.versioned("/%s/domains/%s/certificates/letsencrypt/%s/renewals" % [account_id, domain_id, certificate_id]), attributes, options)

  Dnsimple::Response.new(response, Struct::CertificateRenewal.new(response["data"]))
end