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.
Member | Type | Description | |
---|---|---|---|
DvChallenges : Let’s Encrypt domain validation challenge information for each of the domains on the certificate signing request (CSR). | |||
challenges | DvChallenges.challenges[] | pre-v2. Domains that need to be validated for this Enrollment. V1 only supports and displays http-01 challenge. | |
dv | DvChallenges.dv[] | v2. Domain Validation entity. | |
DvChallenges.challenges[] : Domains that need to be validated for this Enrollment. V1 only supports and displays http-01 challenge. | |||
domain | String, Null | pre-v2. Domain that is being validated. | |
error | String, Null | pre-v2. Current validation status for domains not yet validated. | |
expires | String, Null | pre-v2. Timestamp when this token or validation will expire. Sample 2014-08-12T18:57:07z. | |
fullPath | String, Null | pre-v2. The URL where Let's Encrypt will request and expect to find 'token' as content. | |
redirectFullPath | String, Null | pre-v2. The URL where Akamai publishes responseBody for Let's Encrypt to validate. The client can configure a redirect at fullPath to redirect requests to this redirectFullPath URL, keeping in mind that the token may change over time. | |
requestTimestamp | String, Null | pre-v2. The timestamp of the validation token Akamai receives from Let's Encrypt. Sample 2014-08-12T18:57:07z . | |
responseBody | String, Null | pre-v2. The data Let's Encrypt expects to find served at fullPath URL. | |
status | String, Null | pre-v2. The domain validation status. | |
token | String, Null | pre-v2. The validation token issued by Let's Encrypt. | |
validatedTimestamp | String, Null | pre-v2. Timestamp when domain was successfully validated. Sample 2014-08-12T18:57:07z. | |
DvChallenges.dv[] : Domain Validation entity. | |||
challenges | DvChallenges.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. | |
domain | String, Null | v2. Domain that is being validated. | |
error | String, Null | v2. Current validation status for domains not yet validated. | |
expires | String, Null | v2. Timestamp when this token or validation will expire. Sample 2017-12-05T18:57:07z. | |
requestTimestamp | String, Null | v2. Timestamp Akamai received validation token from Let's Encrypt. Sample 2017-12-12T18:57:07z . | |
status | String, Null | v2. Let's Encrypt validation status. Required Valid for certificate generation. | |
validatedTimestamp | String, Null | v2. Timestamp when domain was successfully validated. Sample 2017-12-12T18:57:07z. | |
validationStatus | String, Null | v2. Status of the domain validation process. | |
DvChallenges.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. | |||
error | String, Null | v2. Error message describing failure to validate domain control. | |
fullPath | String, Null | v2. The URL where Let's Encrypt will request and expect to find 'token' as content. | |
redirectFullPath | String, Null | v2. The URL where Akamai publishes responseBody for Let's Encrypt to validate. The client can configure a redirect at fullPath to redirect requests to this redirectFullPath URL, keeping in mind that the token may change over time. | |
responseBody | String, Null | v2. The data Let's Encrypt expects to find served at fullPath URL. | |
status | Enumeration, Null | v2. The domain validation status. Current values include Preparing , Pending , Awaiting user , Valid , Invalid , Error & Ready for Validation . | |
token | String, Null | v2. The validation token issued by Let's Encrypt. | |
type | Enumeration, Null | v2. Validation type. Currently supported types include dns-01 & http-01 . | |
validationRecords | DvChallenges.dv[].challenges[].validationRecords[] | v2. Validation attempt. | |
DvChallenges.dv[].challenges[].validationRecords[] : Validation attempt. | |||
authorities | Array, Null | v2. Validation authorities. | |
hostname | String, Null | v2. Domain name being validated. | |
port | String, Null | v2. Port used for validation. | |
resolvedIp | Array, Null | v2. IPs resolved for name being validated. | |
triedIp | String, Null | v2. IP from resolvedIp tried for this validation. | |
url | String, Null | v2. URL attempted validated. | |
usedIp | String, Null | v2. IP from resolvedIp used for this validation. |
Sample v1 object
{
"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
{
"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"
}
]
}