SSL Verification Details

client.SSL.Verification.Get(ctx, params) (*[]Verification, error)

GET/zones/{zone_id}/ssl/verification

Get SSL Verification Info for a Zone.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

Access: Mutual TLS Certificates WriteAccess: Mutual TLS Certificates ReadSSL and Certificates WriteSSL and Certificates Read

ParametersExpand Collapse

params VerificationGetParams

ZoneID param.Field[string]

Path param: Identifier.

maxLength32

Retry param.Field[VerificationGetParamsRetry]optional

Query param: Immediately retry SSL Verification.

const VerificationGetParamsRetryTrue VerificationGetParamsRetry = true

ReturnsExpand Collapse

type VerificationGetResponseEnvelopeResult []Verification

CertificateStatus VerificationCertificateStatus

Current status of certificate.

One of the following:

const VerificationCertificateStatusInitializing VerificationCertificateStatus = "initializing"

const VerificationCertificateStatusAuthorizing VerificationCertificateStatus = "authorizing"

const VerificationCertificateStatusActive VerificationCertificateStatus = "active"

const VerificationCertificateStatusExpired VerificationCertificateStatus = "expired"

const VerificationCertificateStatusIssuing VerificationCertificateStatus = "issuing"

const VerificationCertificateStatusTimingOut VerificationCertificateStatus = "timing_out"

const VerificationCertificateStatusPendingDeployment VerificationCertificateStatus = "pending_deployment"

BrandCheck booloptional

Certificate Authority is manually reviewing the order.

CERTPackUUID stringoptional

Certificate Pack UUID.

Signature VerificationSignatureoptional

Certificate's signature algorithm.

One of the following:

const VerificationSignatureEcdsaWithSha256 VerificationSignature = "ECDSAWithSHA256"

const VerificationSignatureSha1WithRSA VerificationSignature = "SHA1WithRSA"

const VerificationSignatureSha256WithRSA VerificationSignature = "SHA256WithRSA"

ValidationMethod ValidationMethodoptional

Validation method in use for a certificate pack order.

One of the following:

const ValidationMethodHTTP ValidationMethod = "http"

const ValidationMethodCNAME ValidationMethod = "cname"

const ValidationMethodTXT ValidationMethod = "txt"

VerificationInfo VerificationVerificationInfooptional

Certificate's required verification information.

RecordName VerificationVerificationInfoRecordNameoptional

Name of CNAME record.

formathostname

One of the following:

const VerificationVerificationInfoRecordNameRecordName VerificationVerificationInfoRecordName = "record_name"

const VerificationVerificationInfoRecordNameHTTPURL VerificationVerificationInfoRecordName = "http_url"

const VerificationVerificationInfoRecordNameCNAME VerificationVerificationInfoRecordName = "cname"

const VerificationVerificationInfoRecordNameTXTName VerificationVerificationInfoRecordName = "txt_name"

RecordTarget VerificationVerificationInfoRecordTargetoptional

Target of CNAME record.

formathostname

One of the following:

const VerificationVerificationInfoRecordTargetRecordValue VerificationVerificationInfoRecordTarget = "record_value"

const VerificationVerificationInfoRecordTargetHTTPBody VerificationVerificationInfoRecordTarget = "http_body"

const VerificationVerificationInfoRecordTargetCNAMETarget VerificationVerificationInfoRecordTarget = "cname_target"

const VerificationVerificationInfoRecordTargetTXTValue VerificationVerificationInfoRecordTarget = "txt_value"

VerificationStatus booloptional

Status of the required verification information, omitted if verification status is unknown.

VerificationType VerificationVerificationTypeoptional

Method of verification.

One of the following:

const VerificationVerificationTypeCNAME VerificationVerificationType = "cname"

const VerificationVerificationTypeMetaTag VerificationVerificationType = "meta tag"

SSL Verification Details

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/ssl"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  verifications, err := client.SSL.Verification.Get(context.TODO(), ssl.VerificationGetParams{
    ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", verifications)
}

{
  "result": [
    {
      "certificate_status": "active",
      "brand_check": false,
      "cert_pack_uuid": "a77f8bd7-3b47-46b4-a6f1-75cf98109948",
      "signature": "ECDSAWithSHA256",
      "validation_method": "txt",
      "verification_info": {
        "record_name": "record_name",
        "record_target": "record_value"
      },
      "verification_status": true,
      "verification_type": "cname"
    }
  ]
}

Returns Examples

{
  "result": [
    {
      "certificate_status": "active",
      "brand_check": false,
      "cert_pack_uuid": "a77f8bd7-3b47-46b4-a6f1-75cf98109948",
      "signature": "ECDSAWithSHA256",
      "validation_method": "txt",
      "verification_info": {
        "record_name": "record_name",
        "record_target": "record_value"
      },
      "verification_status": true,
      "verification_type": "cname"
    }
  ]
}