This table aggregates membership for all versions of the DvChallenges object.

Versioned schema members

Any object member specific to a range of versions is indicated in its description, at what version the member was either introduced or removed. Any listed data member with no version number is common to all versions of the object.

MemberTypeDescription
Dv‚ÄčChallenges: Let‚Äôs Encrypt domain validation challenge information for each of the domains on the certificate signing request (CSR).
challengesDv‚ÄčChallenges.‚Äčchallenges[]pre-v2. Domains that need to be validated for this Enrollment. V1 only supports and displays http-01 challenge.
dvDv‚ÄčChallenges.‚Äčdv[]v2. Domain Validation entity.
Dv‚ÄčChallenges.challenges[]: Domains that need to be validated for this Enrollment. V1 only supports and displays http-01 challenge.
domainString, Nullpre-v2. Domain that is being validated.
errorString, Nullpre-v2. Current validation status for domains not yet validated.
expiresString, Nullpre-v2. Timestamp when this token or validation will expire. Sample 2014-08-12T18:57:07z.
full‚ÄčPathString, Nullpre-v2. The URL where Let's Encrypt will request and expect to find 'token' as content.
redirect‚ÄčFull‚ÄčPathString, Nullpre-v2. The URL where Akamai publishes response‚ÄčBody for Let's Encrypt to validate. The client can configure a redirect at full‚ÄčPath to redirect requests to this redirect‚ÄčFull‚ÄčPath URL, keeping in mind that the token may change over time.
request‚ÄčTimestampString, Nullpre-v2. The timestamp of the validation token Akamai receives from Let's Encrypt. Sample 2014-08-12T18:57:07z.
response‚ÄčBodyString, Nullpre-v2. The data Let's Encrypt expects to find served at full‚ÄčPath URL.
statusString, Nullpre-v2. The domain validation status.
tokenString, Nullpre-v2. The validation token issued by Let's Encrypt.
validated‚ÄčTimestampString, Nullpre-v2. Timestamp when domain was successfully validated. Sample 2014-08-12T18:57:07z.
Dv‚ÄčChallenges.dv[]: Domain Validation entity.
challengesDv‚ÄčChallenges.‚Äčdv[].‚Äčchallenges[]v2. Domains that need to be validated for this Enrollment. V1 only supports and displays http-01 challenge. V2 allows HTTP and DNS challenge types. Each domain in the enrollment can have multiple challenges and can use a different challenge types. To validate a domain, only one challenge for each domain must be complete.
domainString, Nullv2. Domain that is being validated.
errorString, Nullv2. Current validation status for domains not yet validated.
expiresString, Nullv2. Timestamp when this token or validation will expire. Sample 2017-12-05T18:57:07z.
request‚ÄčTimestampString, Nullv2. Timestamp Akamai received validation token from Let's Encrypt. Sample 2017-12-12T18:57:07z.
statusString, Nullv2. Let's Encrypt validation status. Required Valid for certificate generation.
validated‚ÄčTimestampString, Nullv2. Timestamp when domain was successfully validated. Sample 2017-12-12T18:57:07z.
validation‚ÄčStatusString, Nullv2. Status of the domain validation process.
Dv‚ÄčChallenges.dv[].challenges[]: Domains that need to be validated for this Enrollment. V1 only supports and displays http-01 challenge. V2 allows HTTP and DNS challenge types. Each domain in the enrollment can have multiple challenges and can use a different challenge types. To validate a domain, only one challenge for each domain must be complete.
errorString, Nullv2. Error message describing failure to validate domain control.
full‚ÄčPathString, Nullv2. The URL where Let's Encrypt will request and expect to find 'token' as content.
redirect‚ÄčFull‚ÄčPathString, Nullv2. The URL where Akamai publishes response‚ÄčBody for Let's Encrypt to validate. The client can configure a redirect at full‚ÄčPath to redirect requests to this redirect‚ÄčFull‚ÄčPath URL, keeping in mind that the token may change over time.
response‚ÄčBodyString, Nullv2. The data Let's Encrypt expects to find served at full‚ÄčPath URL.
statusEnumeration, Nullv2. The domain validation status. Current values include Preparing, Pending, Awaiting user, Valid, Invalid, Error & Ready for Validation.
tokenString, Nullv2. The validation token issued by Let's Encrypt.
typeEnumeration, Nullv2. Validation type. Currently supported types include dns-01 & http-01.
validation‚ÄčRecordsDv‚ÄčChallenges.‚Äčdv[].‚Äčchallenges[].‚Äčvalidation‚ÄčRecords[]v2. Validation attempt.
Dv‚ÄčChallenges.dv[].challenges[].validation‚ÄčRecords[]: Validation attempt.
authoritiesArray, Nullv2. Validation authorities.
hostnameString, Nullv2. Domain name being validated.
portString, Nullv2. Port used for validation.
resolved‚ÄčIpArray, Nullv2. IPs resolved for name being validated.
tried‚ÄčIpString, Nullv2. IP from resolved‚ÄčIp tried for this validation.
urlString, Nullv2. URL attempted validated.
used‚ÄčIpString, Nullv2. IP from resolved‚ÄčIp used for this validation.

Sample v1 object

TBD

{
    "challenges": [
        {
            "domain": "www.cps-example-dv.com",
            "error": "The domain is not ready for validation.",
            "expires": "2017-05-19T18:00:00Z",
            "fullPath": "http://www.cps-example-dv.com/.well-known/acme-challenge/abcdefghijklmno-KuzBi3q5Dr6TU8ViHSDSf-c9Iyg",
            "redirectFullPath": "http://dcv.akamai.com/.well-known/acme-challenge/abcdefghijklmno-KuzBi3q5Dr6TU8ViHSDSf-c9Iyg",
            "requestTimestamp": "2017-05-19T17:20:00Z",
            "responseBody": "12345-...-abcdef",
            "status": "Awaiting user",
            "token": "abcdefghijklmno-123453q5Dr6TU8ViHSDSf-c9Iyg",
            "validatedTimestamp": "2017-05-19T17:35:22Z"
        }
    ]
}

Sample v2 object

TBD

{
    "dv": [
        {
            "challenges": [
                {
                    "error": null,
                    "fullPath": "http://www.cps-example-dv.com/.well-known/acme-challenge/abcdefghijklmno-123453q5Dr6TU8ViHSDSf-c9Iyg",
                    "redirectFullPath": "http://dcv.akamai.com/.well-known/acme-challenge/abcdefghijklmno-123453q5Dr6TU8ViHSDSf-c9Iyg",
                    "responseBody": "AAA-dvq11111CmSWBzwIFpc4G2OCh5YXoHK56VccGmU.-BBBBBD3eQiu1uf5vf4xp-ZJv71AiycGGMuLtf06BnA",
                    "status": "pending",
                    "token": "abcdefghijklmno-123453q5Dr6TU8ViHSDSf-c9Iyg",
                    "type": "http-01",
                    "validationRecords": []
                },
                {
                    "error": null,
                    "fullPath": "_acme-challenge.www.cps-example-dv.com.",
                    "redirectFullPath": "",
                    "responseBody": "0yVISDJjpXR7BXzR5QgfA51tt-I6aKremGnPwK_lvH4",
                    "status": "pending",
                    "token": "cGBnw-3YO7rUhq61EuuHqcGrYkaQWALAgi8szTqRoHA",
                    "type": "dns-01",
                    "validationRecords": []
                }
            ],
            "domain": "www.cps-example-dv.com",
            "error": "The domain is not ready for validation.",
            "expires": "2018-09-06T17:55:17Z",
            "requestTimestamp": "2018-09-05T15:55:49Z",
            "status": "Awaiting user",
            "validatedTimestamp": "2018-09-05T17:53:22Z",
            "validationStatus": "RESPONSE_ERROR"
        }
    ]
}