type APIError struct {Success   anyBool `json:"success"`ErrorInfo struct {Codeint    `json:"code"`Typestring `json:"type"`// for domain verification only; each domain is grouped into its// www and non-www variant for CNAME validation, or its URL// for HTTP validationDetails map[string]map[string]ValidationError `json:"details"`} `json:"error"`}

func (APIError)Error¶

func (aeAPIError) Error()string

type CNAMEValidationError struct {CNAMEFoundint    `json:"cname_found"`RecordCorrectint    `json:"record_correct"`TargetHoststring `json:"target_host"`TargetRecordstring `json:"target_record"`ActualRecordstring `json:"actual_record"`}

type CertificateBundle struct {CertificateCrtstring `json:"certificate.crt"`CABundleCrtstring `json:"ca_bundle.crt"`}

type CertificateList struct {TotalCountint                 `json:"total_count"`ResultCountint                 `json:"result_count"`Pagestring              `json:"page"`// don't ask me why this is a stringLimitint                 `json:"limit"`ACMEUsageLevelstring              `json:"acmeUsageLevel"`ACMELockedbool                `json:"acmeLocked"`Results        []CertificateObject `json:"results"`}

type CertificateObject struct {IDstring  `json:"id"`// "certificate hash"Typestring  `json:"type"`CommonNamestring  `json:"common_name"`AdditionalDomainsstring  `json:"additional_domains"`Createdstring  `json:"created"`Expiresstring  `json:"expires"`Statusstring  `json:"status"`ValidationType    *string `json:"validation_type,omitempty"`ValidationEmails  *string `json:"validation_emails,omitempty"`ReplacementForstring  `json:"replacement_for,omitempty"`FingerprintSHA1   *string `json:"fingerprint_sha1"`BrandValidationany     `json:"brand_validation"`Validation        *struct {EmailValidation map[string][]string         `json:"email_validation,omitempty"`OtherMethods    map[string]ValidationObject `json:"other_methods,omitempty"`} `json:"validation,omitempty"`}

type Client struct {// REQUIRED: Your ZeroSSL account access key.AccessKeystring `json:"access_key"`// Optionally adjust the base URL of the API.// Default:https://api.zerossl.comBaseURLstring `json:"base_url,omitempty"`// Optionally configure a custom HTTP client.HTTPClient *http.Client `json:"-"`}

func (Client)CancelCertificate¶

func (cClient) CancelCertificate(ctxcontext.Context, certificateIDstring)error

CancelCertificate cancels a certificate that has not been issued yet (is in draft or pending_validation state).

func (Client)CreateCertificate¶

func (cClient) CreateCertificate(ctxcontext.Context, csr *x509.CertificateRequest, validityDaysint) (CertificateObject,error)

CreateCertificate creates a certificate. After creating a certificate, its identifiers must be verified beforethe certificate can be downloaded. The CSR must have been fully created using x509.CreateCertificateRequest(its Raw field must be filled out).

func (Client)DownloadCertificate¶

func (cClient) DownloadCertificate(ctxcontext.Context, certificateIDstring, includeCrossSignedbool) (CertificateBundle,error)

func (Client)DownloadCertificateFile¶

func (cClient) DownloadCertificateFile(ctxcontext.Context, certificateIDstring, includeCrossSignedbool, outputio.Writer)error

DownloadCertificateFile writes the certificate bundle as a zip file to the provided output writer.

func (Client)GenerateEABCredentials¶

func (cClient) GenerateEABCredentials(ctxcontext.Context) (keyID, hmacKeystring, errerror)

func (Client)GetCertificate¶

func (cClient) GetCertificate(ctxcontext.Context, certificateIDstring) (CertificateObject,error)

func (Client)ListCertificates¶

func (cClient) ListCertificates(ctxcontext.Context, paramsListCertificatesParameters) (CertificateList,error)

func (Client)ResendVerificationEmail¶

func (cClient) ResendVerificationEmail(ctxcontext.Context, certificateIDstring)error

func (Client)RevokeCertificate¶

func (cClient) RevokeCertificate(ctxcontext.Context, certificateIDstring, reasonRevocationReason)error

Only revoke a certificate if the private key is compromised, the certificate was a mistake, orthe identifiers are no longer in use. Do not revoke a certificate when renewing it.

func (Client)ValidateCSR¶

func (cClient) ValidateCSR(ctxcontext.Context, csrASN1DER []byte)error

ValidateCSR sends the CSR to ZeroSSL for validation. Pass in the ASN.1 DER-encoded bytes;this is found in x509.CertificateRequest.Raw after calling x5p9.CreateCertificateRequest.

func (Client)VerificationStatus¶

func (cClient) VerificationStatus(ctxcontext.Context, certificateIDstring) (ValidationStatus,error)

func (Client)VerifyIdentifiers¶

func (cClient) VerifyIdentifiers(ctxcontext.Context, certificateIDstring, methodVerificationMethod, emails []string) (CertificateObject,error)

VerifyIdentifiers tells ZeroSSL that you are ready to prove control over your domain/IP using the method specified.The credentials from CreateCertificate must be used to verify identifiers. At least one email is required if usingemail verification method.

type HTTPValidationError struct {FileFoundint    `json:"file_found"`Errorbool   `json:"error"`ErrorSlugstring `json:"error_slug"`ErrorInfostring `json:"error_info"`}

type ListCertificatesParameters struct {// Return certificates with this status.Statusstring// Return these types of certificates.Typestring// The CommonName or SAN.Searchstring// The page number. Default: 1Pageint// How many per page. Default: 100Limitint}

funcListAllCertificates¶

func ListAllCertificates()ListCertificatesParameters

ListAllCertificates returns parameters that lists all the certificates on the account;be sure to set Page and Limit if paginating.

type RevocationReasonstring

type ValidationError struct {CNAMEValidationErrorHTTPValidationError}

type ValidationObject struct {FileValidationURLHTTPstring   `json:"file_validation_url_http"`FileValidationURLHTTPSstring   `json:"file_validation_url_https"`FileValidationContent  []string `json:"file_validation_content"`CnameValidationP1string   `json:"cname_validation_p1"`CnameValidationP2string   `json:"cname_validation_p2"`}

type ValidationStatus struct {ValidationCompletedint `json:"validation_completed"`Details             map[string]struct {Methodstring `json:"method"`Statusstring `json:"status"`} `json:"details"`}

type VerificationMethodstring

const (EmailVerificationVerificationMethod = "EMAIL"CNAMEVerificationVerificationMethod = "CNAME_CSR_HASH"HTTPVerificationVerificationMethod = "HTTP_CSR_HASH"HTTPSVerificationVerificationMethod = "HTTPS_CSR_HASH")

Verification methods.